GitBook关联GitHub

4

想用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随便输入点东西。
图片描述

注意右上角有两个按钮:SavePublish。当点击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。


如果觉得我的文章对你有用,请随意赞赏
载入中...