如何在 gitbook 上用 github 做一本书

Question

1.建仓库

在github里创建一个仓库，一定要选中Initialize this repository with a README。

2.创建文件

在github里创建SUMMARY.md文件 点击Create new file

在文件名处，输入SUMMARY.MD

在文件内容里输入，

* [前言]（README.md）

点击Commit new file。

3.登陆gitbook

注意，要用github账户登陆，选择Sigh in wiht GitHub

4.创建书籍

点击左上角的 +New Book

5.链接Github

点击下拉框

第二页会出现GITHUB，点击选择。

6.授权 github。

注意，Title 必须是英文

7.给书籍起名

Title必须是英文，选择github的仓库，点击Create Book。

然后 github 和 gitbook 开始同步。

8.编辑书籍

同步成功后，首页面会出现书籍名称，

点击该书名，进入该书的阅读和编辑。

9.阅读书籍

点击Read，可以阅读该书。

10.编辑书籍

返回，点击Edit，进入编辑页面。 有TOC，即Table of Contens，左侧显示的是gitbook目录，右侧是markdown编辑器。

有FILES，左侧显示的是github上的文件，右侧是文件内容。其中的SUMMARY.md页面显示的是大纲。

11.新增内容页

在TOC的左侧右击，选择，+Add Article

在弹出的对话框里，命名为带.md文件。

点击FILES里的SUMMARY.md，则同步创建了一个文件。

12.目录的缩进

点击FILES里的SUMMARY.md，使用Tab键回车。

则TOC的目录会发生变化。

13. 成功创建

这样，在本地就可以创建mardown文件，然后分到几个文件夹，然后push到github里，再和gitbook关联。