markdown|gitbook创建PDF电子书

1. 问题描述

markdown写作效率很高,但不适合大篇幅的手册、书籍、文档编辑。要实现书籍级别的写作,必须实现有效的子文档分解和集成,类似LaTeX。gitbook软件平台实现了这一功能。

2. 技术背景

gitbook对大规模文档进行子文件分解,通过summary文件组织章节构架,形成总体文章。

markdown|gitbook创建PDF电子书_第1张图片
mark

3. 解决方案

略。

4. 实施示例

4.1 准备工作

  • 下载编辑器
    https://www.gitbook.com/editor
    markdown|gitbook创建PDF电子书_第2张图片
    mark
  • 安装、注册账户

4.2 网上创建项目

  • 创建book


    markdown|gitbook创建PDF电子书_第3张图片
    mark
  • 设置项目名


    markdown|gitbook创建PDF电子书_第4张图片
    mark
  • 【feature】打开E-book选项
    这样才能输出pdf


    markdown|gitbook创建PDF电子书_第5张图片
    mark
  • 【edit】-拷贝项目网址


    markdown|gitbook创建PDF电子书_第6张图片
    mark

4.3 PC客户端写作

  • 本地clone项目test2


    markdown|gitbook创建PDF电子书_第7张图片
    mark
  • 点击【AA】和眼睛图标,将截界面设置如下


    markdown|gitbook创建PDF电子书_第8张图片
    mark
  • 修改introduction


    markdown|gitbook创建PDF电子书_第9张图片
    mark
  • 撰写正文


    markdown|gitbook创建PDF电子书_第10张图片
    mark
  • 依次编辑其他站章节子文件
    红框的内容为二级标题
    markdown|gitbook创建PDF电子书_第11张图片
    mark
  • 打开summary文件


    markdown|gitbook创建PDF电子书_第12张图片
    mark
  • 调整文档章节级别


    markdown|gitbook创建PDF电子书_第13张图片
    mark
  • 内容同步上传


    markdown|gitbook创建PDF电子书_第14张图片
    mark

4.4 网页端发布PDF版

到了这一步,应该可以直接输出pdf的,但需要进入网站略作编辑,重新publish,才能下载发布的PDF或其他格式的电子书文件。

  • 【Edit】


    markdown|gitbook创建PDF电子书_第15张图片
    mark
  • publish
    markdown|gitbook创建PDF电子书_第16张图片
    mark
  • 下载PDF


    mark

4.5 PDF输出效果

  • 目录与标签


    markdown|gitbook创建PDF电子书_第17张图片
    mark
  • 正文


    markdown|gitbook创建PDF电子书_第18张图片
    mark

可以看出,输出电子书的效果较为理想:

  • 排版规范
  • 包含书签、目录
  • 页眉(章节标题)
  • 页脚(页码)

5. 常见问题

gitbook发布PDF的电子书,需要登陆网站。站点国外网速很差,非常慢,耽误很多时间。

本文用时 30 m

你可能感兴趣的:(markdown|gitbook创建PDF电子书)