GitBook的安装/使用和阿里云服务器部署GitBook

版权声明：本文为博主原创文章，未经博主允许不得转载。 https://blog.csdn.net/zhuming3834/article/details/78427321

关于GitBook–百度百科，可以看百度或者官网–GitBook。

安装GitBook

安装GitBook其实很简单，前提是你的机器已经有了Node.js环境。下面介绍了Mac和Ubuntu安装Node.js
《Mac下安装Node.js、测试、输出json》
和《Ubuntu 安装Node.js、Express和MySQL》。这里有安装Node.js的介绍。
全局安装：npm install gitbook-cli -g。这个执行完毕之后，gitbook -v可以查看到gitbook版本，就表示安装成功。

使用GitBook

gitbook init //初始化目录文件
gitbook help //列出gitbook所有的命令
gitbook --help //输出gitbook-cli的帮助信息
gitbook build //生成静态网页
gitbook serve //生成静态网页并运行服务器
gitbook build --gitbook=2.0.1 //生成时指定gitbook的版本, 本地没有会先下载
gitbook ls //列出本地所有的gitbook版本
gitbook ls-remote //列出远程可用的gitbook版本
gitbook fetch 标签/版本号 //安装对应的gitbook版本
gitbook update //更新到gitbook的最新版本
gitbook uninstall 2.0.1 //卸载对应的gitbook版本
gitbook build --log=debug //指定log的级别
gitbook builid --debug //输出错误信息

基本也就是上线的操作命令，常用的就是前面的6个了。
在执行完gitbook init后，会给自动生成一个模板，剩下的就是修改模板为你自己的文章了。
gitbook serve这个可以在本地生成预览。本地启动http://localhost:4000即可预览。
当然写文章不只是为了自己看，需要分享出去，这里就需要gitbook build了，执行完gitbook build之后，目录下面会生成一个_book这里就是生成的静态网页资源，里面有个index.html，这个是网站的入口。

阿里云服务器部署GitBook

想在阿里云服务器上面部署GitBook，前提是你的阿里云服务器已经安装了GitBook。其他服务器也是同样情况。
上面说了gitbook build之后，目录下面会生成一个_book这里就是生成的静态网页资源，里面有个index.html，这个是网站的入口。在这个之前先看看《Nginx部署静态网页》。我用GitBook生成的书也是用Nginx部署的。
在/etc/nginx/sites-enabled的目录下面，新建一个.conf格式的文件api_gitbook.conf。文件里面的代码如下：

server {
      listen 4000;
      server_name localhost;
      location / {
           root /home/apibook/_book;
           index index.html;
           try_files $uri $uri/ =404;
      }
}

然后重启ngixn：service nginx reload。
这样我们就可以远程访问使用GitBook制作的书了,前提是你的服务器的安全组开放了4000端口。
比如：http://阿里云服务器IP地址:4000