注意:需要安装 gitbook-cli,而不是gitbook
创建一个目录,例如 mkdir ~/test_gitbook
cd ~/test_gitbook
gitbook init
初始化成功,并生成 README.md 和 SUMMARY.md,README.md是说明文件,SUMMARY.md是目录
修改SUMMER.md文件,生成book目录
* [Introduction](README.md)
* [Part I](part1/README.md)
* [Writing is nice](part1/writing.md)
* [GitBook is nice](part1/gitbook.md)
* [Part II](part2/README.md)
* [We love feedback](part2/feedback_please.md)
* [Better tools for authors](part2/better_tools.md)
创建对应的md文件
执行:gitbook serve
执行后可以访问 http://localhost:4000 查看电子书
执行:gitbook build
执行后可以生成 _book文件夹,该文件夹保存了 md文件生成的html文件
在 Gitbook 的根目录下创建 book.json 文件,写入相关插件的配置。
在github 中创建一个工程,用于保存 gitbook代码
git clone https://github.com/yyxtlty/book.github.io.git
在此文件夹中,初始化一个gitbook,执行 gitbook init 和 gitbook build
需要将生成的 _book 传到github 的 gh-pages 分支
git subtree push --prefix=_book origin gh-pages
上传成功后,就可以在 https://yyxtlty.github.io/book.github.io/ 中访问了。
git subtree
用于实现一个仓库作为其他仓库的子仓库。
常用命令如下:
git subtree add --prefix=<prefix> <commit>
git subtree add --prefix=<prefix> <repository> <ref>
git subtree pull --prefix=<prefix> <repository> <ref>
git subtree push --prefix=<prefix> <repository> <ref>
git subtree merge --prefix=<prefix> <commit>
git subtree split --prefix=<prefix> [OPTIONS] [<commit>]