设置和安装GitBook

GitBook.com

GitBook.com 是一种易于使用的解决方案，用于编写，发布和托管图书。这是发布您的内容并进行协作的最简单解决方案。

它与GitBook Editor很好地结合在一起.

本地安装

要求

• NodeJS（建议使用v4.0.0及以上版本）
• Windows, Linux, Unix, or Mac OS X

安装

npm install gitbook-cli -g

gitbook-cli 是一个在同一个系统上安装和使用多个GitBook版本的工具。它会自动安装所需版本的GitBook来构建一本书。

创建一本书

GitBook可以设置一本样板书：

gitbook init

如果您希望将图书创建到新目录中，可以通过运行 gitbook init ./directory 来完成。

使用以下方式预览并提供图书：

gitbook serve

或使用以下命令建立静态网站：

gitbook build

安装预发行版

gitbook-cli 可以轻松下载并安装其他版本的GitBook以测试您的书籍：

gitbook fetch beta

使用 gitbook ls-remote 列出可供安装的远程版本。

调试

您可以使用选项 --log = debug 和 --debug 来获取更好的错误消息（使用堆栈跟踪）。例如：

$ gitbook build ./ --log=debug --debug