gitbook 使用小结

498 阅读1分钟

1、ubuntu上安装 node.js

Node.js Binary Distributions

curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
sudo apt-get install -y nodejs

2、安装gitbook

npm install gitbook-cli -g
gitbook -V

3、使用gitbook

参见 :gitbook简明教程

  1. 创建目录
book/
├── README.md
└── SUMMARY.md

* [Chapter1](chapter1/README.md)
  * [Section1.1](chapter1/section1.1.md)
  * [Section1.2](chapter1/section1.2.md)
* [Chapter2](chapter2/README.md)

创建了这两个文件后,使用 gitbook init,它会为我们创建 SUMMARY.md 中的目录结构。 书籍目录结构创建完成以后,就可以使用 gitbook serve 来编译和预览书籍了。 gitbook serve 命令实际上会首先调用 gitbook build 编译书籍,完成以后会打开一个 web 服务器,监听在本地的 4000 端口。 在文件修改过程中,每一次保存文件,gitbook serve 都会自动重新编译,所以可以持续通过浏览器来查看最新的书籍效果! gitbook 在编译书籍的时候会读取书籍源码顶层目录中的 book.js 或者 book.json,放在根目录,然后使用 gitbook install

gitbook init
gitbook build [书籍路径] [输出路径]
gitbook serve --port 2333
gitbook pdf ./ ./mybook.pdf
gitbook epub ./ ./mybook.epub
gitbook mobi ./ ./mybook.mobi

npm镜像更换:npm config set registry http://registry.npm.taobao.org

关于输出PDF等设置,可见:GitBook使用教程