GitBook 入门学习

1、什么是 Gitbook

GitBook 是一个基于 Node.js 的命令行工具，支持 Markdown 和 AsciiDoc 两种语法格式，能够输出 HTML、PDF、eBook 等格式的电子书。

Gitbook 使用方案：

• GitBook + Typora / Vscode+ Git：推荐
• GitBook + Gitbook Editor+ Git

Git 须要依赖 Node.js，Node.js 和 Git 安装都很简单，这里就再也不赘述，相关连接以下：

• Node.js
• Git
• Typora

2、Gitbook 安装及使用

安装命令：

# 打开命令行（管理员）执行如下命令，安装 Node.js 时已经安装好 npm 工具包
npm install -g gitbook-cli

安装好以后，会多了一个 gitbook 命令，如今来初始化一本书：

cd E:
mkdir mybook
cd mybook
gitbook init        # 初始化

执行完毕会发现 mybook 目录中多了两个文件：

• README.md：书籍介绍
• SUMMARY.md：书籍目录结构

用 Typora 打开 SUMMARY.md，编辑以下（此步是编写书籍目录）：

# 目录

* [前言](README.md)
* [第一章](Chapter1/README.md)
  * [第1节：衣](Chapter1/衣.md)
  * [第2节：食](Chapter1/食.md)
  * [第3节：住](Chapter1/住.md)
  * [第4节：行](Chapter1/行.md)
* [第二章](Chapter2/README.md)
* [第三章](Chapter3/README.md)
* [第四章](Chapter4/README.md)

再执行 gitbook init，gitbook 就会自动建立相应章节，以下图所示：

还能够生成 HTML 静态文件，在浏览器中查看：

gitbook serve

出现错误：

解决：找到 C:\Users\hj\.gitbook\versions\3.2.3\lib\output\website\copyPluginAssets.js 文件，注释掉第 112 行：

return fs.copyDir(
        assetsFolder,
        assetOutputFolder,
        {
            deleteFirst: false,
            overwrite: true,
            /*confirm: true*/           /*注释这行*/
        }
    );

参考文章：http://www.javashuo.com/article/p-twpsokwy-dh.html

再次执行 gitbook serve：

访问：<http://localhost:4000/：

3、经常使用命令

# 构建书籍，默认将生成的静态网站输出到 _book 目录
gitbook build

# 指定路径
gitbook build [书籍路径] [输出路径]

# 指定端口
gitbook serve --port 2333

# 你还能够生成 PDF 格式的电子书
gitbook pdf ./ ./mybook.pdf
gitbook epub ./ ./mybook.epub       # epub 格式
gitbook mobi ./ ./mybook.mobi       # mobi 格式

其余命令：

gitbook init         //初始化目录文件
gitbook help         //列出gitbook全部的命令
gitbook --help      //输出gitbook-cli的帮助信息
gitbook build        //生成静态网页
gitbook serve       //生成静态网页并运行服务器
gitbook build --gitbook=2.0.1        //生成时指定gitbook的版本, 本地没有会先下载
gitbook ls                          //列出本地全部的gitbook版本
gitbook ls-remote                   //列出远程可用的gitbook版本
gitbook fetch 标签/版本号            //安装对应的gitbook版本
gitbook update                  //更新到gitbook的最新版本
gitbook uninstall 2.0.1             //卸载对应的gitbook版本
gitbook build --log=debug            //指定log的级别
gitbook builid --debug                  //输出错误信息

参考文章

• GitBook使用教程
• GitBook 简明教程
• GitBook 从懵逼到入门