超实用gitbook教程

  gitbook 是一个基于 Node.js 的命令行工具，支持 Markdown 和 AsciiDoc 两种语法格式，可以输出 HTML、PDF、eBook 等格式的电子书。   gitbook 与 Markdown 和 Git 息息相关，只有将它们结合起来使用，才能将它们的威力发挥到极致！通常我们会选择合适的 Markdown 编辑工具以获得飞一般的写作体验；使用 GitBook 管理文档，预览、制作电子书；同时通过 Git 管理书籍内容的变更，并将其托管到云端（比如 GitHub、GitLab、码云，或者是自己搭建的 Git 服务器），实现多人协作。   相比于word，因为它以二进制格式保存、软件不兼容、格式不兼容、难以进行版本控制、难以实时分享预览、难以多人协作等短板。而这恰恰是 GitBook + Markdown + Git 的长处。

1、使用npm全局安装gitbook-cli

2、使用gitbook --version来查看gitbook的版本

3、新建一个文件夹，初始化gitbook，会自动生成两个文件。 README.md —— 书籍的介绍写在这个文件里 SUMMARY.md —— 书籍的目录结构在这里配置

4、接着，使用gitbook serve命令来启动gitbook本地服务器，预览书籍内容。

serve 命令也可以指定端口：

5、打开localhost:4000，会出现如下页面

6、生成静态网页 执行 gitbook build 命令构建书籍，默认将生成的静态网站输出到 _book 目录。实际上，这一步也包含在 gitbook serve 里面，因为它们是 HTML，所以 gitbook 通过 Node.js 提供服务了。

可以生成 PDF 格式的电子书：

生成 epub 格式的电子书：

生成 mobi 格式的电子书：

如果生成不了，还需要安装工具ebook-convert，安装好后，还需要执行以下命令

编辑 SUMMARY.md 文件，内容修改为：

book.json，该文件用于存放配置信息。

【title】书本的标题 【author】作者的相关信息 【description】本书的简单描述 【language】gitbook使用的语言 【root】指定存放 GitBook 文件（除了 book.json）的根目录 【structure】指定自述文件，摘要，词汇表等的路径

gitbook支持许多插件，可以扩展gitbook的功能。

【打赏功能：donate】

【广告功能：ad】

【目录宽度可调节：splitter】

【github图标】

【自定义页脚：tbfed-pagefooter】

【目录章节可折叠：expandable-chapters】

【畅言评论：changyan】

【返回顶部：back-to-top-button】

  上面支持列举了一些常用的插件，想要了解更多可以阅读官方文档，插件在book.json配置好后，需要安装。

book.json模板

去掉gitbook的版权信息：

创建样式表文件“styles/website.css”，添加代码如下：

编辑“book.json”文件，添加如下代码：

好了，让我们看一下我们文档的效果图。