在滴滴云DC2上基于Gitbook+Nginx构建轻量级文档管理服务

介绍

工作中经常会遇到团队文档如何管理的问题，Atlassian之类的太复杂，很多时候并没有成千上万级别的文档需要管理，可能只有几百篇的文章需要管理，今天在滴滴云上给大家演示一下如何快速搭建一个轻量级的文档管理服务。

准备工作

在滴滴云上申请一个DC2服务器:滴滴云

进入DC2服务器

ssh dc2-user@117.51.159.217

安装Node.js

wget http://nodejs.org/dist/v9.0.0/node-v9.0.0.tar.gz
tar zxvf node-v9.0.0.tar.gz
cd node-v9.0.0/
./configure
sudo make
sudo make install

查看Node.js是否安装成功

node -v
v9.0.0

安装Gitbook

npm install gitbook-cli -g

Gitbook初始化

gitbook --version

创建电子书项目

mkdir test_book
cd test_book
gitbook init

创建好的项目目录中包含以下项目

README.md SUMMARY.md

1. SUMMARY.md，电子书目录文件。子章节，使用Tab缩进实现（最多支持三级标题）。

 # Summary

 * [test_book](README.md)
 * [文档1](utility/wendang1.md)
         * [文档1.1](utility/wendang1-1.md)
         * [文档1.2](utility/wendang1-2.md)
         * [文档1.3](utility/wendang1-3.md)
 * [文档2](wendang2.md)
 * [文档3](wendang3.md)
 * [文档4](zhishiku/wendang4.md)
     * [文档4.1](zhishiku/wendang4-1.md)
     * [文档4.2](zhishiku/wendang4-2.md)
     * [文档4.3](zhishiku/wendang4-3.md)

构建

1. 生成html文件，保存到_book目录。

gitbook build

2. 启动Gitbook。

gitbook serve ./

3. 通过http://127.0.0.1:4000就可以访问创建的Gitbook啦。
   

引入Nginx

实际工作中，我们很多服务都是配在Nginx里，Nginx的负载均衡、权限控制等功能能够很好的和Gitbook配合起来。

这里，以一个简单的静态页面服务进行嵌入说明。

Nginx配置

    server {
        listen       80 ;
        #listen       80 default_server;
        #listen       [::]:80 default_server;
        server_name  _;
        #root         /usr/share/nginx/html;
        root         /var/www/sdn_gitbook_html;

        # Load configuration files for the default server block.
        include /etc/nginx/default.d/*.conf;

        location / {
        }

        error_page 404 /404.html;
            location = /40x.html {
        }

        error_page 500 502 503 504 /50x.html;
            location = /50x.html {
        }
    }

其中sdn_gitbook_html是_book目录的软链，配置完成后，重启Nginx，我们就可以以80端口访问文档管理服务了。