创建书籍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!