1.1 gitbook介绍
1、gitbook说明
GitBook 使用的markdown语法 在此基础上做了一些 写作便利性的加强
Markdown 是一种轻量级的「标记语言」，优点在于
-
-
- 专注你的文字内容而不是排版样式。
- 轻松的导出 HTML、PDF 和本身的 .md 文件。
- 纯文本内容，兼容所有的文本编辑器与字处理软件。
- 可读，直观。适合所有人的写作语言。
-
2、安装gitbook
npm install gitbook-cli -g # 安装gitbook
gitbook help # 查看gitbook帮助信息
gitbook -V # 查看gitbook版本信息
3、创建一个gitbook项目
C:Users om> cd C:aa est-book # 进入要进行书写的空文件夹
C:aa est-book> gitbook init # 初始化文件夹
C:aa est-book> gitbook serve --port 80 # 在本地80端口运行gitbook这个服务
# 注访问：http://localhost:80
4、设置gitbook样式
{ "language": "zh-hans", "plugins": [ "livereload", "highlight", "search", "lunr", "-sharing", "fontsettings", "theme-default" ], "styles": { "website": "styles/website.css" } }
.gitbook-link {
display: none!important;
}
1.2 设置目录层级结构
1、说明
1. test-book 目录下的 SUMMARY.md 文件是 gitbook init 自动生成的 你也可以自己创建 这个markdown文件决定了你文档的目录结构
2. SUMMARY.md 就是一个markdown文件 当中内容遵循如下格式，星号 空格 方括号 圆括号【 * [前言](README.md) 】
1）星号：的缩进代表所在条目的层级结构，四个空格为一个层级，相当于是一个链接
2）方括号：中是链接的名字
3）圆括号：中是一个文件里面是实际内容
4）默认的 README.md 是你的说明文件 你可以将文档的说明内容 在此文件中编辑 对应一本书的前言 或者是序言
2、使用举例
1）创建对应的文件目录结构
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
C:aa est-book>tree /F C:. │ book.json # 设置gitbook插件 │ README.md # gitbook介绍 │ SUMMARY.md # gitbook目录结构 │ ├─styles │ website.css # 设置样式 │ ├─chapter1 # 第一章文件夹 │ chapter1.md # 第一章文件 │ section1.md │ section2.md │ section3.md │ ├─chapter2 # 第二章文件夹 │ chapter2.md # 第二章文件 │ section1.md │ section2.md │ section3.md │ ├─chapter3 # 第三章文件夹 │ chapter3.md # 第三章文件 │ section1.md │ section2.md │ section3.md
2）在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)
1.3 gitbook一些实用插件
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"
}
}
{ "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 # 重新运行项目
2、折叠模块(页面内容可折叠)
# 在book.json的plugins参数中添加插件名
{
"plugins": ["accordion"]
}
%accordion% 折叠代码块标题 %accordion% ```python print("折叠代码块内容") ``` %/accordion%
3、生成页内目录（在book.json的plugins参数中添加插件名）
{ "plugins": ["page-treeview"], "pluginsConfig": { "page-treeview": { "copyright": "Copyright © aleen42", "minHeaderCount": "2", "minHeaderDeep": "2" } } }
4、gitbook代码高亮
{ "plugins": [ "prism", "prism-themes" ], "pluginsConfig": { "prism": { "css": ["prism-themes/themes/prism-duotone-dark.css"] } } }
1.4 把gitbook打包
1、gitbook打包
C:Users om> cd C:aa est-book # 进入gitbook文件目录
C:aa est-book> gitbook build # 把文件编译成html格式
2、由于gitbook 3.x.x版本bug导致build后的文件无法自动跳转页面
# 文件位置：_bookgitbook heme.js
# 由于代码是压缩后的，会没有空格，搜索的时候可以直接搜索： if(m)for(n.handler&&
# 将if(m)改成if(false)