安装:
npm install --save-dev gitbook-cli
使用:
- 新建一个文件夹;
- 打开命令行,cd到这个文件夹下,执行
gitbook init
进行初始化,执行完成后,文件夹下会生成两个文件:README.md(书籍的介绍)和SUMMARY.md(书籍的目录结构); - 使用
gitbook serve
命令启动本地服务,命令执行结束后,可以在浏览器中打开http://localhost:4000
查看书籍; - 使用
gitbook build
命令构建,命令执行结束后,会在项目下生成_book的文件夹,此文件夹就是最终生成的项目;
写目录:
SUMMARY.md就是整个文件夹的目录,写目录其实就是编辑这个文件。
语法:英文中括号中是目录的名字,英文小括号中是路径。中括号和小括号之前没有空格。
写完目录之后再次执行gitbook init
,GitBook会查找SUMMARY.md中描述的目录和文件,如果没有的话会自动创建。