使用gitbook 发布一个教程文档网站

gitbook是一个好用的发布电子书的项目；使用gitbook 能够在本地写好文档再远程推送到库；也能够在gitbook提供的在线平台上制做电子书；要想在本身的服务器上使用gitbook 发布一个网站；则须要相应的运行环境。本文是经过gitbook editor 软件写好电子书的项目；而后经过WinSCP上传到服务器；再经过gitbook serve 解析MarkDown文档，监听本地4000端口实现的。

一、运行环境：

LINUX； CentOS平台 ； nodejs；npm；

二、安装配置：

配置很简单；安装nodejs：

yum install nodejs

npm 是nodejs自带的包管理工具；使用yum安装 nodejs 默认安装npm；

三、安装gitbook：

使用命令  （全局安装）

npm install -g gitbook-cli  

四、初始化：

gitbook init

会在默认安装gitbook的文件夹初始化一个项目；包含一个README.md 和 SUMMARY.md 两个文件。 默认状况下在这个目录新建文档便可；也能够将写好的整个项目上传到服务器；最后使用gitbok解析便可；咱们选择后者；

五、解析新项目：

新项目上传到服务器后；找到项目路径：

cd /usr/share/nginx/gitbook

新项目的名称位于gitbook文件夹下；名称为javascript;

gitbook serve javascript

运行结果：

默认 监听本地的4000端口；可使用服务器的ip（公网ip）访问这个项目；gitboo会解析Markdown文档；并返回html页面。

由于http默认协议使用的是80端口；使用默认的url连接是没法访问的；必需要在后面加上端口号；相似于  http://localhost:4000/；   很是很差看； 可是咱们能够经过web服务器Nginx、 Apache；开启端口转发。将80端口的请求转发到4000端口。