在Coding.net上搭建并配置 gitbook电子书的记录

一、安装Node.js

1、去node.js官网下载安装包，根据自己电脑下载对应的版本，我这里下载的是64位安装程序（下载地址：http://nodejs.cn/download/）

2、一路默认安装，当然这里截图说明安装node.js时候，node.js和npm都被安装了，并加入了环境变量（node.js和npm的关系类似python和pip的关系，npm是一个包管理工具）

3、安装完成可以重新通过命令看版本号 node -v npm -v

二、安装gitbook程序

执行命令npm install -g gitbook-cli，默认下载的国外镜像，如果网速不好，可能会略慢，耐心等待

下载好后出现版本号，安装成功（我等了4分钟）

可以使用gitbook -V 来检查是否安装成功。

三、配置仓库

进入Coding.net创建仓库

创建2个仓库 fox 和 fox-doc (仓库名字随意取)：

fox-doc: GitBook 源文件
fox: GitBook 生成的静态文件

克隆

克隆这 2 个仓库到本地的同一个文件夹下（yourname换成你的账号名）（我这里克隆到G:Ggitbook）

git clone git@git.coding.net:yourname/fox.git
git clone git@git.coding.net:yourname/fox-doc.git

四、本地查看

这一步就可以做一本书，然后放在本地服务器上看看了。

创建文件 README.md 和 SUMMARY.md，它们是 GitBook 最重要的 2 个文件，README.md 对书进行介绍，在 SUMMARY.md 中描述书的目录结构，其内容可参考如下:

README.md:

本书用于介绍 Pandora 项目的使用说明

SUMMARY.md:

# Summary

* [简介](README.md)
* [第一章](chapter1/README.md)
    * [第一节](chapter1/section1.md)
    * [第二节](chapter1/section2.md)
* [第二章](chapter2/README.md)
    * [第一节](chapter2/section1.md)
    * [第二节](chapter2/section2.md)
* [结束](end/README.md)

执行 `gitbook init`

在书籍目录（我的是G:Ggitbook）右键打开git bash，

执行gitbook init命令

会自动创建 SUMMARY.md 中描述的目录结构对应的文件夹和文件，每次执行这个命令都会创建还没有还不存在的文件和文件夹，但是不会影响已经创建的，所以不用担心多次执行 gitbook init 导致数据丢失

执行 `gitbook serve`

在浏览器里访问 http://localhost:4000 就可以看到上面写的书了，以后常用的也是这个命令，当文件变化后可以在网页中及时看到新的变化

补充：

Windows 中 gitbook serve 运行后，当文件发生变化时不是自动更新网页而是退出，可以使用下面的脚本来运行 gitbook serve 解决这个问题：

@Echo off
:Start
call gitbook serve
goto Start

把上面的文件保存为 gs.bat 放到 GitBook 目录中，运行 gs.bat 就可以了。

五、上传到Coding

复制 fox-doc/_book 中的文件到 fox 目录下（不是直接复制_book文件夹，而是复制里面的文件）

进入fox目录，右键打开git bash，依次执行下面命令

git add -A
git commit -m "test"
git push

访问 https://coding.net 中的仓库 fox，找到 Pages 服务，一键开启

访问 http://yourname.coding.me/fox 就可以看到我们使用 GitBook 写的内容了

五、脚本自动化

第四步每次上传都要执行三个命令，枯燥无味还容易出错，所以写个脚本自动化执行。

类 Unix 可以使用 shell 脚本 fox-doc/deploy.sh 进行自动化处理：

gitbook build
cd ../fox
rm -rf *
cp -r ../fox-doc/_book/* .
git add -A
git commit -m "test"
git push

在 fox-doc 目录中执行 sh deploy.sh 就可以把 GitBook 生成的网页发布到网上了

Windows 可以使用 Bat 脚本 fox-doc/deploy.bat 进行自动化处理：

call gitbook build
cd ..\fox
del /Q *
rd /S /Q gitbook
xcopy /E ..\fox-doc\_book\* .
git add -A
git commit -m "test"
git push
cd ..\fox-doc

在 fox-doc 目录中执行 deploy.bat 就可以把 GitBook 生成的网页发布到网上了
等待几秒后，cmd窗口会自动关闭。

del /Q * 删除目录下的所有文件
rd /S /Q gitbook 删除 gitbook 目录及其所有子目录和文件
call cmd 在当前窗口运行第三方程序，运行完后继续往下执行
start cmd 会打开新窗口运行第三方程序

参考：
详解Gitbook制作精美电子书 - 云+社区 - 腾讯云
 GitBook 入门 | 公孙二狗
 GitBook 使用 Coding.net 的 Pages 访问 | 公孙二狗
 GitBook 从懵逼到入门 - 卢小喵的学习笔记 - CSDN博客
 gitbook 入门 - ＜/script＞ - 博客园

兔子昂