软件_gitbook简洁教程

软件安装和验证

npm install -g gitbook-cli
gitbook -V

初始化和修改后再初始化

gitbook init cookbook

编辑SUMMARY.md

1
2
3
4
5
6
7
8
9
10
11

# 目录

* [前言](README.md)
* [第一章](Chapter1/README.md)
  * [第1节：衣](Chapter1/衣.md)
  * [第2节：食](Chapter1/食.md)
  * [第3节：住](Chapter1/住.md)
  * [第4节：行](Chapter1/行.md)
* [第二章](Chapter2/README.md)
* [第三章](Chapter3/README.md)
* [第四章](Chapter4/README.md)

再次执行cd cookbook && gitbook init，生成新目录结构

预览

gitbook serve .
打开浏览器输入http://localhost:4000就可以看到文档说明了

构建

构建书籍：gitbook build
默认：将生成的静态网站输出到 _book 目录

1
2
3
4
5

指定路径：gitbook build [书籍路径] [输出路径]
指定端口：gitbook serve --port 2333
生成pdf格式：gitbook pdf ./ ./mybook.pdf
生成epub格式：gitbook epub ./ ./mybook.epub
生成 mobi 格式：gitbook mobi ./ ./mybook.mobi

注意：如果生成不了，你可能还需要安装一些工具，比如 calibre、ebook-convert，或者在 Typora 中安装 Pandoc 进行导出。

关联github

文件整体(不包括build生成的_books，gitbook会自动重编译)push到github的项目git上
gitbook登录账号导入即可。详细参考文献《Gitbook 超详细入门教程！电子书从入门到发布》

参考

gitbook入门：https://www.jianshu.com/p/f036891dc530
gitbook入门：https://www.jianshu.com/p/dc53e589897a
Github和GitBook使用：https://www.jianshu.com/p/925745669c6c
Gitbook 超详细入门教程！电子书从入门到发布:https://blog.csdn.net/qq_43363200/article/details/105506329