文档平台

外观

Gitbook的安装 ​

shell
npm install -g gitbook-cli

创建笔记文件夹 ​

shell
gitbook init

执行完后，文件夹里会多两个文件

  1. README.md（书籍的介绍在这个文件里）
  2. SUMMARY.md（书籍的目录结构在这里配置）

写目录 ​

SUMMARY.md文件就是整个文件夹的目录，写目录其实就是编辑这个文件，刚打开时这个文件里什么都没有，我先在给他编写一下:

markdown
# Summary

* [Introduction](README.md)
* [前言](readme.md)
* [第一章](part1/README.md)
    * [第一节](part1/1.md)
    * [第二节](part1/2.md)
    * [第三节](part1/3.md)
    * [第四节](part1/4.md)
* [第二章](part2/README.md)
* [第三章](part3/README.md)
* [第四章](part4/README.md)

语法：中括号里是这个目录的名字，小括号里是路径。

写完目录后再次执行gitbook init Gitbook会查找SUMMARY.md中描述的目录和文件，如果没有则会创建。上面的目录运行后是这样的

SUMMARY插件 ​

  1. 首先打开你笔记文件夹下的book.json文件，没有就自己创建一个

  2. 将以下代码复制进去

json
{
    "theme-default": {
        "showLevel": true
    },
    "plugins": [
        "toggle-chapters",
        "theme-comscore"
    ]
}

  1. 打开命令行，在这个文件夹中执行命令gitbook install安装插件

  2. 执行命令 gitbook serve 然后在查看的时候就会发现，之前明明没有写目录，现在却有了目录

生成电子书 ​

写完后我们可以执行gitbook serve来预览这本书，执行后会把Markdown格式的文档转换为html格式，最后提示"Serving book on http://localhost:4000"此时用浏览器打开" http://localhost:4000"即可预览书本