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。