diff --git a/xml/cn/docs/http/ngx_http_charset_module.xml b/xml/cn/docs/http/ngx_http_charset_module.xml
deleted file mode 100644
index 686ae43..0000000
--- a/xml/cn/docs/http/ngx_http_charset_module.xml
+++ /dev/null
@@ -1,210 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-ngx_http_charset_module模块为响应头的Content-Type添加指定的字符集。
-
-此外,这个模块可以把数据从一个字符集转换为另一个字符集,但也有以下限制:
-
-
-
-只能单向转换,即从服务端到客户端,
-
-
-
-只有单字节字符集能被转换
-
-
-
-或者单字节字符集和UTF-8之间的互相转换。
-
-
-
-
-
-
-
-
-
-
-
-
-include conf/koi-win;
-
-charset windows-1251;
-source_charset koi8-r;
-
-
-
-
-
-
-
-
-
-charset | off
-off
-http
-server
-location
-if in location
-
-
-为响应头的Content-Type添加指定的字符集。
-如果这个字符集和指令设置的字符集不同,就会进行转换。
-
-
-
-参数off 表明不在响应头的Content-Type中添加字符集。
-
-
-
-字符集可以当作变量来定义:
-
-charset $charset;
-
-这种情况下,一个变量所有可能的值,至少使用
- , 或者
- 指令中的一种来配置。
-对于 utf-8, windows-1251, 和
-koi8-r 字符集,在配置中包含
-conf/koi-win, conf/koi-utf, 和
-conf/win-utf这些文件就足够了。
-对于其他字符集,简单地做一个虚构转换表就可以了,
-比如:
-
-charset_map iso-8859-5 _ { }
-
-
-
-
-此外,字符集也可以在响应头的
-X-Accel-Charset中设置。
-这个功能可以使用
-
-和
-
-指令来禁用。
-
-
-
-
-
-
-charset1charset2
-
-http
-
-
-描述了从一个字符集到另一个字符集的转换表。
-反向转换表使用相同的数据来构建。
-字符代码用十六进制表示。
-在80-FF范围内不能表示的字符使用 “?”替换。
-当把UTF-8转换为其他字符集时, 单字节字符集中不能表示的字符使用 “&#XXXX;”来替换。
-
-
-
-示例:
-
-charset_map koi8-r windows-1251 {
- C0 FE ; # small yu
- C1 E0 ; # small a
- C2 E1 ; # small b
- C3 F6 ; # small ts
- ...
-}
-
-
-
-
-当描述一个UTF-8的转换表时,UTF-8的字符集代码应该放在第二列,比如:
-
-charset_map koi8-r utf-8 {
- C0 D18E ; # small yu
- C1 D0B0 ; # small a
- C2 D0B1 ; # small b
- C3 D186 ; # small ts
- ...
-}
-
-
-
-
-发行文件conf/koi-win,
-conf/koi-utf, and conf/win-utf中已经提供了从koi8-r到
-windows-1251,从koi8-r到utf-8,以及从
-windows-1251到utf-8的完整转换表。
-
-
-
-
-
-
-mime-type ...
-text/html text/xml text/plain text/vnd.wap.wml
-application/x-javascript application/rss+xml
-http
-server
-location
-0.7.9
-
-
-使模块在响应时能处理除了“text/html”之外其他指定的MIME类型。
-特殊值“*” 匹配任意的MIME类型(0.8.29)。
-
-
-
-
-
-
-on | off
-off
-http
-server
-location
-if in location
-
-
-对于接收到的代理服务器或者FastCGI服务器的响应头中Content-Type已经带有字符集的情况,确定是否进行字符集转换。
-如果开启转换,接收到的响应中指定的字符集会被当作原始字符集。
-
-需要注意的是,如果在子请求中接收到的应答,始终会将应答的字符集转换为主请求的字符集,无论override_charset
-指令是否开启。
-
-
-
-
-
-
-
-charset
-
-http
-server
-location
-if in location
-
-
-定义响应中的原始字符集。
-如果这个字符集和指令设置字符集的不同,就会进行转换。
-
-
-
-
-
-
-
diff --git a/xml/cn/docs/http/ngx_http_headers_module.xml b/xml/cn/docs/http/ngx_http_headers_module.xml
index 27ed671..27822ab 100644
--- a/xml/cn/docs/http/ngx_http_headers_module.xml
+++ b/xml/cn/docs/http/ngx_http_headers_module.xml
@@ -8,16 +8,17 @@
-The ngx_http_headers_module module allows to emit
-the Expires and Cache-Control header
-fields, and to add arbitrary fields to a response header.
+ngx_http_headers_module 模块允许发出
+ Expires 和 Cache-Control
+响应头,并将任意域添加到响应头。
@@ -50,9 +51,8 @@ add_header Cache-Control private;
location
-Adds the specified field to a response header provided that
-the response code equals 200, 204, 206, 301, 302, 303, 304, or 307.
-A value can contain variables.
+当响应代码等于200, 204, 206, 301, 302, 303, 304, 或者307,增加指定域到响应头。
+值中可以包含变量。
@@ -70,58 +70,57 @@ A value can contain variables.
location
-Enables or disables adding or modifying the Expires
-and Cache-Control response header fields.
-A parameter can be a positive or negative
+启用或禁用增加或者修改 Expires
+和 Cache-Control 响应头。
+参数正负均可。
time.
-A time in the Expires field is computed as a sum of the
-current time and time specified in the directive.
-If the modified parameter is used (0.7.0, 0.6.32)
-then time is computed as a sum of the file’s modification time and
-time specified in the directive.
+Expires 域里的时间可以由当前时间
+time 和指令里指定的时间求和来算出。
+如果使用了 modified (参数0.7.0, 0.6.32),
+那么时间由文件修改时间和
+time 指令里的指定时间来算出。
-In addition, it is possible to specify a time of the day using
-the “@” prefix (0.7.9, 0.6.34):
+除此之外,可以使用前缀(0.7.9, 0.6.34)
+“@” :来指定一天的时间。
expires @15h30m;
-The epoch parameter corresponds to the absolute time
+epoch 参数对应于绝对时间
“Thu, 01 Jan 1970 00:00:01 GMT”.
-The contents of the Cache-Control field depends
-on the sign of the specified time:
+Cache-Control
+域的内容取决于指定时间的正负符号:
-time is negative — Cache-Control: no-cache.
+时间是负的 — Cache-Control: no-cache.
-time is positive or zero —
+时间是正的或者是0-
Cache-Control: max-age=t,
-where t is a time specified in the directive, in seconds.
+ t 是在指令中指定的时间,以秒计。
-The max parameter sets Expires
-to the value “Thu, 31 Dec 2037 23:55:55 GMT”,
-and Cache-Control to 10 years.
+max 参数设置 Expires
+值为 “Thu, 31 Dec 2037 23:55:55 GMT”,
+并将Cache-Control 设置为10年。
-The off parameter disables adding or modifying the
-Expires and Cache-Control response
-header fields.
+off 参数禁止增加或者修改
+Expires 和Cache-Control 响应头域。
diff --git a/xml/cn/docs/http/ngx_http_memcached_module.xml b/xml/cn/docs/http/ngx_http_memcached_module.xml
index 6973e5e..b3a424f 100644
--- a/xml/cn/docs/http/ngx_http_memcached_module.xml
+++ b/xml/cn/docs/http/ngx_http_memcached_module.xml
@@ -8,18 +8,16 @@
-The ngx_http_memcached_module module allows to obtain
-responses from a memcached server.
-The key is set in the $memcached_key variable.
-A response should be put in memcached in advance via means that are
-external to nginx.
+ngx_http_memcached_module 模块允许从一个memcached服务器获取响应。
+键在变量$memcached_key 中来设置。响应应经由nginx的外部方法提前放入memcached。
@@ -56,9 +54,9 @@ server {
location
-Sets size of the buffer used for reading a response
-received from the memcached server.
-A response is passed to a client synchronously, immediately as it is received.
+设置用来接收memcached服务器的响应的读缓存
+ size 大小。
+响应一经收到,就立刻同步传送给客户端。
@@ -72,8 +70,8 @@ A response is passed to a client synchronously, immediately as it is received.
location
-Defines a timeout for establishing a connection with the memcached server.
-It should be noted that this timeout cannot usually exceed 75 seconds.
+设置一个与memcached服务器建立连接的超时时间。
+应当注意的是这个超时时间一般不能超过75秒。
@@ -88,10 +86,9 @@ It should be noted that this timeout cannot usually exceed 75 seconds.
1.3.6
-Enables the test for the flag presence in the memcached
-server response and sets the request header field
-“Content-Encoding” to “gzip”
-if the flag is set.
+开启测试memcatched服务器响应是否出现flag标志,
+并且标志出现时,设置
+“Content-Encoding” 响应头为 “gzip”。
@@ -111,34 +108,30 @@ if the flag is set.
location
-Specifies in which cases a request should be passed to the next server:
+指定在何种情况下,请求应当传送给下一个服务器。
error
-an error occurred while establishing a connection with the
-server, passing it a request, or reading the response header;
+在建立连接、发送请求或者读取响应头时出现了错误;timeout
-a timeout has occurred while establishing a connection with the
-server, passing it a request, or reading the response header;
+在建立连接、发送请求或者读取响应头时出现了超时;invalid_response
-a server returned empty or invalid response;
+服务器返回一个空的或者无效的响应;not_found
-a response was not found on the server;
+服务器返回内容不存在响应;off
-disables passing a request to the next server.
+禁止将请求传递给下一个服务器。
-It should be understood that passing a request to the next server is
-only possible if a client was not sent anything yet.
-That is, if an error or a timeout occurs in the middle of
-transferring a response, fixing this is impossible.
+应当认识到,仅当nginx还没有发送任何响应数据到客户端的时候,才能将请求传送给下一个服务器。
+就是说,传输响应期间发生错误或者超时,问题不可修复。
@@ -151,19 +144,17 @@ transferring a response, fixing this is impossible.
if in location
-Sets an address of the memcached server.
-An address can be specified as a domain name or an address, and a port,
-for example,
+设置memcached服务器的地址。
+地址可以指定为一个域名,也可以是地址和端口的组合,例如:
memcached_pass localhost:11211;
-If a domain name resolves to several addresses, all of them will be
-used in a round-robin fashion.
-In addition, an address can be specified as a
-server group.
+如果域名解析后对应多个地址,那么采用round-robin的方法来选择地址。
+除此之外,服务器也可以被指定为
+服务器组.
@@ -177,11 +168,9 @@ In addition, an address can be specified as a
location
-Defines a timeout for reading a response from the memcached server.
-A timeout is only set between two successive read operations,
-not for the transmission of the whole response.
-If a memcached server does not transmit anything within this time,
-a connection is closed.
+定义从memcached服务器读取响应的超时时间。
+这不是整个响应传输时间的超时,而只是两次读操作之间的超时。
+如果memcached服务器在此期间不传输任何数据,那么连接将会关闭。
@@ -195,11 +184,9 @@ a connection is closed.
location
-Sets a timeout for transmitting a request to the memcached server.
-A timeout is only set between two successive write operations,
-not for the transmission of the whole request.
-If a memcached server does not receive anything within this time,
-a connection is closed.
+为传输一个请求到memcached服务器设置一个超时时间。
+这不是整个请求传输时间的超时,而只是两次写操作之间的超时。
+如果memcached服务器在此期间不传输任何数据,那么连接将会关闭。
diff --git a/xml/cn/docs/http/ngx_http_xslt_module.xml b/xml/cn/docs/http/ngx_http_xslt_module.xml
index 74734c1..f055342 100644
--- a/xml/cn/docs/http/ngx_http_xslt_module.xml
+++ b/xml/cn/docs/http/ngx_http_xslt_module.xml
@@ -8,25 +8,25 @@
-The ngx_http_xslt_module (0.7.8+) is a filter
-that transforms XML responses using one or more XSLT stylesheets.
+ngx_http_xslt_module (0.7.8+) 是一个filter模块,它使用一个或多个XSLT样式表来转换XML响应。
-This module is not built by default, it should be enabled with the
+此模块不是默认编译的,因此需要指定
--with-http_xslt_module
-configuration parameter.
+编译选项。
-This module requires the
-libxml2 and
-libxslt libraries.
+此模块需要
+libxml2 和
+libxslt 库。
@@ -58,13 +58,11 @@ location / {
location
-Specifies the DTD file that declares character entities.
-This file is compiled during the configuration stage.
-For technical reasons the module is unable to use the
-external subset declared in the processed XML, so it is
-ignored and instead a specially defined file is used.
-This file should not describe the XML structure, it is
-enough to only declare the required character entities, for example:
+指定DTD文件声明字符实体。
+此文件在配置阶段编译。
+由于技术原因,模块不能使用处理的XML中声明的外部子集,因而它忽略这些子集并使用专门的文件来定义。
+这个文件仅能描述需要的字符实体,而不应该使用它来描述XML结构,比如:
+
<!ENTITY nbsp " ">
@@ -82,19 +80,17 @@ enough to only declare the required character entities, for example:
1.1.18
-Defines parameters for XSLT stylesheets.
-The value is treated as an XPath expression.
-The value can contain variables.
-To pass a string value to a stylesheet,
-the directive can be used.
+定义一个XSLT样式表参数。
+value 值被视为一个XPath表达式。
+value 值可以包含变量。
+可以使用指令 来传递一个字符串值给样式表。
-There could be several xslt_param directives.
-These directives are inherited from the previous level if and
-only if there are no
-xslt_param and
-directives defined on the current level.
+可以有多个 xslt_param 指令。
+当且仅当在当前块级别中没有定义
+xslt_param 和
+指令时,才能继承上层级别的设置。
@@ -109,17 +105,16 @@ directives defined on the current level.
1.1.18
-Defines string parameters for XSLT stylesheets.
-XPath expressions in the value are not interpreted.
-The value can contain variables.
+为XSLT样式表定义一个字符串参数。
+nginx不解析 value 中包含的XPath表达式。
+ value 值可以包含变量。
-There could be several xslt_string_param directives.
-These directives are inherited from the previous level if and
-only if there are no
- and xslt_string_param
-directives defined on the current level.
+可以有多个xslt_string_param 指令。
+当且仅当在当前块级别中没有定义
+ 和 xslt_string_param
+指令时,才能继承上层级别的设置。
@@ -133,26 +128,24 @@ directives defined on the current level.
location
-Defines the XSLT stylesheet and its optional parameters.
-A stylesheet is compiled during the configuration stage.
+定义一个XSLT样式表和它的可选参数。
+样式表在配置阶段编译。
-Parameters can either be specified separately, or grouped in a
-single line using the “:” delimiter.
-If a parameter includes the “:” character,
-it should be escaped as “%3A”.
-Also, libxslt requires to enclose parameters
-that contain non-alphanumeric characters into single or double quotes,
-for example:
+参数既可以单独指定,也可以写在一行,并使用分隔符
+ “:” 来分隔。
+如果一个参数包含了“:” 字符,
+它应该被转义为 “%3A”。
+并且libxslt
+需要将非字母数字的参数包括在单引号或双引号中。例如:
param1='http%3A//www.example.com':param2=value2
-The description of parameters can contain variables, for example,
-the whole line of parameters can be taken from a single variable:
+可以使用变量来描述参数,例如,可以用一个变量来指定整行参数。
location / {
xslt_stylesheet /site/xslt/one.xslt
@@ -164,8 +157,7 @@ location / {
-It is possible to specify several stylesheets; in this case they
-will be applied sequentially in the specified order.
+可以指定多个样式表;在这种情况下,它们将按配置中指定的顺序来生效。
@@ -179,11 +171,9 @@ will be applied sequentially in the specified order.
location
-Enables transformations in responses with the specified MIME types
-in addition to “text/xml”.
-The special value “*” matches any MIME type (0.8.29).
-If the result of transformation is an HTML response, its MIME type
-is changes to “text/html”.
+除了“text/xml”类型,启用指定的MIME类型的转换响应。
+特殊值“*”匹配任何MIME类型(0.8.29)。
+如果转换的结果是HTML响应,它的MIME类型就变为“text/html”