Mercurial > hg > nginx-site
diff xml/ru/docs/http/ngx_http_proxy_module.xml @ 271:4c6d2c614d2c
Cleaned up XML tag mess:
- all of <parameter> and <code>, and some of <dirname>, <value>,
and <command> were replaced by <literal>;
- the rest of <dirname> were replaced by links;
- <argument> were replaced by <value>;
- <value> is now rendered in HTML in italic;
- <literal> and <path> can now contain <value>.
Cleaned up terminology mess:
- directives take "parameters".
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Fri, 23 Dec 2011 17:29:59 +0000 |
parents | c78b2d6fe261 |
children | 44ab4026d9f5 |
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml +++ b/xml/ru/docs/http/ngx_http_proxy_module.xml @@ -49,7 +49,7 @@ location / { <directive name="proxy_buffering"> -<syntax><value>on|off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http, server, location</context> @@ -72,7 +72,7 @@ location / { <directive name="proxy_buffers"> -<syntax><value>число размер</value></syntax> +<syntax><value>число</value> <value>размер</value></syntax> <default>8 4k/8k</default> <context>http, server, location</context> @@ -87,7 +87,7 @@ location / { <directive name="proxy_cache"> -<syntax><value>[зона|off]</value></syntax> +<syntax><value>зона</value> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context> @@ -102,7 +102,7 @@ location / { <directive name="proxy_cache_bypass"> -<syntax><value>строка [...]</value></syntax> +<syntax><value>строка</value> ...</syntax> <default/> <context>http, server, location</context> @@ -140,8 +140,12 @@ proxy_cache_key $scheme$proxy_host$uri$ <directive name="proxy_cache_path"> -<syntax><value>путь [levels=уровни] -keys_zone=название:размер [inactive=время] [max_size=размер]</value></syntax> +<syntax> + <value>путь</value> + [<literal>levels</literal>=<value>уровни</value>] + <literal>keys_zone</literal>=<value>название</value>:<value>размер</value> + [<literal>inactive</literal>=<value>время</value>] + [<literal>max_size</literal>=<value>размер</value>]</syntax> <default/> <context>http</context> @@ -201,8 +205,7 @@ inactive, то данные удаляются, независимо от их свежести. <directive name="proxy_cache_valid"> -<syntax><value>ответ [ответ ...] время</value> -</syntax> +<syntax><value>ответ</value> ... <value>время</value></syntax> <default/> <context>http, server, location</context> @@ -238,9 +241,18 @@ proxy_cache_valid any 1m; <directive name="proxy_cache_use_stale"> -<syntax><value>[error | timeout | invalid_header - | updating | http_500 | http_502 | http_503 | http_504 | http_404 | off] -[...]</value></syntax> +<syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>updating</literal> | + <literal>http_500</literal> | + <literal>http_502</literal> | + <literal>http_503</literal> | + <literal>http_504</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>off</default> <context>http, server, location</context> @@ -286,7 +298,7 @@ nginx не передаёт клиенту строки заголовка "Date", "Server", "X-Pad" и <directive name="proxy_ignore_client_abort"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context> @@ -299,7 +311,7 @@ nginx не передаёт клиенту строки заголовка "Date", "Server", "X-Pad" и <directive name="proxy_ignore_headers"> -<syntax><value>имя [имя ...]</value></syntax> +<syntax><value>имя</value> ...</syntax> <default/> <context>http, server, location</context> @@ -315,7 +327,7 @@ nginx не передаёт клиенту строки заголовка "Date", "Server", "X-Pad" и <directive name="proxy_intercept_errors"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context> @@ -329,9 +341,17 @@ nginx не передаёт клиенту строки заголовка "Date", "Server", "X-Pad" и <directive name="proxy_next_upstream"> -<syntax><value>[error | timeout | invalid_header - | http_500 | http_502 | http_503 | http_504 | http_404 | off] -[...]</value></syntax> +<syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>http_500</literal> | + <literal>http_502</literal> | + <literal>http_503</literal> | + <literal>http_504</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>error timeout</default> <context>http, server, location</context> @@ -391,7 +411,7 @@ off — запрещает передачу запроса следующему серверу; <directive name="proxy_no_cache"> -<syntax><value>строка [...]</value></syntax> +<syntax><value>строка</value> ...</syntax> <default/> <context>http, server, location</context> @@ -529,10 +549,9 @@ location /some/path/ { <directive name="proxy_redirect"> <syntax> - <value>default</value> | - <value>off</value> | - <argument>перенаправление замена</argument> -</syntax> + <literal>default</literal> | + <literal>off</literal> | + <value>перенаправление</value> <value>замена</value></syntax> <default>default</default> <context>http</context> <context>server</context> @@ -561,7 +580,7 @@ location /some/path/ { </para> <para> -Изменение по умолчанию, задаваемое значением <value>default</value>, использует +Изменение по умолчанию, задаваемое значением <literal>default</literal>, использует параметры директив <link doc="ngx_http_core_module.xml" id="location"/> и <link id="proxy_pass"/>. Поэтому две нижеприведённые конфигурации одинаковы: @@ -576,7 +595,7 @@ location /one/ { proxy_pass http://upstream:port/two/; proxy_redirect http://upstream:port/two/ /one/; </example> -Значение <value>default</value> недопустимо, если в <link id="proxy_pass"/> +Значение <literal>default</literal> недопустимо, если в <link id="proxy_pass"/> используются переменные. </para> @@ -596,11 +615,12 @@ location /one/ { <para> Директиву также можно задать (1.1.11) при помощи регулярных выражений. -При этом <argument>перенаправление</argument> должен начинаться либо с символа -“<code>~</code>”, если при сравнении следует учитывать регистр символов, -либо с символов “<code>~*</code>”, если регистр символов учитывать не нужно. +При этом <value>перенаправление</value> должно начинаться либо с символа +“<literal>~</literal>”, если при сравнении следует учитывать регистр символов, +либо с символов “<literal>~*</literal>”, если регистр символов учитывать +не нужно. Регулярное выражение может содержать именованные и позиционные выделения, -а <argument>замена</argument> на них ссылаться: +а <value>замена</value> ссылаться на них: <example> proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2; proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2; @@ -617,7 +637,8 @@ location /one/ { </para> <para> -Значение <value>off</value> запрещает все директивы <code>proxy_redirect</code> +Значение <literal>off</literal> запрещает все директивы +<literal>proxy_redirect</literal> на данном уровне: <example> proxy_redirect off; @@ -671,7 +692,7 @@ location /one/ { <directive name="proxy_set_header"> -<syntax><value>заголовок значение</value></syntax> +<syntax><value>заголовок</value> <value>значение</value></syntax> <default>Host $proxy_host</default> <default>Connection close</default> <context>http, server, location</context> @@ -725,7 +746,7 @@ proxy_set_header Accept-Encoding ""; <directive name="proxy_ssl_session_reuse"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http, server, location</context> @@ -740,7 +761,7 @@ proxy_set_header Accept-Encoding ""; <directive name="proxy_store"> -<syntax><value>on | off | строка </value></syntax> +<syntax><literal>on</literal> | <literal>off</literal> | <value>строка</value></syntax> <default>off</default> <context>http, server, location</context> @@ -817,8 +838,7 @@ location @fetch { <directive name="proxy_store_access"> -<syntax><value>пользователи:права [пользователи:права] -...</value></syntax> +<syntax><value>пользователи</value>:<value>права</value> ...</syntax> <default>user:rw</default> <context>http, server, location</context> @@ -841,8 +861,7 @@ proxy_store_access group:rw all:r; <directive name="proxy_temp_path"> -<syntax><value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ] -</value></syntax> +<syntax><value>путь</value> [<value>уровень1</value> [<value>уровень2</value> [<value>уровень3</value>]]]</syntax> <default>proxy_temp</default> <context>http, server, location</context>