当年跟着H哥时,使用gitbook作为文档工具.

维护一个文档项目,提交到gitlab,做好配置后,会将markdown自动重新构建为新的页面.


搭建gitbook



该步骤相对较简单,无甚好写.可参考

搭建gitbook 和 访问权限认证 &和git仓库(github或者公司的gitlab)关联




利用nginx添加 权限认证


像公司内部文档,不希望对外公开,但也不想局限于仅内网可访问. 可利用nginx的认证模块,实现简单的账号密码登陆.


安装 mini-httpd


1
sudo apt-get install mini-httpd

而后执行

sudo htpasswd -bc conf/domains/随意设置一个文件名称如cuishuang 你想要设置的登陆账号 你想设置的登陆密码


如下:

1
2
3
4
5
6
7
location / {
root /home/ubuntu/gitbook/_book;
index index.html;
auth_basic "爽哥提示:请输入账号和密码";
auth_basic_user_file cuishuang; #nginx认证文件目录,即上文中设置的文件的绝对或相对路径
try_files $uri $uri/ =404;
}


最终的conf文件如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
server {
listen 80;
server_name gitbook.dashen.tech; #server_name不要加http或https

access_log /var/log/gitbook.access.log main;
error_log /var/log/gitbook.error.log;

location / {
root /home/ubuntu/gitbook/_book;
index index.html;
auth_basic "爽哥提示:请输入账号和密码";
auth_basic_user_file cuishuang; #nginx认证文件目录,即上文中设置的文件的绝对或相对路径
try_files $uri $uri/ =404;
}

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

}


重启nginx, 然后访问.


输入正确的用户名和密码后,即可进入并正常使用