GitBook的使用方法

---恢复内容开始---

由于近期工作中使用gitbook编写讲义，现把出现的问题总结下：

1 . gitbook的安装

Gitbook与word等办公软件类似，能够编写文档，Gitbook中编写文档时使用的Markdown格式，可以提交到gitHub上进行版本管理，我使用的组合是gitbook+Typora+git完成整个内容的编写工作。

Gitbook 是基于 Node.js，所以我们首先需要安装 Node.js（下载地址：https://nodejs.org/en/download/），找到对应平台的版本安装即可。

现在安装Node.js会默认安装npm(node包管理工具)，所以不用单独安装 npm，打开命令行，执行以下命令安装 GitBook：

npm install -g gitbook-cli

安装后，就会有一个gitbook命令，就可以使用这个命令来创建书籍。

书籍内容的编辑使用的是Typora，在网上找到安装包后，安装即可使用。

git是版本管理工具，大家应该都很熟悉，就像托管代码一样，托管我们的书籍即可。

2 . 书籍的创建

在你要创建书籍的文件夹下打开终端窗口，比方说是firstbook,执行下述命令：

gitbook init　　

执行完以上代码后，会在文件夹中产生两个文件：readme.md和summary.md

 

readme文件中是书籍的介绍内容，这个根据您的需求编写。

summary中是书籍的目录结构，现在我们就是用Typora编辑这个文件，其中的内容为：

* [Introduction](README.md)

* [1. 季节](季节/ReadMe.md)
  * [1.1 春](季节/section0.md)
  * [1.2 夏](季节/section1.md)

* [2. 城市](城市/ReadMe.md)
  * [1.1 北京](城市/section0.md)
  * [1.2 上海](城市/section0.md)

然后，我们执行gitbook init来中心初始化这本书籍，这是我们看下结果：

 

 文件夹中就生成了各个章节对应的文件，我们就可以在这些文件中写入相应的内容。

书籍写完之后使用

gitbook serve

生成html的文件即可，

也可使用：

gitbook build

来生成书籍。

3 生成书籍后遇到的问题：

　　1 ,点击目录，无法到达对应的位置：

　　找到gitbook目录下的thema.js文件：

 

 找到其中的if(m)for(n.handler&&并将其中的m修改为false即可。

 

2. 目录无法折叠，无法改变其宽度，code无法复制等

 

在 summary.md目录中添加一个book.json,然后在其中添加以下内容：

{
    "title": "opencv",
    "output.name": "site",
    "language": "zh-hans",
    "gitbook": "3.2.3",
    "root": ".",
    "plugins": [
        "code",
        "splitter",
        "chapter-fold"
    ],
    "pluginsConfig": {
        "code": {
            "copyButtons": true
        }
    }
}

　　

 并运行gitbook install 即可。

 

 

 

---恢复内容结束---