1. 问题描述
markdown写作效率很高，但不适合大篇幅的手册、书籍、文档编辑。要实现书籍级别的写作，必须实现有效的子文档分解和集成，类似LaTeX。gitbook软件平台实现了这一功能。
2. 技术背景
gitbook对大规模文档进行子文件分解，通过summary文件组织章节构架，形成总体文章。
mark
3. 解决方案
略。
4. 实施示例
4.1 准备工作
- 下载编辑器
https://www.gitbook.com/editor
mark - 安装、注册账户
4.2 网上创建项目
-
创建book
mark -
设置项目名
mark -
【feature】打开E-book选项
这样才能输出pdf
mark -
【edit】-拷贝项目网址
mark
4.3 PC客户端写作
-
本地clone项目test2
mark -
点击【AA】和眼睛图标，将截界面设置如下
mark -
修改introduction
mark -
撰写正文
mark - 依次编辑其他站章节子文件
红框的内容为二级标题
mark -
打开summary文件
mark -
调整文档章节级别
mark -
内容同步上传
mark
4.4 网页端发布PDF版
到了这一步，应该可以直接输出pdf的，但需要进入网站略作编辑，重新publish，才能下载发布的PDF或其他格式的电子书文件。
-
【Edit】
mark -
publish
mark -
下载PDF
mark
4.5 PDF输出效果
-
目录与标签
mark -
正文
mark
可以看出，输出电子书的效果较为理想：
- 排版规范
- 包含书签、目录
- 页眉（章节标题）
- 页脚（页码）
5. 常见问题
gitbook发布PDF的电子书，需要登陆网站。站点国外网速很差，非常慢，耽误很多时间。
本文用时 30 m
