docshome/nginx-docs

Nginx 中文文档. Chinese translation of Nginx documentation.

Nginx 中文文档

Nginx 官方文档中文翻译版，由本人在学习 nginx 时顺带翻译。因部分章节涉及到 Nginx Plus 或者其他内容，我将忽略该部分章节的内容。

文档前期翻译得比较粗糙，而且是基于旧版文档对照翻译，可能存在许多不当和错误之处，之后会慢慢修正和校对。

如果您发现内容存在错误或者不当之处，欢迎提出 issue 或 PR，期待您的加入：如何贡献。

在线阅读：Github | GitBook

安装

如果你没有安装 gitbook，则先使用 npm（或者 cnpm）安装 gitbook-cli：

npm install gitbook-cli -g

进入项目根目录，执行以下命令运行 gitbook：

安装依赖

gitbook install

启动本地服务器

gitbook serve

生成 HTML 文件，存放在 _book 目录下

gitbook build

更多操作命令，请参照 GitBook 命令。

项目状态

翻译中……

排版规范

本项目排版遵循 中文排版指南 规范。

LICENSE

本作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。

nginx-docs's Issues

proxy server 和 proxied server 的翻译容易混淆

原文

We will configure a basic proxy server, which serves requests of images with files from the local directory and sends all other requests to a proxied server.

译文（初学者指南 - 设置一个简单的代理服务器）

我们将配置一个基本的代理服务器，它为图片请求提供的文件来自本地目录，并将所有其它请求发送给代理的服务器。

在这里，proxy server 翻译为代理服务器，而 proxied server 翻译为代理的服务器，辨识度不高；另外，这一小节有的地方两者都翻译为代理服务器了，如果能加以区分我觉得更好一点。

代码高亮

```nginx

```

这样可以高亮 nginx 配置项，效果在下面查看

https://github.com/khs1994-website/nginx-docs/blob/master/introduction/%E9%85%8D%E7%BD%AEHTTPS%E6%9C%8D%E5%8A%A1%E5%99%A8.md

我稍后提交 PR

加油，坐等楼主翻译ngx_http_core_module

加油，坐等楼主翻译ngx_http_core_module

Publish by gitbook

改造为 Gitbook 格式
将目录写入 SUMMARY.md

After install, falling in gitbook build

Failed to load prism syntax: ngixn
{ Error: Cannot find module 'prismjs/components/prism-ngixn.js'
    at Function.Module._resolveFilename (module.js:470:15)
    at Function.Module._load (module.js:418:25)
    at Module.require (module.js:498:17)
    at require (internal/module.js:20:19)
    at requireSyntax (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:31:3)
    at Object.code (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:103:11)
    at Record.TemplateBlock.applyBlock (/root/.gitbook/versions/3.2.3/lib/models/templateBlock.js:205:23)
    at /root/.gitbook/versions/3.2.3/lib/output/getModifiers.js:56:33
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/highlightCode.js:47:24
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/editHTMLElement.js:11:16 code: 'MODULE_NOT_FOUND' }
Failed to load prism syntax: ngixn
{ Error: Cannot find module 'prismjs/components/prism-ngixn.js'
    at Function.Module._resolveFilename (module.js:470:15)
    at Function.Module._load (module.js:418:25)
    at Module.require (module.js:498:17)
    at require (internal/module.js:20:19)
    at requireSyntax (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:31:3)
    at Object.code (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:103:11)
    at Record.TemplateBlock.applyBlock (/root/.gitbook/versions/3.2.3/lib/models/templateBlock.js:205:23)
    at /root/.gitbook/versions/3.2.3/lib/output/getModifiers.js:56:33
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/highlightCode.js:47:24
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/editHTMLElement.js:11:16 code: 'MODULE_NOT_FOUND' }
Failed to load prism syntax: ngixn
{ Error: Cannot find module 'prismjs/components/prism-ngixn.js'
    at Function.Module._resolveFilename (module.js:470:15)
    at Function.Module._load (module.js:418:25)
    at Module.require (module.js:498:17)
    at require (internal/module.js:20:19)
    at requireSyntax (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:31:3)
    at Object.code (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:103:11)
    at Record.TemplateBlock.applyBlock (/root/.gitbook/versions/3.2.3/lib/models/templateBlock.js:205:23)
    at /root/.gitbook/versions/3.2.3/lib/output/getModifiers.js:56:33
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/highlightCode.js:47:24
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/editHTMLElement.js:11:16 code: 'MODULE_NOT_FOUND' }
Failed to load prism syntax: ngixn
{ Error: Cannot find module 'prismjs/components/prism-ngixn.js'
    at Function.Module._resolveFilename (module.js:470:15)
    at Function.Module._load (module.js:418:25)
    at Module.require (module.js:498:17)
    at require (internal/module.js:20:19)
    at requireSyntax (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:31:3)
    at Object.code (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:103:11)
    at Record.TemplateBlock.applyBlock (/root/.gitbook/versions/3.2.3/lib/models/templateBlock.js:205:23)
    at /root/.gitbook/versions/3.2.3/lib/output/getModifiers.js:56:33
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/highlightCode.js:47:24
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/editHTMLElement.js:11:16 code: 'MODULE_NOT_FOUND' }
Failed to load prism syntax: pm
{ Error: Cannot find module 'prismjs/components/prism-pm.js'
    at Function.Module._resolveFilename (module.js:470:15)
    at Function.Module._load (module.js:418:25)
    at Module.require (module.js:498:17)
    at require (internal/module.js:20:19)
    at requireSyntax (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:31:3)
    at Object.code (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:103:11)
    at Record.TemplateBlock.applyBlock (/root/.gitbook/versions/3.2.3/lib/models/templateBlock.js:205:23)
    at /root/.gitbook/versions/3.2.3/lib/output/getModifiers.js:56:33
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/highlightCode.js:47:24
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/editHTMLElement.js:11:16 code: 'MODULE_NOT_FOUND' }
Failed to load prism syntax: pm
{ Error: Cannot find module 'prismjs/components/prism-pm.js'
    at Function.Module._resolveFilename (module.js:470:15)
    at Function.Module._load (module.js:418:25)
    at Module.require (module.js:498:17)
    at require (internal/module.js:20:19)
    at requireSyntax (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:31:3)
    at Object.code (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:103:11)
    at Record.TemplateBlock.applyBlock (/root/.gitbook/versions/3.2.3/lib/models/templateBlock.js:205:23)
    at /root/.gitbook/versions/3.2.3/lib/output/getModifiers.js:56:33
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/highlightCode.js:47:24
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/editHTMLElement.js:11:16 code: 'MODULE_NOT_FOUND' }
Failed to load prism syntax: pm
{ Error: Cannot find module 'prismjs/components/prism-pm.js'
    at Function.Module._resolveFilename (module.js:470:15)
    at Function.Module._load (module.js:418:25)
    at Module.require (module.js:498:17)
    at require (internal/module.js:20:19)
    at requireSyntax (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:31:3)
    at Object.code (/home/jackdon/git_repos/nginx-docs/node_modules/gitbook-plugin-prism/index.js:103:11)
    at Record.TemplateBlock.applyBlock (/root/.gitbook/versions/3.2.3/lib/models/templateBlock.js:205:23)
    at /root/.gitbook/versions/3.2.3/lib/output/getModifiers.js:56:33
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/highlightCode.js:47:24
    at /root/.gitbook/versions/3.2.3/lib/output/modifiers/editHTMLElement.js:11:16 code: 'MODULE_NOT_FOUND' }

缺少了一个重要模块

http://nginx.org/en/docs/http/ngx_http_proxy_module.html

ngx_http_core_module 缺失 types 指令的介绍

官网中含有 http://nginx.org/en/docs/http/ngx_http_core_module.html#types 的介绍，您这里文章目录中是存在的，但实际上内容中不包含。

如何能够赞助你

你弄的这个Nginx中文文档意义很大，想给你赞助下，支持你的工作