gitbook基本使用

需要先安装node.js
npm install -g gitbook-cli

2.新建一本书

2.1 mkdir mybook #创建文件夹

2.2 gitbook init #初始化

目录中会产生两个文件

README.md —— 书籍的介绍写在这个文件里
SUMMARY.md —— 书籍的目录结构在这里配置

2.3SUMMARY.md文件示例

# 目录

* [前言](README.md)
* [第一章](Chapter1/README.md)
* [第1节：衣](Chapter1/衣.md)
* [第2节：食](Chapter1/食.md)
* [第3节：住](Chapter1/住.md)
* [第4节：行](Chapter1/行.md)
* [第二章](Chapter2/README.md)
* [第三章](Chapter3/README.md)
* [第四章](Chapter4/README.md)

3.生成

gitbook build //生成在当前目录的默认文件夹 _book里面
gitbook build ./out //生成在当前目录的默认文件夹 指定的out 里面
gitbook build ./md ./out //当前md外 生成out

4.本地预览

gitbook serve
http://localhost:4000

常用命令解析

---------------------   
gitbook init //初始化目录文件  
gitbook help //列出gitbook所有的命令  
gitbook --help //输出gitbook-cli的帮助信息  
gitbook build //生成静态网页  
gitbook serve //生成静态网页并运行服务器  
gitbook build --gitbook=2.0.1 //生成时指定gitbook的版本, 本地没有会先下载  
gitbook ls //列出本地所有的gitbook版本
gitbook ls-remote //列出远程可用的gitbook版本
gitbook fetch 标签/版本号 //安装对应的gitbook版本
gitbook update //更新到gitbook的最新版本
gitbook uninstall 2.0.1 //卸载对应的gitbook版本
gitbook build --log=debug //指定log的级别
gitbook builid --debug //输出错误信息
---------------------

gitbook基本使用

原文：https://blog.51cto.com/xiaoma90/2397427