gitbook安装使用
gitbook安装使用
1. gitbook安装
gitbook是一个基于Node.js的命令行工具，所以要先安装Node.js(下载地址：https://nodejs.org/en/，找到对应平台的版本安装即可)。
Node.js都会默认安装npm（node包管理工具），所以不需要单独安装npm，打开命令行，执行以下命令安装GitBook:
npm install -g gitbook-cli
2. 编辑工具的安装
这里给大家介绍两个编辑工具：gitbook editer和typora
gitbook editer
这个编辑工具对新手来说是个不错的选择，它集成了gitbook，git，Markdown等功能，可以将书籍同步到gitbook.com网站和github。但是gitbook editor的注册和登录需要FQ，而且这东西的官网进不去，所以还下不到.
typora
这个工具是我目前在使用的,一直都很喜欢使用这个工具
3. gitbook本地使用
3.1 建议使用的插件
在你想要初始化的目录下，添加文件book.json
{
"plugins": [
"summary",
"expandable-chapters"
]
}
使用以下命令安装
gitbook install # summary主要用来自动生成目录，expandable-chapters用于生成目录树
# summary 存在bug，我每次等生成之后再做一下调整
3.2 初始化工作目录
- README.md（书籍的介绍在这个文件里，在初始化钱必须有这个文件）
- SUMMARY.md（书籍的目录结构在这里配置，summary插件帮助我们生成，可以不要）
3.3 生成书籍记录
gitbook init
4. 常用命令
gitbook serve #将书籍生成为一个网站
gitbook install #安装插件
gitbook init #为章节设置和创建文件
5. 问题
-
使用node 14时存在问题，换成12后问题都解决了
-
参考博客
