gitbook操作

上一篇介绍了gitbook的安装和部署，本节介绍一下gitbook的操作；主要包括：

• md文件的新建和编辑；
• gitbook目录结构的设计；

1、md文件的新建和编辑

1）新建md文件

通过typora软件新建文件，文件名称：使用简介.md

2）编辑

右键菜单，可选择段落标题和插入的内容（包括：代码、图像、表格等）

插入图片：

图片路径：

/usr/local/gitbook/images/gitbookVersion.png，其中/usr/local/gitbook为gitbook服务的目录，在插入图片时，内容可省略，插入图片格式如下：


 

 2、gitbook目录设计

1）在创建md文件存放目录

在/usr/local/gitbook目录下新建目录，目录名称自定义，例如:md

mkdir md

2)编辑好的md文件（README.md）置于md目录下

README.md文件内容如下：

# 一、gitbook使用简介

GitBook是一个命令行工具（和Node.js库），用于使用GitHub / Git和Markdown（或AsciiDoc）构建精美的书籍；[gitbook](https://www.gitbook.com/) 的默认语法就是markdown，能够很好的展现你的内容，并且排版都不需要你担心，在此基础上，会自动生成目录、父子级、划分列表，让你把所有的精力都放在内容，还可以直接部署在互联网上；markdown文件的格式为.md，可通过文本编辑器直接打开和编辑，常用Typora软件来编辑；

# 二、安装部署

## 2.1、nodejs安装部署

1）下载

```
wget http://cdn.npm.taobao.org/dist/node/v10.16.0/node-v10.16.0-linux-x64.tar.xz
```

2）解压

```
tar -xvf node-v10.16.0-linux-x64.tar.xz
```

3）重命名

```
mv node-v10.16.0-linux-x64 nodejs
```

4)移动到/usr/local目录

```
mv nodejs /usr/local
```

5)建立软链接(为node和npm建立软链接，确保node和npm命令能直接使用）

```
ln -s /usr/local/nodejs/bin/node /usr/bin/node
ln -s /usr/local/nodejs/bin/npm /usr/bin/npm
```

6）安装验证

```
node -v
```

成功安装可显示nodejs版本号；

## 2.2、gitbook安装

1）安装gitbook-cli

```
npm install gitbook-cli -g
```

2）建立软链接（为gitbook建立软链接）

```
ln -s /usr/local/nodejs/bin/gitbook /usr/bin/gitbook
```

3）安装验证

```
gitbook -V
```

安装成功，输出gitbook版本号，显示结果如下：

![](/usr/local/gitbook/_book/gitbook/images/gitbookVersion.png)

## 2.3、gitbook启动

执行命令:

```
gitbook serve
```

输出结果：

![](/usr/local/gitbook/_book/gitbook/images/gitbookStart.png)

## 2.4、浏览器访问

在浏览器输入访问地址：http://172.16.79.151:4000/

页面展示如下：

![](/usr/local/gitbook/_book/gitbook/images/page.png)

 

3）编辑SUMMARY.md文件

# Summary

* [0-使用简介](md/README.md)

4）编译

执行编译命令：

gitbook build

5）启动

执行启动命令：

gitbook serve

6)浏览器访问

浏览器输入地址：http://172.16.79.151:4000