gitbook
电脑中先安装 npm
通过npm安装Gitbook。
npm install gitbook -g
npm install gitbook-cli -g
生成
gitbook 需要两个文件
- README.md
- SUMMARY.md
README.md是关于你的书的介绍,而SUMMARY.md中则包含了书目,即章节结构,它的格式大致是:
* [第1章](c1.md)
* [第1节](c1s1.md)
* [第2节](c1s2.md)
* [第2章](c2.md)
下面这个指令会生成文档, 同时 gitbook 会作为 HTTP Server运行,并在8080端口监听HTTP请求。
gitbook serve -p 8080
在 http://localhost:8080 预览输出的文档
生存的文件都保存在当前目录下的一个名为_book的子目录
生成 pdf: gitbook pdf
扩展
自动生成 SUMMARY.md
安装 gitbook-summary
npm install -g gitbook-summary
然后使用下面的指令会根据命令执行目录下 文件/文件夹 的结构自动生成 SUMMARY.md
book sm