GitBook 是一个基于 Node.js 的静态网站生成器，能够帮助开发者快速创建并发布文档。而 GitBook-CLI 则是 GitBook 的命令行工具，可以更加方便地管理 GitBook 文档。
本文将详细介绍如何使用 npm 包 gitbook-cli 来创建和管理自己的 GitBook 文档。
安装 gitbook-cli
首先，我们需要在本地安装 gitbook-cli。打开终端并运行以下命令：
npm install -g gitbook-cli
这将全局安装 gitbook-cli。如果你已经安装了较老版本的 gitbook-cli，请使用以下命令升级到最新版本：
npm update -g gitbook-cli
创建 GitBook 文档
现在，我们已经准备好使用 gitbook-cli 创建 GitBook 文档了。创建一个名为“mybook”的新 GitBook 文档的命令如下所示：
gitbook init mybook
此命令将创建一个名为“mybook”的文件夹，并在其中添加 GitBook 所需的文件和目录结构。接下来，进入 mybook 文件夹:
cd mybook
编写 GitBook 文档
现在，在 mybook 文件夹中，您可以开始编写自己的 GitBook 文档了。GitBook 文档使用 Markdown 语法来编辑和格式化内容。
例如，您可以在 mybook 文件夹中创建一个名为“README.md”的文件，并使用以下内容来编写您的第一章：
# 第一章 这是第一章的正文。
预览 GitBook 文档
您可以使用以下命令在本地预览您的 GitBook 文档：
gitbook serve
此命令将启动一个本地服务器，在浏览器中打开 http://localhost:4000 进行预览。每次编辑后，刷新页面即可看到更改。
发布 GitBook 文档
当您准备好发布您的 GitBook 文档时，只需要运行以下命令：
gitbook build
此命令将生成一个静态 HTML 网站，存储在 _book 目录下。您可以将该目录中的文件上传到您的 Web 服务器或任何其他适合的位置。
结论
通过使用 gitbook-cli 工具，我们可以轻松创建、编辑和管理自己的 GitBook 文档。希望本文对您有所帮助！如果您需要进一步了解 gitbook-cli，请参阅官方文档。
示例代码
README.md:
# 第一章 这是第一章的正文。
预览 GitBook 文档：
gitbook serve
发布 GitBook 文档：
gitbook build
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/52343