> For the complete documentation index, see [llms.txt](https://philm.gitbook.io/philm-ios-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://philm.gitbook.io/philm-ios-wiki/mei-zhou-yue-du/gitbook-shi-yong-xiao-zhu-shou.md).

# gitBook使用小助手

1、查看书本内容 ：

a、自己创建的书本：

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

例如 [https://jackming.gitbooks.io/problem-collection-manual/content/](https://jackming.gitbooks.io/problem-collection-manual/content/]\(https://jackming.gitbooks.io/problem-collection-)

b、加入组织的书本:

格式 [https://{organizeName}.gitbooks.io/{bookName}/content/](https://{organizeName}.gitbooks.io/{bookName}/content/]\(\)\\)

例如 [https://philm.gitbooks.io/philm-ios-wiki/content/](https://philm.gitbooks.io/philm-ios-wiki/content/]\(https://philm.gitbooks.io/philm-ios-wiki/content/\)\\)

c、界面面操作按钮![](/files/-LAdZWTEwH-KeM4zUPbN)

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/{organizeName}/{bookName}/eidt]\(\)\\)

例如 [https://www.gitbook.com/book/philm/philm-ios-wiki/edit](https://www.gitbook.com/book/philm/philm-ios-wiki/edit]\(https://www.gitbook.com/book/philm/philm-ios-wiki/edit)

c、界面操作按钮:![](/files/-LAdZWUbdcSb8flDTQQr)

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

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

打开 导出PDF选项

![](/files/-LAdZWWOP5wP0LR_Mz0y)

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

4、编辑书本:

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

        即可添加书本章节。
```

b、更改 『章节名称』: 将鼠标悬乎到目标章节上，会发现章节右侧会出来一个编辑按钮![](/files/-LAdZWZmnjTLeN0-WaKb) 点击编辑按钮，章节标题进入编辑

```
    态。输入新的标题即可。
```

c、删除 『章节目录』: 右键目标章节目录![](/files/-LAdZWa32v4J5-ilxa3a)在弹出的子菜单中 点击”Remove”选项。

```
    ps：删除需谨慎，请确保删除的章节下面没有文章！
```

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

```
     击 “Add”按钮就能在目标章节下面添加一篇新的文章。

      ps:gitBook 是支持无限级别的树目录的，
```

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

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

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

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

![](/files/-LAdZWda1RifoRtkmWa1)

h、文章中『插入图片』：点击编辑界面顶部的工具栏 上面的![](/files/-LAdZWgKqnS2ckoHUOeH)按钮。在弹出的对话框中选择需要插入的图片。

## GitBook 终端机指令 <a href="#gitbook-e7-b5-82-e7-ab-af-e6-a9-9f-e6-8c-87-e4-bb-a4" id="gitbook-e7-b5-82-e7-ab-af-e6-a9-9f-e6-8c-87-e4-bb-a4"></a>

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制书的两个必要档案
