gitbook快速入门及命令行命令

一、何为gitbook？

通过git与markdown构建书籍的开源工具，可转换为PDF，ePub，mobi或html等格式。其中git非必须，完全可以使用其他的代码提交工具代替。

二、上手使用

1.前提

• 安装好node环境
• 了解git命令
• 了解markdown语法

2.安装依赖

$ npm install -g gitbook

3.项目初始化

路径切换到你要创建项目的地方，输入以下命令回车

$ gitbook init

此时你会发现项目中多了两个文件，README.md与SUMMARY.md。其中SUMMARY.md为项目目录，通过该目录可跳转到不同文章；README.md为项目介绍，一般为gitbook书籍的第一章。

4.打包

这一步可将一个个markdown文件转化为一个直接由浏览器打开的html项目，样式就如同我们曾经见过的gitbook书籍。

$ gitbook build

执行完该命令项目中会多出一个_book的文件夹，其中存放的就是打包生成的项目代码（包含html、css、js及引用到的图片）。

三、gitbook命令行

1. gitbook init

gitbook项目初始化。

2. gitbook serve

启动gitbook项目并提供http://localhost:4000为浏览器浏览链接。

3. gitbook build [path]

构建gitbook项目，构建路径可省略，默认为_book

四、脚手架

需要快速搭建gitbook项目时推荐使用。通过以下命令即可快速安装。

$ npm install -g gitbook-cli

github项目地址

END