gitbook使用

安装

node.js:版本12.16.3 通过nvm安装
官方说明：https://github.com/GitbookIO/gitbook/blob/master/docs/setup.md

# 卸载指令
npm uninstall -g gitbook
# 安装指令
npm install -g gitbook-cli
# 检验是否安装成功 必须的
gitbook --version

使用

# 进入要写书的目录，会自动生成README.md与SUMMARY.md
gitbook init
# 编译书籍，之后可以在 http://localhost:4000 中预览图书 
gitbook serve 
# 生成离线HTML页面到_book文件夹中
gitbook build

修改SUMMARY.md，用于自动生成章节

# 概要
* [卷 I](part1/README.md)
    * [写作很棒](part1/writing.md)
    * [GitBook很酷](part1/gitbook.md)
* [卷 II](part2/README.md)
    * [期待反馈](part2/feedback_please.md)
    * [更好的写作工具](part2/better_tools.md)

修改完成后，执行 gitbook init 会自动生成相应的文件与文件夹

生成PDF

需要安装 ebook-convert 插件
calibre 官网: https://calibre-ebook.com/

# 生成pdf
gitbook pdf

展示在github上

1. 本地使用gitbook，将编译后的文件保存到docs文件夹下

gitbook build . docs

2. 将本地的文件push到远端的github仓库
3. 远端的github仓库进行设置，将settings---Pages中信息设置如下：
   

参考：
1、简书： https://www.jianshu.com/p/8a513823a988
使用的是 docs文件夹作为的展示目录
2、gitbook在gitpages上展示的参考：https://www.cnblogs.com/phyger/p/14035937.html#Github_Pages_629
特别详细的解说，git actions使用。 我未使用此方法，不如第一种方法简便