GitBook关联GitHub

想用GitBook的客户端写文档，但是发现不能登录GitBook的帐号，主要目的是想把工作成果保存到网络上避免放在自己电脑上丢失。于是我采用折衷的办法，用GitBook在本机写作，然后把文章保存在GitHub。

1. 下载安装GitBook Editor

链接：https://www.gitbook.com/editor/

安装后打开，客户端提示登录GitBook帐号。由于我值需要用GitBook Editor做编辑工具，不需要把文章存在GitBook上（根本原因是登录不了，原因你懂）。选Do that later：

由于没有登录，创建的图书都会在存储在本地，而不会传到GitBook网上。GitBook Editor创建的图书默认是在C:\Users\用户名\GitBook目录下，我习惯把资料存在D盘，于是选择菜单栏GitBook Editor - Change Library Path，把目录改成D:\GitBook：

2. 在本地创建图书

点击New Book创建图书，填写书名，点击确定，创建后图书相关的文件会存储在D:\GitBook\Import目录下。相关截图：

注意：由于我在创建图书前将Library Path改成了D:\GitBook，所以我新建的图书的文件才会存储在D:\GitBook\Import目录下。而Import目录是对应GitBook Editor菜单栏的Import命令。经我测试，如果再创建一个D:\GitBook\Open目录，对应的就是GitBook Editor菜单栏的Open命令。Import和Open的区别是：

• Import可以将从本地其它目录的图书（用gitbook init命令创建的图书目录）导入到Library Path，导入后修改的文件内容会保存在Library Path。比如：在D:\test\hello目录通过gitbook init创建了一本书，然后打开GitBook Editor Import，选择D:\test\hello，然后D:\test\hello目录的文件就会复制到D:\GitBook\Import\hello。而在GitBook Editor中修改了内容后，这些内容会保存在D:\GitBook\Import\hello目录下。
• Open就是直接打开一个gitbook init的图书。经测试，只有在Library Path下的Open目录下使用gitbook init命令创建的图书，才会正常在GitBook Editor中显示。

3. 关联GitHub

在GitBook打开新创建的图书，点击Add an article随便输入点东西。

注意右上角有两个按钮：Save和Publish。当点击Save的时候，GitBook Editor会把编辑的内容保存在Library Path。而当点击Publish的时候，就会把编辑的内容保存到Git仓库（可以是任意的Git仓库：GitHub、码云、oschina...）。如果当前这本存储在本地的图书没有关联Git仓库，GitBook Editor会弹出提示：

那么这时候就需要创建一个Git仓库了。到GitHub创建一个空白的仓库，并复制https的git仓库地址。注意必须使用https的因为GitBook Editor暂时不支持SSH，相关截图：

然后把git仓库地址复制到GitBook Editor，点击Sync，再输入GitHub的帐号密码就OK了，相关截图：

最后检查一下GitHub上时候已经有刚同步上去的文件，如果有就OK了。

接下来就可以开始编辑自己的图书，编辑后记得要点击右上角Publish同步到GitHub。