Git & MarkDown

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

1. 克隆书籍源代码

gitbook.com 上的每本书都使用 Git 项目来管理，所以，这里首先需要克隆需要编辑书籍的 Git 项目，登陆 gitbook.com 后，跳转到书籍的属性页面，如下图所示：

点击 "Edit Book" 上方的 "learn more"，将会展现此书籍的 Git 项目地址，以及简单的使用方法，如下图所示：

使用如下命令，克隆书籍的源代码：

$ git clone https://git.gitbook.com/chengweiv5/test.git


Cloning into 'test'...
remote: Counting objects: 28, done.
remote: Compressing objects: 100% (17/17), done.
remote: Total 28 (delta 6), reused 28 (delta 6)
Unpacking objects: 100% (28/28), done.
Checking connectivity... done.

$ cd test/
$ ls


README.md  SUMMARY.md

$ git log --oneline
07bde6c Cleanup example
6d368db Add _book to gitignore
20779f5 Add explanation in README.md
1b5b1a6 Create chapter-1/ARTICLE1.md
77b1858 Add help message in SUMMARY.md
210e3fe Create chapter-1/README.md
5570112 Create SUMMARY.md
2a8a0c3 Initial commit

可以看到，创建好的书籍默认已经创建了一些内容，但是这些内容是还没有发布的，所以其它人不能阅读。

2. 编辑内容

现在，可以自由编辑书籍内容，使用 $ gitbook init, $ gitbook serve 来预览，完成后，可以提交修改：

git commit -asm "init book"

3. 发布内容

最后，提交到远程 Git 项目：

git push


Counting objects: 3, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 362 bytes | 0 bytes/s, done.
Total 3 (delta 1), reused 0 (delta 0)
To https://git.gitbook.com/chengweiv5/test.git
   07bde6c..b6a8b3f  master -> master

4. 阅读书籍

提交到 gitbook.com 后，书籍就自动发布了，用户就可以通过书籍的地址访问了，例如：http://chengweiv5.gitbooks.io/test/

点击 "READ" 按钮，就可以阅读书籍的内容了。