揭秘Gitbook：电子书制作神器，让你的知识分享更精彩！

2023-08-22 10:39 作者:蓝桥云课 0人读过 | 我要投稿

内容源于蓝桥云课社区-轻实验，可在线开启环境实操

你是不是有很多 MarkDown 的学习笔记需要整理？你心中是不是有一个作家梦？

本次，我将介绍如何借助 GitBook ，将 MarkDown 类型的文档编辑成一本在线的开源电子书，方便随时随地查阅。

GitBook 是一个基于 Node.js 的命令行工具，可使用 Github/Git 和 Markdown 来制作精美的电子书，GitBook 和 Git 并无直接关联。

GitBook 生成电子书主要有三种方式:

GitBook 支持输出多种文档格式：

本次实验主要讲解第一种 gitbook-cli 命令行操作流程。

常用 GitBook 命令

1.安装 gitbook-cli 脚手架工具

本机已安装 node.js 开发环境，安装完成后运行 gitbook -V 能够打印出版本信息，则表示安装成功。

运行时会报如下错误：

原因是容器中默认安装的 node 版本过高，需要先卸载容器中高版本的 npm ：

再安装低版本的：

2.初始化 gitbook 项目

此处初始化需要一点点时间，请耐心等待。

使用 GitBook 制作电子书，必备两个文件：README.md 和 SUMMARY.md。通过初始化 gitbook 项目即可按照 gitbook 规范自动创建 README.md 和 SUMMARY.md 两个文件，这两种的作用在下文介绍。

3.启动 gitbook 项目

在执行 gitbook init 命令的目录下启动本地服务，通过 port 指定端口，如果不指定，默认为 4000。

程序无报错，则可以在浏览器预览电子书呈现效果:

4.构建 gitbook 静态网页

构建静态网页而不启动本地服务器，默认生成文件存放在 _book/ 目录，当然输出目录是可配置的。

既然要书写一本电子书，那么起码的章节介绍和章节详情自然是必不可少的。

当然还要有标题，作者和联系方式等个性化信息需要指定，如果不指定的话，使用默认设置就会出现上图中的效果，所以配置文件一般需要手动设置！

首先简单解释下上图中各个文件的作用:

README.md 是默认首页文件，相当于网站的首页 index.html , 一般是介绍文字或相关导航链接。
SUMMARY.md 是默认概括文件，主要是根据该文件内容生成相应的目录结构，同 README.md 一样都是被 gitbook init 初始化默认创建的重要文件。
_book 是默认的输出目录，存放着原始 markdown 渲染完毕后的 html 文件，可以直接打包到服务器充当静态网站使用。

一般是执行 gitbook build 或 gitbook serve 自动生成的。
book.json 是配置文件，用于个性化调整 gitbook 的相关配置，如定义电子书的标题，封面，作者等信息。

虽然是手动创建，但一般是必选的。
GLOSSARY.md 是默认的词汇表，主要说明专业词汇的详细解释，这样阅读到专业词汇时就会有相应提示信息，也是手动创建但是可选的。
LANGS.md 是默认的语言文件，用于国际化版本翻译，和 GLOSSARY.md 一样是手动创建但是可选的。