docs.gl 搭建过程

最近在学习 OpenGL，如 docs.gl 作者所言：

The actual documentation website provided by Khronos is in frames and poorly formatted, difficult to navigate and search.

官方文档确实难看啊，幸好有 docs.gl 救场。

cd /var/www/data && sudo git clone https://github.com/BSVino/docs.gl
sudo python build.py --full，生成 htdocs 文件夹存放了所有网站内容。由于生成的网页都不带 html 后缀名，直接使用 ngxin 站点，打开链接无法浏览，会下载文件。。因此使用 ngxin 代理到 docs.gl 提供的 server.py 简单 python 网站服务。

使用 nginx 代理，配置如下：

 server {
     listen 80;
     server_name gl.doc.********.com;

     location / {
         proxy_pass http://localhost:8001;
         proxy_set_header X-Real-IP $remote_addr;
         proxy_set_header Host $host;
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
     }

 }

尝试运行：cd htdocs && sudo python ../server.py，打开浏览器可以看到内容，但一些链接没法点，也不能搜索。看 python 输出，提示：

 127.0.0.1 - - [12/Jun/2019 14:59:28] "GET /htdocs/jquery-bonsai/jquery.bonsai.js HTTP/1.0" 404 -
 127.0.0.1 - - [12/Jun/2019 14:59:28] code 404, message File not found
 127.0.0.1 - - [12/Jun/2019 14:59:28] "GET /htdocs/jquery-bonsai/jquery.bonsai.css HTTP/1.0" 404 -
 127.0.0.1 - - [12/Jun/2019 14:59:28] code 404, message File not found
 127.0.0.1 - - [12/Jun/2019 14:59:28] "GET /htdocs/jquery-cookie/jquery.cookie.js HTTP/1.0" 404 -
 127.0.0.1 - - [12/Jun/2019 14:59:28] code 404, message File not found

一堆404。。。手动下载吧：

 sudo rm -rf jquery-bonsai
 sudo git clone https://github.com/aexmachina/jquery-bonsai jquery-bonsai
 cd jquery-cookie
 sudo wget https://github.com/carhartl/jquery-cookie/blob/master/src/jquery.cookie.js?raw=true -O jquery.cookie.js

再次刷新网页，可以正常浏览、搜索了。

一直开着 putty 也不是事，加个 supervisor 配置 gldocs.conf：

 [program:gldoc]
 process_name=%(program_name)s
 directory=/var/www/docs.gl/htdocs
 command=python /var/www/docs.gl/server.py
 autostart=true
 autorestart=true
 user=www-data
 redirect_strerr=true
 stdout_logfile=/var/www/docs.gl/server.log

sudo supervisorctl update 搞定。

server.log 有问题。虽然生成了文件，但是是 root 用户的，而且大小一直是0。手动 chown 给 www-data 用户，依然如故。猜测是用户权限或 python 的标准输出有问题？今天很困，抽空研究研究。

docs.gl 搭建过程

日有所得

docs.gl 搭建过程

FEATURED TAGS

FRIENDS