2019-06-12-build-docs-gl

layout	title	subtitle	date	author	tags
post	docs.gl 搭建过程	日有所得	2019-06-12	cj	opengl docs.gl nginx

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 救场。

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

4. 尝试运行：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

   再次刷新网页，可以正常浏览、搜索了。
5. 一直开着 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 搞定。
6. server.log 有问题。虽然生成了文件，但是是 root 用户的，而且大小一直是0。手动 chown 给 www-data 用户，依然如故。猜测是用户权限或 python 的标准输出有问题？今天很困，抽空研究研究。