创建书籍Github-Gitbook-本地

本章节的主要内容是教会大家创建一个与Github相关联的书籍。

Github上通常以一个repository为单位又称项目,在上面写书籍也不是不可以,不过会对那些没有安装Chrome插件的人浏览起来不会方便,因为他们看不到一个类似左边的一个目录。

Gitbook的HTML就解决了这个问题,而Gitbook支持 Github/Git 方式创建数据,这就非常方便我们更新书籍的内容。

准备工作

首先,确保你的电脑上安装好以下工具:

Node.js是Gitbook的环境需求,Git是我们同步数据的工具,Atom是写Markdown的工具。Gitbook.Editor是本地Gitbook客户端。
安装好以上工具并参照之前章节内容安装Gitbook。
其次你还需要有自己的 Github 账户,没有就赶快注册去吧。

新建Gitbook书籍

步骤1:创建Github仓库
打开Github网站,登录,并创建新的仓库。

步骤2:使用Github账户登录Gitbook
打开Gitbook,点击登录按钮上方的黑粗Github使用Github方式登录。

步骤3:以Github/Git方式创建书籍
登录好后你就拥有了一个自己的Gitbook,现在就可以创建书籍了。点击右上方的NEW,默认显示前3个选项点击下方的箭头会翻页。

  • BOOK & MANUAL
  • API DOCUMENTATION
  • KNOWLEDGE BASE
  • IMPORT A DOCUMENT
  • GITHUB
  • GIT

我们可以选择Github或者Git,
选择Github我们可以直接选择Github上我们创建的Reoisutory,

选择Git我们只有复制Github上Reoisutory的URL粘贴上去就OK了,最后记得Create Book.

步骤4:使用Gitbook.Editor导入Gitbook书籍
到这里我们需要打开安装好的Gitbook.Editor本地客户端,点击右上方的Gitbook.com按钮,会显示Gitbook上已创建的书籍,点击书籍会弹窗,点击clone就会拉取书籍模版到本地,这样就可以本地编辑了。

步骤5:使用Atom编辑书籍
拉取到书籍目录后就可以在Atom中打开了。如果你是Atom新手,这里建议你学习Atom的使用,或者直接使用Gitbook.Editor进行编辑。本人被Atom迷惑所以离不开它了,多样的插件与定制快捷键,可以与IDEA比较,又超过Sublime。 这里给张本人正在编辑的截图:

步骤6:同步本地仓库并提交书籍
在我们编辑好后就需要同步本地仓库然后提交到Github.
首先右键书籍目录,选择Git Bash here,
使用git status 查看状态,
使用git add . 添加所以的修改内容,
使用git commit -m "test" 提交到本地仓库 打开Gitbook.Editor,点击本地书籍进去,左上方的云按钮同步即可。

ICKY!