ubuntu如何将 nginx 文档本地化(离线安装 nginx 文档)

Posted 2021-01-15 zhaodianle

nginx 是搭建网站、邮件服务器和负载均衡的一大利器，目前已经有越来越多的人使用 Nginx 来作为自己网站的web 服务器，学习 nginx 是一个非常有必要的事情。

 

目前很多人是在内网工作的，单位的环境不支持直接连接外网，那么除了买本 nginx 相关书籍的书呢，只能找一台能上网的电脑或者手机4G 来看外网的 nginx 文档，非常不方便。

如果把 nginx 文档本地话，那么内网环境，也随时能够查看 nginx 文档了。

 

nginx 文档并未随着 nginx 的代码放在一起，让刚开始找文档的我很是懵圈，不知道文档放在哪里了。而且 nginx 采用 mercurial 来管理代码，我对 mercurial 又不熟悉，找来找去，也未找到 nginx 文档。

 

找了很久才发现，nginx文档，放在了 nginx.org 上面，注意，这个 nging.org，一来是 nginx 文档网站，二来，也是文档所在工程的项目名称，位置在：http://hg.nginx.org/nginx.org/

 

有了文档位置，那接下来的，就是 clone 到本地，然后编译，然后就可以作为本地化的选项了。

编译方法：

1. 首先先make 尝试一下，发现 Makefile 运行报错了。我的错误主要有以下问题：

(1)  xsltproc命令不存在，sudo apt-get install xsltproc 命令安装即可解决

(2) xslscript.pl找不到，直接 hg clone  http://hg.nginx.org/xslscript,然后导入 xslscript.pl 所在位置的环境变量

(3) Parse-RecDescent模块找不到，好嘛，这个可费老劲了，先是装了 ActivePerl，位置在这里http://docs.activestate.com/activeperl/5.26/?_ga=2.188255528.1629131404.1540639477-2140667414.1540639477

然后使用 ppm 安装 Parse-RecDescent，这样才完成，注意导入 ActivePerl 所在位置的环境变量，否则找不到 ppm 命令。使用 ppm install Parse-RecDescent 来安装模块

 

都解决后，就可以编译了，make 运行

 

html 文档输出位置在libxslt 文档下面，然后就可以搭建服务器，用作内网的文档了。

http://docsant.com 也同样保留了一份 nginx 的文档，后续网站还会收录更多工程项目的文档。