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
中设置。 -这个功能可以使用 - -和 - -指令来禁用。 -
- -
- - - -charset1 charset2 - -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-rutf-8,以及从 -windows-1251utf-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 "&#xa0;"> @@ -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