有了gitbook记笔记，你不用再担心别人问你问题找不到答案了！！

1.1 gitbook介绍

GitBook 使用的markdown语法 在此基础上做了一些 写作便利性的加强

Markdown 是一种轻量级的「标记语言」，优点在于：

• 专注你的文字内容而不是排版样式
• 轻松的导出HTML、PDF和本身的.md文件
• 纯文本内容，兼容所有的文本编辑器与字处理软件
• 可读、直观。适合所有人的写作语言

1.2 安装gitbook

npm install gitbook-cli -g   # 安装gitbook
gitbook  help                # 查看gitbook帮助信息
gitbook  -V                  # 查看gitbook版本信息

1.3 创建一个gitbook项目

C:\Users\tom>  cd C:\aa\test-book            # 进入要进行书写的空文件夹
C:\aa\test-book>  gitbook init               # 初始化文件夹
C:\aa\test-book>  gitbook serve --port 80    # 在本地80端口运行gitbook这个服务
# 注访问：http://localhost:80

1.4 设置gitbook 样式

• book.json

{
    "language": "zh-hans",
    "plugins": [
        "livereload",
        "highlight",
        "search",
        "lunr",
        "-sharing",
        "fontsettings",
        "theme-default"
    ],


    "styles": {
        "website": "styles/website.css"
    }

}

• styles/website.css

.gitbook-link {
    display: none!important;
}

2.1 设置目录层级结构

这里推荐直接在_book同级目录下创建book.json文件，然后将3.3生成目录文件的配置粘贴进去即可

• 说明

1. test-book 目录下的 SUMMARY.md 文件是 gitbook init 自动生成的 你也可以自己创建 这个markdown文件决定了你文档的目录结构

2. SUMMARY.md 就是一个markdown文件 当中内容遵循如下格式，星号 空格 方括号 圆括号【  * [前言](README.md) 】

　　1）星号：的缩进代表所在条目的层级结构，四个空格为一个层级，相当于是一个链接 

　　2）方括号：中是链接的名字

　　3）圆括号：中是一个文件里面是实际内容

　　4）默认的 README.md 是你的说明文件 你可以将文档的说明内容 在此文件中编辑 对应一本书的前言 或者是序言

2.2 使用举例

• 创建对应的文件目录结构

cd /c/aa/test-book                         # 在windows中使用git进入test-book文件夹，并使用linux环境
mkdir -p chapter{1,2,3}                    # 在test-book中创建文件夹：chapter1  chapter2  chapter3
touch chapter{1,2,3}/chapter{1,2,3}.md     # 在对应文件夹中创建章节文件：chapter1.md  chapter2.md  chapter3.md
touch chapter{1,2,3}/section{1,2,3}.md     # 在对应文件夹中创建文章文件：section1.md  section2.md  section3.md

2.3 在test-book/summary.md 中加入目录结构

# Summary

* [前言](README.md)
* [第一章](chapter1/chapter1.md)
    * [第1节](chapter1/section1.md)
    * [第2节](chapter1/section2.md)
    * [第3节](chapter1/section3.md)
* [第二章](chapter2/chapter2.md)
    * [第1节](chapter2/section1.md)
    * [第2节](chapter2/section2.md)
    * [第3节](chapter2/section3.md)
* [第三章](chapter3/chapter3.md)
    * [第1节](chapter3/section1.md)
    * [第2节](chapter3/section2.md)
    * [第3节](chapter3/section3.md)
* [总结](summary.md)

3.1 gitbook一些常用插件

参考博客：
https://segmentfault.com/a/1190000019806829?utm_source=tag-newest

{
    "plugins": [
        "splitter",              # splitter 侧边栏宽度可调节
        "copy-code-button",      # 快速复制按钮
        "highlight",             # 代码高亮
        "accordion",             # 折叠模块(页面内容可折叠)
        "back-to-top-button",    # 回到顶部按钮
        
        "search-pro",            # search-pro支持中文搜索，在使用此插件之前，需要将默认的search和lunr 插件去掉
        "-search",         
        "-lunr",
        
        "chapter-fold",                   # 左侧目录可折叠
        "expandable-chapters",            # 也是左侧目录折叠的插件，不同的是可以解决chapter-fold插件的bug
        "-expandable-chapters-small",     # 也是折叠菜单的，但是这个插件跟chapter-fold有一样的bug

        "fontsettings",
        "livereload",            # 为GitBook实时重新加载
        "popup",                 # 打开新的页面查看图片
        
        "-sharing",              # 去掉左右分享功能
        "theme-default",
        "theme-comscore",        # 主题插件，修改标题和表格颜色
        "page-treeview"          # 在页面顶部显示目录

    ],

    "styles": {
        "website": "styles/website.css"
    }
}

• test-book/book.json : 添加插件

{
    "plugins": [
        "-search",
        "-sharing",
        "theme-default",
        "-lunr",
        "fontsettings",
        "livereload",
        "popup",
        "splitter",
        "copy-code-button",
        "highlight",
        "-expandable-chapters-small",
        "chapter-fold",
        "back-to-top-button",
        "search-pro",
        "-expandable-chapters"
    ],

    "styles": {
        "website": "styles/website.css"
    }

}

1. gitbook install # 添加的插件没有，需要安装（这个插件比较多，安装有些耗时）

2. gitbook serve --port 80 # 重新运行项目

3.2 折叠模块（页面内容可折叠）

# 在book.json的plugins参数中添加插件名
{
    "plugins": ["accordion"]
}

3.3 生成页内目录（在book.json的plugins参数中添加插件名）

• page-treeview

{
    "plugins": ["page-treeview"],
    "pluginsConfig": {
        "page-treeview": {
            "copyright": "Copyright © aleen42",
            "minHeaderCount": "2",
            "minHeaderDeep": "2"
        }
    }
}

3.4 gitbook代码高亮

• prism

{
    "plugins": [
        "prism",
        "prism-themes"
    ],
    "pluginsConfig": {
        "prism": {
            "css": ["prism-themes/themes/prism-duotone-dark.css"]
        }
    }
}

4.1 把gitbook打包

C:\Users\tom>  cd C:\aa\test-book     # 进入gitbook文件目录
C:\aa\test-book>  gitbook build       # 把文件编译成html格式

4.2 由于gitbook 3.x.x版本bug导致build后的文件无法自动跳转页面

# 文件位置：_book\gitbook\theme.js
# 由于代码是压缩后的，会没有空格，搜索的时候可以直接搜索： if(m)for(n.handler&&
# 将if(m)改成if(false)