gitBook使用小助手

1、查看书本内容 :

a、自己创建的书本:

格式 https://{userName}.gitbooks.io/{bookName}/content/

例如 https://jackming.gitbooks.io/problem-collection-manual/content/

b、加入组织的书本:

格式 https://{organizeName}.gitbooks.io/{bookName}/content/

例如 https://philm.gitbooks.io/philm-ios-wiki/content/

c、界面面操作按钮

2、 书本编辑地址 :(键入网址进入书本编辑页,需要让浏览器记住你的登录状态。非登录状态浏览器会重定向到登录界面)

a、自己创建的书本:

格式 https://www.gitbook.com/book/{userName}/{bookName}/edit

例如 https://www.gitbook.com/book/jackming/problem-collection-manual/edit

b、加入组织的书本:

格式 https://www.gitbook.com/book/{organizeName}/{bookName}/eidt

例如 https://www.gitbook.com/book/philm/philm-ios-wiki/edit

c、界面操作按钮:

3、导出PDF将书本导出成PDF格式需要在书本的”setting”页将 “E-Books\(PDF,MOBI,EPUB\)” 选项打开,路径如下:

点击书本封面进入书本介绍页

打开 导出PDF选项

打开 导出PDF选项之后 过几分钟(gitBook 应该在生成pdf文件) 书本介绍页 会出相 DownLoadPDF 按钮

4、编辑书本:

a、添加 『章节目录』: 点击编辑界面左侧书本目录下的 『+ Add an article』按钮 在随后的 弹框中输入 章节标题 点击 Add 按钮
即可添加书本章节。

b、更改 『章节名称』: 将鼠标悬乎到目标章节上,会发现章节右侧会出来一个编辑按钮 点击编辑按钮,章节标题进入编辑

态。输入新的标题即可。

c、删除 『章节目录』: 右键目标章节目录在弹出的子菜单中 点击”Remove”选项。

ps:删除需谨慎,请确保删除的章节下面没有文章!

d、添加 『文章』:右键目标章节,在弹出来的子菜单中选择 “+ Add Article” 选项。然后在弹出的弹框中输入文章的标题。点

击 “Add”按钮就能在目标章节下面添加一篇新的文章。
ps:gitBook 是支持无限级别的树目录的,

e、删除、更新文章标题同 删除、更新章节标题操作一样。

f、更新文章内容:选中目标文章,在页面右边的编辑区域输文章的新内容。

g、发布最新编辑的内容。 编辑完成后 点击界面右上角的 publish按钮 一键发布。 “publish”按钮 浅蓝色是表示无可发布内容;

为深蓝色的时候表示有新的内容可以发布。

h、文章中『插入图片』:点击编辑界面顶部的工具栏 上面的按钮。在弹出的对话框中选择需要插入的图片。

GitBook 终端机指令

1、安装 Node NPM Calibre

Node 安装

a、官网下载安装:http://www.runoob.com/nodejs/nodejs-tutorial.html

b、NVM 安装:http://weizhifeng.net/node-version-management-via-n-and-nvm.html

Calibre安装

$ npm install -g gitbook-cli

安装完成后查看gitbook版本号

gitbook versions 显示本地目前可用的GitBook 版本。
gitbook versions:available 显示有哪些可以安装的版本。
gitbook versions:install latest 安装最新版。
gitbook versions:install 2.3.3 安装特定版本。
gitbook versions:uninstall 2.3.3 移除特定版本。
gitbook --version 显示GitBook CLI 的版本号。

2、从git上clone书本 书本git地址为:https://git.gitbook/{userName}/{bookName}.git 例如 philm-ios-wiki的地址为:https://git.gitbook.com/philm/philm-ios-wiki.git 将书本clone下来之后 可以通过命令行生成本地的html文件在本地预揽

gitbook build 编译书本
gitbook build [book] [output] book 书本名称 output 输出路径
gitbook serve 编译书本并启用本地服务器
gitbook serve [book] [output] serve the book as a website for testing

ps: 使用 带output 的命令行时候,一定要在output路径下面建立一个 README.md文件

执行改命令行后命令行界面会有一个 本地网络地址默认为:http://localhost:4000 在浏览器中输出该地址就能在本地预览书本

3、导出pdf epub mobi

gitbook pdf [book] [output] build a book into an ebook file
gitbook epub [book] [output] build a book into an ebook file
gitbook mobi [book] [output] build a book into an ebook file

4、建立本地书本

首先建立一个空目录,例如mybook,接着切换(cd mybook)到该目录下。 在空目录中输入gitbook init,此时目录下会新增两个档案:README.md与SUMMARY.md,这些是除了实际内容档案之外,GitBook制书的两个必要档案