一、Gitbook部署

GitBook 是一个基于 Node 开发的命令行工具，所以需要先安装nodejs，再使用 npm 来安装 gitbook。

1.安装Node环境

从官网 https://nodejs.org/#download 下载Node.js安装包，是一个msi文件。
运行node-v8.11.1-x64.msi，按步骤next，直到安装完成。
完装完成后，在开始菜单有Node.js这个应用。
可以运行uninstall node.js卸载Node。
2.测试node是否安装成功

这里用三种方式测试node环境，选其一就可以。
1）在命令行运行node -v
2）在命令行运行js语句
输入命令：node
再输入：console.log("Hello,World!");

3）写一个js文件，通过node搭建一个网页

先在磁盘下建立一个app文件夹，app文件夹里面写一个test.js。
test.js代码如下：
var http = require("http");
http.createServer(function(req, res) {
res.writeHead( 200 , {"Content-Type":"text/html"});
res.write("<h1>Node.js</h1>");
res.write("<p>Hello World</p>");
}).listen(3000);
console.log("HTTP server is listening at port 3000.");
再从命令行进入app的文件夹，在命令窗口执行【node test.js】
然后在浏览器中输入网址http://127.0.0.1:3000。如果你正常访问了，那么就安装成功了。
3.gitbook 安装

在命令行输入下面命令
npm install -g gitbook-cli

NPM是随同NodeJS一起安装的包管理工具,安装node时npm也一并安装好了，可以通过输入 "npm -v" 来测试是否成功安装。
-cli表示全局安装Gitbook,可以在系统任何地方运行gitbook命令
卸载命令 npm uninstall -g gitbook 注：好像没起作用

4.检查gitbook是否安装

在命令行输入 gitbook -V 注意：V大写
目前GitBook version: 3.2.3

5.Gitbook使用

创建一个自己的书籍目录，例如mybook
在命令行窗口进入自己的目录mybook

然后输入命令：

gitbook init

之后目录中会自动生成 README.md 和 SUMMARY.md 两个文件。
这两个文件在 GitBook 项目中是必须存在的，其中 README.md 是对书籍的简单介绍，SUMMARY.md 是对书籍目录的描述，并且 GitBook 会通过该文件中的目录描述自动生成对应的目录和文件。

其中，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)

当你修改了 SUMMARY.md 文件中的内容后，你可以再次使用 gitbook init 来自动生成对应的目录和文件。

gitbook serve

书籍目录结构创建完成以后，我们就可以使用 gitbook serve 来编译和预览书籍了： gitbook serve 命令实际上会首先调用 gitbook build 编译书籍，完成以后会打开一个 web 服务器，监听在本地的 4000 端口。

C:\0-d\0-book\mybook>gitbook serve
Live reload server started on port: 35729
Press CTRL+C to quit ...
info: 7 plugins are installed
info: loading plugin "livereload"... OK
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 8 pages
info: found 7 asset files
info: >> generation finished with success in 0.7s !
Starting server ...
Serving book on http://localhost:4000
Starting server ...
Serving book on http://localhost:4000

之后，你就可以使用浏览器打开 http://127.0.0.1:4000 查看效果了。 localhost

gitbook部署参考地址
https://www.zybuluo.com/yangfch3/note/158290
https://segmentfault.com/a/1190000004482449

Markdown语法
http://wowubuntu.com/markdown/

DigitalPlatform / chord

Gitbook学习 #159