使用GitBook, Git github, Markdown 快速发布你的书籍

利用git作为版本管理和发布工具

你可以直接通过npm安装gitbook到全局

npm install -g gitbook

gitbook只提供了如下四个命令

gitbook -h

Usage: gitbook [options] [command]

Commands:

build [options] [source_dir] 编译指定目录，输出Web格式(_book文件夹中)

serve [options] [source_dir] 监听文件变化并编译指定目录，同时会创建一个服务器用于预览Web

pdf [options] [source_dir] 编译指定目录，输出PDF

epub [options] [source_dir] 编译指定目录，输出epub

mobi [options] [source_dir] 编译指定目录，输出mobi

init [source_dir] 通过SUMMARY.md生成作品目录

源文件目录一般是这样的.

• LANGS.md

当你需要发布多个语言版本时，根目录只需要放置一个LANGS.md, 格式如下

* [English](en)

* [中文](zh)

* ...

每个zh，en文件夹现在就相当于一个独立的书籍.

• README.md 相当于书籍的前言部分, 可以忽略

cover_small.png 和 cover.png书籍的封面图

SUMMARY.md

SUMMARY是最重要的一个部分, 它创建的是整书的索引, 可以通过gitbook init读取SUMMARY.md来生成目录结构，格式如下

注意：*和-都是无序列表符号

* [前言](introduct/README.md)

- [API索引](introduct/index.md)

* [高级特性](advanced/README.md)

- [内嵌组件](advanced/component.md)

- [regular的transclude](advanced/content.md)

- [小节](advanced/review.md)

接下来就是依次完成你每个章节的书写了, 你需要开启gitbook serve .来进行实时的web预览(服务器默认为localhost:400)

现在的程序圈的markdown包括gitbook普遍使用的是GitHub Flavored Markdown，除了github中已经说明的那些, 它还支持一些额外的小特性, 比如[x]可以用来设置一个checkbox来实现todolist的功能.

发布

可以直接使用git发布，首先你需要添加gitbook的仓库作为你的一个远程库. 比如regularjs的路径为

git remote add gitbook https://push.gitbook.io/leeluolee/regular-guide.git

git push gitbook master

可以发布到我的个人网站吗?

当然可以，gitbook build之后的_book 就是一个完整的web目录, 你可以放置到你的个人网站上.

一个更好的做法是直接发布到github的gh-pages上, 由于gitbook每次build都会重新生成整个目录.所以你需要利用gulp-gh-pages或grunt-gh-pages等工具进行发布.

你可以参考我的做法, 这样一键gulp deploy可以完成指定目录_book发布gh-pages.

](chapter1/section1.1.md) * [Section1.2](chapter1/section1.2.md) * [Chapter2](chapter2/README.md)

创建了这两个文件后，使用 gitbook init，它会为我们创建 SUMMARY.md 中的目录结构。

GitBook使用

在线编辑：进入到书籍的属性页面后，点击 "Edit Book" 按钮即可打开在线编辑器。

另一种方式，是直接使用文本编辑器，编写 Markdown 文档，然后，使用 Git 提交到书籍的远程项目，当然，提交前，最好在本地使用 gitbook 预览效果；提交后，GitBook.com 会自动生成更新书籍的内容。