nginx-site: xml/ru/docs/http/ngx_http_core

comparison xml/ru/docs/http/ngx_http_core_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	945d7299c26c
children	457c54242cfa

comparison

equal deleted inserted replaced

-:945d7299c26c
+:4c6d2c614d2c
 <section id="directives" name="Директивы">
 <directive name="aio">
 <syntax>
-<value>on</value> |
+<literal>on</literal> |
-<value>off</value> |
+<literal>off</literal> |
-<value>sendfile</value></syntax>
+<literal>sendfile</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <appeared-in>0.8.11</appeared-in>
 </directive>
 <directive name="alias">
-<syntax><argument>путь</argument></syntax>
+<syntax><value>путь</value></syntax>
 <default/>
 <context>location</context>
 <para>
 Задаёт замену для указанного location'а.
 location /i/ {
 alias /data/w3/images/;
 }
 </example>
 на запрос
-“<code>/i/top.gif</code>” будет отдан файл
+“<literal>/i/top.gif</literal>” будет отдан файл
 <path>/data/w3/images/top.gif</path>.
 </para>
 <para>
-В значении аргумента <argument>путь</argument> можно использовать переменные,
+В значении параметра <value>путь</value> можно использовать переменные,
 кроме <var>$document_root</var> и <var>$realpath_root</var>.
 </para>
 <para>
-Если <code>alias</code> используется внутри location'а, заданного
+Если <literal>alias</literal> используется внутри location'а, заданного
 регулярным выражением, то регулярное выражение должно содержать
-выделения, а сам <code>alias</code> — ссылки на эти выделения
+выделения, а сам <literal>alias</literal> — ссылки на эти выделения
 (0.7.40), например:
 <example>
 location ~ ^/users/(.+\.(?:gif|jpe?g|png))$ {
 alias /data/w3/images/$1;
 }
 </directive>
 <directive name="chunked_transfer_encoding">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>on</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="client_body_buffer_size">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>8k|16k</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="client_body_in_file_only">
 <syntax>
-<value>on</value> |
+<literal>on</literal> |
-<value>clean</value> |
+<literal>clean</literal> |
-<value>off</value></syntax>
+<literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 модуля
 <link doc="ngx_http_perl_module.xml">ngx_http_perl_module</link>.
 </para>
 <para>
-При установке значения <value>on</value> временные файлы
+При установке значения <literal>on</literal> временные файлы
 по окончании обработки запроса не удаляются.
 </para>
 <para>
-Значение <value>clean</value> разрешает удалять временные файлы,
+Значение <literal>clean</literal> разрешает удалять временные файлы,
 оставшиеся по окончании обработки запроса.
 </para>
 </directive>
 <directive name="client_body_in_single_buffer">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="client_body_temp_path">
 <syntax>
-<argument>путь</argument>
+<value>путь</value>
-[<argument>уровень1</argument>
+[<value>уровень1</value>
-[<argument>уровень2</argument>
+[<value>уровень2</value>
-[<argument>уровень3</argument>]]]</syntax>
+[<value>уровень3</value>]]]</syntax>
 <default>client_body_temp</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="client_body_timeout">
-<syntax><argument>время</argument></syntax>
+<syntax><value>время</value></syntax>
 <default>60s</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="client_header_buffer_size">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>1k</default>
 <context>http</context>
 <context>server</context>
 <para>
 </directive>
 <directive name="client_header_timeout">
-<syntax><argument>время</argument></syntax>
+<syntax><value>время</value></syntax>
 <default>60s</default>
 <context>http</context>
 <context>server</context>
 <para>
 </directive>
 <directive name="client_max_body_size">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>1m</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 Если размер больше заданного, то клиенту возвращается ошибка
 <http-status code="413" text="Request Entity Too Large"/>.
 Следует иметь в виду, что
 <!--link doc="/web/upload.xml"-->браузеры не умеют корректно показывать
 эту ошибку<!--/link-->.
-Установка аргумента <argument>размер</argument> в 0 отключает
+Установка параметра <value>размер</value> в 0 отключает
 проверку размера тела запроса клиента.
 </para>
 </directive>
 <directive name="connection_pool_size">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>256</default>
 <context>http</context>
 <context>server</context>
 <para>
 </directive>
 <directive name="default_type">
-<syntax><argument>mime-тип</argument></syntax>
+<syntax><value>mime-тип</value></syntax>
 <default>text/plain</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="directio">
-<syntax><argument>размер</argument> | <value>off</value></syntax>
+<syntax><value>размер</value> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <appeared-in>0.7.7</appeared-in>
 </directive>
 <directive name="directio_alignment">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>512</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <appeared-in>0.8.11</appeared-in>
 </directive>
 <directive name="error_page">
 <syntax>
-<argument>код</argument> ...
+<value>код</value> ...
-[<value>=</value>[<argument>ответ</argument>]]
+[<literal>=</literal>[<value>ответ</value>]]
-<argument>uri</argument></syntax>
+<value>uri</value></syntax>
 <default/>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <context>if в location</context>
 <para>
 Задаёт URI, который будет показываться для указанных ошибок.
-Директивы <code>error_page</code> наследуются с предыдущего уровня при условии,
+Директивы <literal>error_page</literal> наследуются с предыдущего уровня
-что на данном уровне не описаны свои директивы
+при условии, что на данном уровне не описаны свои директивы
-<code>error_page</code>.
+<literal>error_page</literal>.
 В значении URI можно использовать переменные.
 </para>
 <para>
 Пример:
 </directive>
 <directive name="if_modified_since">
 <syntax>
-<value>off</value> |
+<literal>off</literal> |
-<value>exact</value> |
+<literal>exact</literal> |
-<value>before</value></syntax>
+<literal>before</literal></syntax>
 <default>exact</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <appeared-in>0.7.24</appeared-in>
 <header>If-Modified-Since</header>
 заголовка запроса:
 <list type="tag">
-<tag-name><value>off</value></tag-name>
+<tag-name><literal>off</literal></tag-name>
 <tag-desc>
 не проверять поле
 <header>If-Modified-Since</header> заголовка запроса (0.7.34);
 </tag-desc>
-<tag-name><value>exact</value></tag-name>
+<tag-name><literal>exact</literal></tag-name>
 <tag-desc>
 точное совпадение;
 </tag-desc>
-<tag-name><value>before</value></tag-name>
+<tag-name><literal>before</literal></tag-name>
 <tag-desc>
 время модификации ответа меньше или равно времени, заданному в поле
 <header>If-Modified-Since</header> заголовка запроса.
 </tag-desc>
 </directive>
 <directive name="ignore_invalid_headers">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>on</default>
 <context>http</context>
 <context>server</context>
 <para>
 запросы, перенаправленные директивой <link id="error_page"/>;
 </listitem>
 <listitem>
 подзапросы, формируемые командой
-<command>include virtual</command>
+“<command>include virtual</command>”
 модуля
 <link doc="ngx_http_ssi_module.xml">ngx_http_ssi_module</link>;
 ngx_http_ssi_module;
 </listitem>
 </directive>
 <directive name="keepalive_disable">
-<syntax><value>none</value> | <argument>браузер</argument> ...</syntax>
+<syntax><literal>none</literal> | <value>браузер</value> ...</syntax>
 <default>msie6 safari</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <para>
 Запрещает keep-alive соединения с некорректно ведущими себя браузерами.
-Аргументы <argument>браузер</argument> указывают, на какие браузеры это
+Параметры <value>браузер</value> указывают, на какие браузеры это
 распространяется.
-Значение <value>msie6</value> запрещает keep-alive соединения
+Значение <literal>msie6</literal> запрещает keep-alive соединения
 со старыми версиями MSIE после получения запроса POST.
-Значение <value>safari</value> запрещает keep-alive соединения
+Значение <literal>safari</literal> запрещает keep-alive соединения
 с браузерами Safari.
-Значение <value>none</value> разрешает keep-alive соединения
+Значение <literal>none</literal> разрешает keep-alive соединения
 со всеми браузерами.
 </para>
 </directive>
 <directive name="keepalive_requests">
-<syntax><argument>число</argument></syntax>
+<syntax><value>число</value></syntax>
 <default>100</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <appeared-in>0.8.0</appeared-in>
 </directive>
 <directive name="keepalive_timeout">
 <syntax>
-<argument>таймаут</argument>
+<value>таймаут</value>
-[<argument>заголовок_таймаута</argument>]</syntax>
+[<value>заголовок_таймаута</value>]</syntax>
 <default>75s</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <para>
-Первый аргумент задаёт таймаут, в течение которого keep-alive
+Первый параметр задаёт таймаут, в течение которого keep-alive
 соединение с клиентом не будет закрыто со стороны сервера.
 Второй необязательный параметр задаёт значение в поле
-<header>Keep-Alive: timeout=<argument>время</argument></header>
+<header>Keep-Alive: timeout=<value>время</value></header>
 заголовка ответа.
-Два аргумента могут отличаться друг от друга.
+Два параметра могут отличаться друг от друга.
 </para>
 <para>
 Поле
-<header>Keep-Alive: timeout=<argument>время</argument></header>
+<header>Keep-Alive: timeout=<value>время</value></header>
 заголовка понимают Mozilla и Konqueror.
 MSIE сам закрывает keep-alive соединение примерно через 60 секунд.
 </para>
 </directive>
 <directive name="large_client_header_buffers">
-<syntax><argument>число</argument> <argument>размер</argument></syntax>
+<syntax><value>число</value> <value>размер</value></syntax>
 <default>4 8k</default>
 <context>http</context>
 <context>server</context>
 <para>
-Задаёт максимальное <argument>число</argument> и <argument>размер</argument>
+Задаёт максимальное <value>число</value> и <value>размер</value>
 буферов для чтения большого заголовка запроса клиента.
 Строка запроса не должна превышать размера одного буфера, иначе клиенту
 возвращается ошибка
 <http-status code="414" text="Request-URI Too Large"/>.
 Поле заголовка запроса также не должно превышать размера одного буфера,
 </directive>
 <directive name="limit_except">
-<syntax block="yes"><argument>метод</argument> ...</syntax>
+<syntax block="yes"><value>метод</value> ...</syntax>
 <default/>
 <context>location</context>
 <para>
 Ограничивает HTTP-методы, доступные внутри location.
-Аргумент <argument>метод</argument> может быть одним из
+Параметр <value>метод</value> может быть одним из
-<value>GET</value>,
+<literal>GET</literal>,
-<value>HEAD</value>,
+<literal>HEAD</literal>,
-<value>POST</value>,
+<literal>POST</literal>,
-<value>PUT</value>,
+<literal>PUT</literal>,
-<value>DELETE</value>,
+<literal>DELETE</literal>,
-<value>MKCOL</value>,
+<literal>MKCOL</literal>,
-<value>COPY</value>,
+<literal>COPY</literal>,
-<value>MOVE</value>,
+<literal>MOVE</literal>,
-<value>OPTIONS</value>,
+<literal>OPTIONS</literal>,
-<value>PROPFIND</value>,
+<literal>PROPFIND</literal>,
-<value>PROPPATCH</value>,
+<literal>PROPPATCH</literal>,
-<value>LOCK</value>,
+<literal>LOCK</literal>,
-<value>UNLOCK</value>
+<literal>UNLOCK</literal>
 или
-<value>PATCH</value>.
+<literal>PATCH</literal>.
-Если разрешён метод <value>GET</value>, то метод
+Если разрешён метод <literal>GET</literal>, то метод
-<value>HEAD</value> также будет разрешён.
+<literal>HEAD</literal> также будет разрешён.
 Доступ к остальным методам может быть ограничен при помощи директив модулей
 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>
 и
 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>:
 <example>
 </directive>
 <directive name="limit_rate">
-<syntax><argument>скорость</argument></syntax>
+<syntax><value>скорость</value></syntax>
 <default>0</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <context>if в location</context>
 выше заданного ограничения.
 </para>
 <para>
 Если необходимо ограничить скорость для части клиентов на уровне
-<link id="server">сервера</link>, то директива <code>limit_rate</code>
+<link id="server">сервера</link>, то директива <literal>limit_rate</literal>
 для этого не подходит.
 Вместо этого следует задать желаемое ограничение скорости в переменной
 <var>$limit_rate</var>:
 <example>
 server {
 </directive>
 <directive name="limit_rate_after">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>0</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <context>if в location</context>
 </directive>
 <directive name="lingering_close">
-<syntax><value>off</value> | <value>on</value> | <value>always</value></syntax>
+<syntax>
+<literal>off</literal> |
+<literal>on</literal> |
+<literal>always</literal></syntax>
 <default>on</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <appeared-in>1.1.0</appeared-in>
 <para>
 Управляет закрытием соединений с клиентами.
 </para>
 <para>
-Со значение по умолчанию “<value>on</value>” nginx будет
+Со значением по умолчанию “<literal>on</literal>” nginx будет
 <link id="lingering_timeout">ждать</link> и
 <link id="lingering_time">обрабатывать</link> дополнительные данные,
 поступающие от клиента, перед полным закрытием соединения, но только
 если эвристика указывает на то, что клиент может ещё послать данные.
 </para>
 <para>
-Со значением “<value>always</value>” nginx всегда будет
+Со значением “<literal>always</literal>” nginx всегда будет
 ждать и обрабатывать дополнительные данные, поступающие от клиента.
 </para>
 <para>
-Со значением “<value>off</value>” nginx не будет ждать поступления
+Со значением “<literal>off</literal>” nginx не будет ждать поступления
 дополнительных данных и сразу же закроет соединение.
 Это нарушает протокол, поэтому не следует это использовать без нужды.
 </para>
 </directive>
 <directive name="lingering_time">
-<syntax><argument>время</argument></syntax>
+<syntax><value>время</value></syntax>
 <default>30s</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="lingering_timeout">
-<syntax><argument>время</argument></syntax>
+<syntax><value>время</value></syntax>
 <default>5s</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="listen">
 <syntax>
-<argument>адрес</argument>[:<argument>порт</argument>]
+<value>адрес</value>[:<value>порт</value>]
-[<parameter>default_server</parameter>]
+[<literal>default_server</literal>]
-[<parameter>setfib</parameter>=<argument>число</argument>]
+[<literal>setfib</literal>=<value>число</value>]
-[<parameter>backlog</parameter>=<argument>число</argument>]
+[<literal>backlog</literal>=<value>число</value>]
-[<parameter>rcvbuf</parameter>=<argument>размер</argument>]
+[<literal>rcvbuf</literal>=<value>размер</value>]
-[<parameter>sndbuf</parameter>=<argument>размер</argument>]
+[<literal>sndbuf</literal>=<value>размер</value>]
-[<parameter>accept_filter</parameter>=<argument>фильтр</argument>]
+[<literal>accept_filter</literal>=<value>фильтр</value>]
-[<parameter>deferred</parameter>]
+[<literal>deferred</literal>]
-[<parameter>bind</parameter>]
+[<literal>bind</literal>]
-[<parameter>ipv6only</parameter>=<value>on</value>|<value>off</value>]
+[<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
-[<parameter>ssl</parameter>]
+[<literal>ssl</literal>]
-[<parameter>so_keepalive</parameter>=<value>on</value>|<value>off</value>|[<argument>keepidle</argument>]:[<argument>keepintvl</argument>]:[<argument>keepcnt</argument>]]</syntax>
+[<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
 <syntax>
-<argument>порт</argument>
+<value>порт</value>
-[<parameter>default_server</parameter>]
+[<literal>default_server</literal>]
-[<parameter>setfib</parameter>=<argument>число</argument>]
+[<literal>setfib</literal>=<value>число</value>]
-[<parameter>backlog</parameter>=<argument>число</argument>]
+[<literal>backlog</literal>=<value>число</value>]
-[<parameter>rcvbuf</parameter>=<argument>размер</argument>]
+[<literal>rcvbuf</literal>=<value>размер</value>]
-[<parameter>sndbuf</parameter>=<argument>размер</argument>]
+[<literal>sndbuf</literal>=<value>размер</value>]
-[<parameter>accept_filter</parameter>=<argument>фильтр</argument>]
+[<literal>accept_filter</literal>=<value>фильтр</value>]
-[<parameter>deferred</parameter>]
+[<literal>deferred</literal>]
-[<parameter>bind</parameter>]
+[<literal>bind</literal>]
-[<parameter>ipv6only</parameter>=<value>on</value>|<value>off</value>]
+[<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
-[<parameter>ssl</parameter>]
+[<literal>ssl</literal>]
-[<parameter>so_keepalive</parameter>=<value>on</value>|<value>off</value>|[<argument>keepidle</argument>]:[<argument>keepintvl</argument>]:[<argument>keepcnt</argument>]]</syntax>
+[<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
 <syntax>
-<value>unix:</value><argument>путь</argument>
+<literal>unix:</literal><value>путь</value>
-[<parameter>default_server</parameter>]
+[<literal>default_server</literal>]
-[<parameter>backlog</parameter>=<argument>число</argument>]
+[<literal>backlog</literal>=<value>число</value>]
-[<parameter>rcvbuf</parameter>=<argument>размер</argument>]
+[<literal>rcvbuf</literal>=<value>размер</value>]
-[<parameter>sndbuf</parameter>=<argument>размер</argument>]
+[<literal>sndbuf</literal>=<value>размер</value>]
-[<parameter>accept_filter</parameter>=<argument>фильтр</argument>]
+[<literal>accept_filter</literal>=<value>фильтр</value>]
-[<parameter>deferred</parameter>]
+[<literal>deferred</literal>]
-[<parameter>bind</parameter>]
+[<literal>bind</literal>]
-[<parameter>ssl</parameter>]
+[<literal>ssl</literal>]
-[<parameter>so_keepalive</parameter>=<value>on</value>|<value>off</value>|[<argument>keepidle</argument>]:[<argument>keepintvl</argument>]:[<argument>keepcnt</argument>]]</syntax>
+[<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
 <default>*:80 | *:8000</default>
 <context>server</context>
 <para>
-Задаёт <argument>адрес</argument> и <argument>порт</argument> для IP
+Задаёт <value>адрес</value> и <value>порт</value> для IP
-или <argument>путь</argument> для UNIX-сокета,
+или <value>путь</value> для UNIX-сокета,
 на которых сервер будет принимать запросы.
-Можно указать только <argument>адрес</argument>
+Можно указать только <value>адрес</value>
-или только <argument>порт</argument>.
+или только <value>порт</value>.
-Кроме того, <argument>адрес</argument> может быть именем хоста, например:
+Кроме того, <value>адрес</value> может быть именем хоста, например:
 <example>
 listen 127.0.0.1:8000;
 listen 127.0.0.1;
 listen 8000;
 listen *:8000;
 IPv6-адреса (0.7.36) задаются в квадратных скобках:
 <example>
 listen [::]:8000;
 listen [fe80::1];
 </example>
-UNIX-сокеты (0.8.21) задаются при помощи префикса “<code>unix:</code>”:
+UNIX-сокеты (0.8.21) задаются при помощи префикса “<literal>unix:</literal>”:
 <example>
 listen unix:/var/run/nginx.sock;
 </example>
 </para>
 <para>
-Если указан только <argument>адрес</argument>, то используется порт 80.
+Если указан только <value>адрес</value>, то используется порт 80.
 </para>
 <para>
-Если директива не указана, то используется либо <code>*:80</code>
+Если директива не указана, то используется либо <literal>*:80</literal>
 (если nginx работает с привилегиями суперпользователя),
-либо <code>*:8000</code>.
+либо <literal>*:8000</literal>.
 </para>
 <para>
-Если у директивы есть параметр <parameter>default_server</parameter>, то сервер,
+Если у директивы есть параметр <literal>default_server</literal>, то сервер,
 в котором описана эта директива, будет сервером по умолчанию для указанной пары
-<argument>адрес</argument>:<argument>порт</argument>.
+<value>адрес</value>:<value>порт</value>.
-Если же директив с параметром <parameter>default_server</parameter> нет, то
+Если же директив с параметром <literal>default_server</literal> нет, то
 сервером по умолчанию будет первый сервер, в котором описана пара
-<argument>адрес</argument>:<argument>порт</argument>.
+<value>адрес</value>:<value>порт</value>.
 адрес:порт.
 <note>
 До версии 0.8.21 этот параметр назывался просто
-<parameter>default</parameter>.
+<literal>default</literal>.
 </note>
 </para>
 <para>
-В директиве <code>listen</code> можно также указать несколько
+В директиве <literal>listen</literal> можно также указать несколько
 дополнительных параметров, специфичных для системных вызовов
 <c-func>listen</c-func> и <c-func>bind</c-func>.
-Эти параметры можно задать в любой директиве <code>listen</code>,
+Эти параметры можно задать в любой директиве <literal>listen</literal>,
 но только один раз для указанной пары
-<argument>адрес</argument>:<argument>порт</argument>.
+<value>адрес</value>:<value>порт</value>.
 <note>
 До версии 0.8.21 их можно было указывать лишь в директиве
-<code>listen</code> с параметром <parameter>default</parameter>.
+<literal>listen</literal> с параметром <literal>default</literal>.
 </note>
 <list type="tag">
 <tag-name>
-<parameter>setfib</parameter>=<argument>число</argument>
+<literal>setfib</literal>=<value>число</value>
 </tag-name>
 <tag-desc>
 этот параметр (0.8.44) задаёт для слушающего сокета соответствующую
 таблицу маршрутизации (FIB).
 В настоящий момент это работает только на FreeBSD.
 </tag-desc>
 <tag-name>
-<parameter>backlog</parameter>=<argument>число</argument>
+<literal>backlog</literal>=<value>число</value>
 </tag-name>
 <tag-desc>
-задаёт параметр <parameter>backlog</parameter> в вызове
+задаёт параметр <literal>backlog</literal> в вызове
 <c-func>listen</c-func>.
-По умолчанию <parameter>backlog</parameter> равен -1 для FreeBSD
+По умолчанию <literal>backlog</literal> равен -1 для FreeBSD
 и 511 для других платформ.
 </tag-desc>
 <tag-name>
-<parameter>rcvbuf</parameter>=<argument>размер</argument>
+<literal>rcvbuf</literal>=<value>размер</value>
 </tag-name>
 <tag-desc>
 задаёт параметр <c-def>SO_RCVBUF</c-def> для слушающего сокета
 </tag-desc>
 <tag-name>
-<parameter>sndbuf</parameter>=<argument>размер</argument>
+<literal>sndbuf</literal>=<value>размер</value>
 </tag-name>
 <tag-desc>
 задаёт параметр <c-def>SO_SNDBUF</c-def> для слушающего сокета
 </tag-desc>
 <tag-name>
-<parameter>accept_filter</parameter>=<argument>фильтр</argument>
+<literal>accept_filter</literal>=<value>фильтр</value>
 </tag-name>
 <tag-desc>
 задаёт название accept-фильтра.
 Работает только на FreeBSD, можно использовать два фильтра —
-<value>dataready</value> и <value>httpready</value>.
+<literal>dataready</literal> и <literal>httpready</literal>.
 По сигналу <c-def>SIGHUP</c-def> accept-фильтр можно менять только в
 последних версиях FreeBSD, начиная с 6.0, 5.4-STABLE и 4.11-STABLE.
 </tag-desc>
 <tag-name>
-<parameter>deferred</parameter>
+<literal>deferred</literal>
 </tag-name>
 <tag-desc>
 указывает использовать отложенный <c-func>accept</c-func> на Linux
 с помощью опции <c-def>TCP_DEFER_ACCEPT</c-def>.
 </tag-desc>
 <tag-name>
-<parameter>bind</parameter>
+<literal>bind</literal>
 </tag-name>
 <tag-desc>
 указывает, что для данной пары
-<argument>адрес</argument>:<argument>порт</argument> нужно делать
+<value>адрес</value>:<value>порт</value> нужно делать
 <c-func>bind</c-func> отдельно.
-Дело в том, что если описаны несколько директив <code>listen</code>
+Дело в том, что если описаны несколько директив <literal>listen</literal>
 с одинаковым портом, но разными адресами и одна из директив
-<code>listen</code> слушает на всех адресах для данного порта
+<literal>listen</literal> слушает на всех адресах для данного порта
-(<code>*</code>:<argument>порт</argument>, то nginx сделает
+(<literal>*:</literal><value>порт</value>, то nginx сделает
-<c-func>bind</c-func> только на <code>*</code>:<argument>порт</argument>.
+<c-func>bind</c-func> только на <literal>*:</literal><value>порт</value>.
 Необходимо заметить, что в этом случае для определения адреса, на которой
 пришло соединение, делается системный вызов <c-func>getsockname</c-func>.
-Если же используются параметры <parameter>backlog</parameter>,
+Если же используются параметры <literal>backlog</literal>,
-<parameter>rcvbuf</parameter>, <parameter>sndbuf</parameter>,
+<literal>rcvbuf</literal>, <literal>sndbuf</literal>,
-<parameter>accept_filter</parameter>, <parameter>deferred</parameter>
+<literal>accept_filter</literal>, <literal>deferred</literal>
-или <parameter>so_keepalive</parameter>, то для данной пары
+или <literal>so_keepalive</literal>, то для данной пары
-<argument>адрес</argument>:<argument>порт</argument> всегда делается
+<value>адрес</value>:<value>порт</value> всегда делается
 отдельный вызов <c-func>bind</c-func>.
 </tag-desc>
 <tag-name>
-<parameter>ipv6only</parameter>=<value>on</value>|<value>off</value>
+<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>
 </tag-name>
 <tag-desc>
 параметр (0.7.42) задаёт значение параметра <c-def>IPV6_V6ONLY</c-def>
 для слушающего сокета.
 Установить этот параметр можно только один раз на старте.
 </tag-desc>
 <tag-name>
-<parameter>ssl</parameter>
+<literal>ssl</literal>
 </tag-name>
 <tag-desc>
 этот параметр (0.7.14) не имеет отношения к системным вызовам
 <c-func>listen</c-func> и <c-func>bind</c-func>, а позволяет указать,
 что все соединения, принимаемые на этом порту, должны работать
 listen 443 default ssl;
 </example>
 </tag-desc>
 <tag-name>
-<parameter>so_keepalive</parameter>=<value>on</value>|<value>off</value>|[<argument>keepidle</argument>]:[<argument>keepintvl</argument>]:[<argument>keepcnt</argument>]
+<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]
 </tag-name>
 <tag-desc>
 этот параметр (1.1.11) конфигурирует для слушающего сокета
 поведение “TCP keepalive”.
 Если этот параметр опущен, то для сокета будут действовать
 стандартные системные настройки.
-Если он установлен в значение “<value>on</value>”, то для сокета
+Если он установлен в значение “<literal>on</literal>”, то для сокета
 включается опция <c-def>SO_KEEPALIVE</c-def>.
-Если он установлен в значение “<value>off</value>”, то для сокета
+Если он установлен в значение “<literal>off</literal>”, то для сокета
 опция <c-def>SO_KEEPALIVE</c-def> выключается.
 Некоторые операционные системы поддерживают настройку параметров
 “TCP keepalive” на уровне сокета посредством опций
 <c-def>TCP_KEEPIDLE</c-def>, <c-def>TCP_KEEPINTVL</c-def> и
 <c-def>TCP_KEEPCNT</c-def>.
 На таких системах (в настоящий момент это Linux 2.4+ и NetBSD 5+)
-их можно сконфигурировать с помощью аргументов <argument>keepidle</argument>,
+их можно сконфигурировать с помощью параметров <value>keepidle</value>,
-<argument>keepintvl</argument> и <argument>keepcnt</argument>.
+<value>keepintvl</value> и <value>keepcnt</value>.
-Один или два аргумента могут быть опущены, в таком случае для
+Один или два параметра могут быть опущены, в таком случае для
 соответствующей опции сокета будут действовать стандартные
 системные настройки.
 Например,
 <example>so_keepalive=30m::10</example>
 установит таймаут бездействия (<c-def>TCP_KEEPIDLE</c-def>) в 30 минут,
 </directive>
 <directive name="location">
 <syntax block="yes">[
-<value>=</value> |
+<literal>=</literal> |
-<value>~</value> |
+<literal>~</literal> |
-<value>~*</value> |
+<literal>~*</literal> |
-<value>^~</value>
+<literal>^~</literal>
-] <argument>uri</argument></syntax>
+] <value>uri</value></syntax>
-<syntax block="yes"><value>@</value><argument>имя</argument></syntax>
+<syntax block="yes"><literal>@</literal><value>имя</value></syntax>
 <default/>
 <context>server</context>
 <context>location</context>
 <para>
 Устанавливает конфигурацию в зависимости от URI запроса.
 location можно задать префиксной строкой или регулярным выражением.
-Регулярные выражения задаются либо с префиксом “<value>~*</value>”
+Регулярные выражения задаются либо с префиксом “<literal>~*</literal>”
 (для поиска совпадения без учёта регистра символов),
-либо с префиксом “<value>~</value>” (с учётом регистра).
+либо с префиксом “<literal>~</literal>” (с учётом регистра).
 Чтобы найти location, соответствующий запросу, вначале проверяются
 location'ы, заданные префиксными строками (префиксные location'ы).
 Среди них ищется максимальное совпадение.
 Затем проверяются регулярные выражения, в порядке их следования
 в конфигурационном файле.
 затем использоваться в других директивах.
 </para>
 <para>
 Если у максимального совпавшего префиксного location'а указан префикс
-“<value>^~</value>”, то регулярные выражения не проверяются.
+“<literal>^~</literal>”, то регулярные выражения не проверяются.
 </para>
 <para>
-Кроме того, с помощью префикса “<value>=</value>” можно задать точное
+Кроме того, с помощью префикса “<literal>=</literal>” можно задать точное
 совпадение URI и location.
 При точном совпадении поиск сразу же прекращается.
-Например, если запрос “<code>/</code>” случается часто, то
+Например, если запрос “<literal>/</literal>” случается часто, то
-указав “<code>location = /</code>”, можно ускорить обработку
+указав “<literal>location = /</literal>”, можно ускорить обработку
 этих запросов, так как поиск прекратится после первого же сравнения.
 Очевидно, что такой location не может иметь вложенные location'ы.
 </para>
 <para>
 <note>
 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным
-location'ом без префиксов “<value>=</value>” и “<value>^~</value>”,
+location'ом без префиксов “<literal>=</literal>” и “<literal>^~</literal>”,
 то поиск тоже сразу же прекращается и регулярные выражения также
 не проверяются.
 </note>
 </para>
 location ~* \.(gif|jpg|jpeg)$ {
 [ конфигурация Г ]
 }
 </example>
-Для запроса “<code>/</code>” будет выбрана конфигурация А,
+Для запроса “<literal>/</literal>” будет выбрана конфигурация А,
-для запроса “<code>/documents/document.html</code>” — конфигурация Б,
+для запроса “<literal>/documents/document.html</literal>” — конфигурация Б,
-для запроса “<code>/images/1.gif</code>” — конфигурация В,
+для запроса “<literal>/images/1.gif</literal>” — конфигурация В,
-а для запроса “<code>/documents/1.jpg</code>” — конфигурация Г.
+а для запроса “<literal>/documents/1.jpg</literal>” — конфигурация Г.
 </para>
 <para>
-Префикс “<value>@</value>” задаёт именованный location.
+Префикс “<literal>@</literal>” задаёт именованный location.
 Такой location не используется при обычной обработке запросов, а
 предназначен только для перенаправления в него запросов.
 Такие location'ы не могут быть вложенными и не могут содержать
 вложенные location'ы.
 </para>
 </directive>
 <directive name="log_not_found">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>on</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="log_subrequest">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="max_ranges">
-<syntax><argument>число</argument></syntax>
+<syntax><value>число</value></syntax>
 <default/>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="merge_slashes">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>on</default>
 <context>http</context>
 <context>server</context>
 <para>
 Разрешает или запрещает преобразование URI путём замены двух и более подряд
-идущих слэшей (“<code>/</code>”) в один.
+идущих слэшей (“<literal>/</literal>”) в один.
 </para>
 <para>
 Необходимо иметь ввиду, что это преобразование необходимо для корректной
 проверки префиксных строк и регулярных выражений.
-Если его не делать, то запрос “<code>//scripts/one.php</code>” не попадёт в
+Если его не делать, то запрос “<literal>//scripts/one.php</literal>” не попадёт в
 <example>
 location /scripts/ {
 ...
 }
 </example>
 и может быть обслужен как статический файл.
-Поэтому он преобразуется к виду “<code>/scripts/one.php</code>”.
+Поэтому он преобразуется к виду “<literal>/scripts/one.php</literal>”.
 </para>
 <para>
 Запрет преобразования может понадобиться, если в URI используются имена,
-закодированные методом base64, в котором задействован символ “<code>/</code>”.
+закодированные методом base64, в котором задействован символ
+“<literal>/</literal>”.
 Однако по соображениям безопасности лучше избегать отключения преобразования.
 </para>
 <para>
 Если директива указана на уровне
 </directive>
 <directive name="msie_padding">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>on</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="msie_refresh">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="open_file_cache">
-<syntax><value>off</value></syntax>
+<syntax><literal>off</literal></syntax>
 <syntax>
-<parameter>max</parameter>=<argument>N</argument>
+<literal>max</literal>=<value>N</value>
-[<parameter>inactive</parameter>=<argument>время</argument>]</syntax>
+[<literal>inactive</literal>=<value>время</value>]</syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <para>
 У директивы есть следующие параметры:
 <list type="tag">
 <tag-name>
-<parameter>max</parameter>
+<literal>max</literal>
 </tag-name>
 <tag-desc>
 задаёт максимальное число элементов в кэше;
 при переполнении кэша удаляются наиболее давно не используемые элементы (LRU);
 </tag-desc>
 <tag-name>
-<parameter>inactive</parameter>
+<literal>inactive</literal>
 </tag-name>
 <tag-desc>
 задаёт время, после которого элемент кэша удаляется, если к нему
 не было обращений в течение этого времени; по умолчанию 60 секунд;
 </tag-desc>
 <tag-name>
-<value>off</value>
+<literal>off</literal>
 </tag-name>
 <tag-desc>
 запрещает кэш.
 </tag-desc>
 </directive>
 <directive name="open_file_cache_errors">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <!--
 <directive name="open_file_cache_events">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 -->
 <directive name="open_file_cache_min_uses">
-<syntax><argument>число</argument></syntax>
+<syntax><value>число</value></syntax>
 <default>1</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <para>
-Задаёт минимальное <argument>число</argument> обращений к файлу
+Задаёт минимальное <value>число</value> обращений к файлу
-в течение времени, заданного параметром <parameter>inactive</parameter>
+в течение времени, заданного параметром <literal>inactive</literal>
 директивы <link id="open_file_cache"/>, после которого дескриптор
 файла будет оставаться открытым в кэше.
 </para>
 </directive>
 <directive name="open_file_cache_valid">
-<syntax><argument>время</argument></syntax>
+<syntax><value>время</value></syntax>
 <default>60s</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="optimize_server_names">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <para>
 </directive>
 <directive name="port_in_redirect">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>on</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="postpone_output">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>1460</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="read_ahead">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>0</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 Задаёт ядру размер предчтения при работе с файлами.
 </para>
 <para>
 На Linux используется системный вызов
-<code>posix_fadvise(0, 0, 0, POSIX_FADV_SEQUENTIAL)</code>,
+<literal>posix_fadvise(0, 0, 0, POSIX_FADV_SEQUENTIAL)</literal>,
-поэтому аргумент <argument>размер</argument> там игнорируется.
+поэтому параметр <value>размер</value> там игнорируется.
 </para>
 <para>
 На FreeBSD используется системный вызов
-<code>fcntl(O_READAHEAD,</code><argument>размер</argument><code>)</code>,
+<literal>fcntl(O_READAHEAD,
+</literal><value>размер</value><literal>)</literal>,
 появившийся во FreeBSD&nbsp;9.0-CURRENT.
 Для FreeBSD&nbsp;7 необходимо установить
 <link url="http://sysoev.ru/freebsd/patch.readahead.txt">патч</link>.
 </para>
 </directive>
 <directive name="recursive_error_pages">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="request_pool_size">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>4k</default>
 <context>http</context>
 <context>server</context>
 <para>
 </directive>
 <directive name="reset_timedout_connection">
 <syntax>
-<value>on</value> | <value>off</value></syntax>
+<literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="resolver">
 <syntax>
-<argument>адрес</argument> ...
+<value>адрес</value> ...
-[<parameter>valid</parameter>=<argument>время</argument>]</syntax>
+[<literal>valid</literal>=<value>время</value>]</syntax>
 <default/>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 Задаёт серверы DNS, используемые для преобразования имён апстрим серверов
 в адреса, например:
 <example>
 resolver 127.0.0.1 192.0.2.1;
 </example>
-Аргумент <argument>адрес</argument> может быть задан либо
+Параметр <value>адрес</value> может быть задан либо
 IPv4-адресом, либо именем хоста;
 во втором случае используется первый полученный IPv4-адрес.
 Серверы DNS опрашиваются циклически.
 <note>
 До версии 1.1.7 можно было задать лишь один DNS-сервер.
 </note>
 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
-Необязательный параметр <parameter>valid</parameter> позволяет это
+Необязательный параметр <literal>valid</literal> позволяет это
 переопределить:
 <example>
 resolver 127.0.0.1 192.0.2.1 valid=30s;
 </example>
 <note>
 </directive>
 <directive name="resolver_timeout">
-<syntax><argument>время</argument></syntax>
+<syntax><value>время</value></syntax>
 <default>30s</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="root">
-<syntax><argument>путь</argument></syntax>
+<syntax><value>путь</value></syntax>
 <default>html</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <context>if в location</context>
 <example>
 location /i/ {
 root /data/w3;
 }
 </example>
-в ответ на запрос “<code>/i/top.gif</code>” будет отдан файл
+в ответ на запрос “<literal>/i/top.gif</literal>” будет отдан файл
 <path>/data/w3/i/top.gif</path>.
 </para>
 <para>
-В значении аргумента <argument>путь</argument> можно использовать переменные,
+В значении параметра <value>путь</value> можно использовать переменные,
 кроме <var>$document_root</var> и <var>$realpath_root</var>.
 </para>
 <para>
 Путь к файлу формируется путём простого добавления URI к значению директивы
-<code>root</code>.
+<literal>root</literal>.
 Если же URI необходимо поменять, следует воспользоваться директивой
 <link id="alias"/>.
 </para>
 </directive>
 <directive name="satisfy">
-<syntax><value>all</value> | <value>any</value></syntax>
+<syntax><literal>all</literal> | <literal>any</literal></syntax>
 <default>all</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <para>
-Разрешает доступ, если оба (<value>all</value>)
+Разрешает доступ, если оба (<literal>all</literal>)
-или хотя бы один (<value>any</value>) из модулей
+или хотя бы один (<literal>any</literal>) из модулей
 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>
 и <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>
 разрешают доступ.
 </para>
 </directive>
 <directive name="satisfy_any">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="send_lowat">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>0</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="send_timeout">
-<syntax><argument>время</argument></syntax>
+<syntax><value>время</value></syntax>
 <default>60s</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="sendfile">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <context>if в location</context>
 </directive>
 <directive name="sendfile_max_chunk">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>0</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="server_name">
-<syntax><argument>имя</argument> ...</syntax>
+<syntax><value>имя</value> ...</syntax>
 <default>""</default>
 <context>server</context>
 <para>
 Задаёт имена виртуального сервера, например:
 </example>
 </para>
 <para>
 Первое имя становится основным именем сервера.
-В именах серверов можно использовать звёздочку (“<code>*</code>”)
+В именах серверов можно использовать звёздочку (“<literal>*</literal>”)
 для замены первой или последней части имени:
 <example>
 server {
 server_name example.com *.example.com www.example.*;
 }
 }
 </example>
 </para>
 <para>
-Если аргумент равен “<var>$hostname</var>” (0.9.4), то
+Если параметр равен “<var>$hostname</var>” (0.9.4), то
 подставляется имя хоста (hostname) машины.
 </para>
 <para>
 В качестве имени сервера можно также использовать регулярное выражение,
-указав перед ним тильду (“<code>~</code>”):
+указав перед ним тильду (“<literal>~</literal>”):
 <example>
 server {
 server_name www.example.com ~^www\d+\.example\.com$;
 }
 </example>
 <listitem>
 полные имена
 </listitem>
 <listitem>
-имена с маской в начале имени, например “<code>*.example.com</code>”
+имена с маской в начале имени, например “<literal>*.example.com</literal>”
 </listitem>
 <listitem>
-имена с маской в конце имени, например “<code>mail.*</code>”
+имена с маской в конце имени, например “<literal>mail.*</literal>”
 </listitem>
 <listitem>
 регулярные выражения
 </listitem>
 </directive>
 <directive name="server_name_in_redirect">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="server_names_hash_bucket_size">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>32|64|128</default>
 <context>http</context>
 <para>
 Задаёт размер корзины в хэш-таблицах имён серверов.
 </directive>
 <directive name="server_names_hash_max_size">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>512</default>
 <context>http</context>
 <para>
-Задаёт максимальный <argument>размер</argument> хэш-таблиц имён серверов.
+Задаёт максимальный <value>размер</value> хэш-таблиц имён серверов.
 Подробнее смотрите в документе по
 <link doc="../hash.xml">настройке хэшей</link>.
 </para>
 </directive>
 <directive name="server_tokens">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>on</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="tcp_nodelay">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>on</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="tcp_nopush">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="try_files">
 <syntax>
-<argument>файл</argument> ...
+<value>файл</value> ...
-<argument>uri</argument></syntax>
+<value>uri</value></syntax>
 <syntax>
-<argument>файл</argument> ...
+<value>файл</value> ...
-=<argument>код</argument></syntax>
+=<value>код</value></syntax>
 <default/>
 <context>server</context>
 <context>location</context>
 <para>
 Проверяет существование файлов в заданном порядке и использует
 для обработки запроса первый найденный файл, причём обработка
 делается в контексте этого же location'а.
-Путь к файлу строится из аргумента <argument>файл</argument>
+Путь к файлу строится из параметра <value>файл</value>
 в соответствии с директивами
 <link id="root"/> и <link id="alias"/>.
 С помощью слэша в конце имени можно проверить существование каталога,
-например, “<code>$uri/</code>”.
+например, “<literal>$uri/</literal>”.
 В случае, если ни один файл не найден, то делается внутреннее
-перенаправление на <argument>uri</argument>, заданный последним аргументом.
+перенаправление на <value>uri</value>, заданный последним параметром.
 Например:
 <example>
 location /images/ {
 try_files $uri /images/default.gif;
 }
 location = /images/default.gif {
 expires 30s;
 }
 </example>
-Последний аргумент может также указывать на именованный location,
+Последний параметр может также указывать на именованный location,
 смотрите примеры ниже.
-С версии 0.7.51 последний аргумент может также быть кодом:
+С версии 0.7.51 последний параметр может также быть кодом:
 <example>
 location / {
 try_files $uri $uri/index.html $uri.html =404;
 }
 </example>
 fastcgi_param QUERY_STRING    q=$uri&amp;$args;
 ... прочие fastcgi_param
 }
 </example>
-В следующем примере директива <code>try_files</code>
+В следующем примере директива <literal>try_files</literal>
 <example>
 location / {
 try_files $uri $uri/ @drupal;
 }
 </example>
 fastcgi_param SCRIPT_FILENAME /path/to$fastcgi_script_name;
 ...
 }
 </example>
-<code>try_files</code> проверяет существование PHP-файла,
+<literal>try_files</literal> проверяет существование PHP-файла,
 прежде чем передать запрос FastCGI-серверу.
 </para>
 <para>
 Пример использования вместе с Wordpress и Joomla:
 и находится в файле <path>conf/mime.types</path>.
 </para>
 <para>
 Для того, чтобы для определённого location'а для всех ответов
-выдавался MIME-тип “<code>application/octet-stream</code>”,
+выдавался MIME-тип “<literal>application/octet-stream</literal>”,
 можно использовать следующее:
 <example>
 location /download/ {
 types        { }
 default_type application/octet-stream;
 </directive>
 <directive name="types_hash_bucket_size">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>32|64|128</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 </directive>
 <directive name="types_hash_max_size">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>1024</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <para>
-Задаёт максимальный <argument>размер</argument> хэш-таблиц типов.
+Задаёт максимальный <value>размер</value> хэш-таблиц типов.
 Подробнее смотрите в документе по
 <link doc="../hash.xml">настройке хэшей</link>.
 </para>
 </directive>
 <directive name="underscores_in_headers">
-<syntax><value>on</value> | <value>off</value></syntax>
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
 <para>
 </directive>
 <directive name="variables_hash_bucket_size">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>64</default>
 <context>http</context>
 <para>
 Задаёт размер корзины в хэш-таблице переменных.
 </directive>
 <directive name="variables_hash_max_size">
-<syntax><argument>размер</argument></syntax>
+<syntax><value>размер</value></syntax>
 <default>512</default>
 <context>http</context>
 <para>
-Задаёт максимальный <argument>размер</argument> хэш-таблицы переменных.
+Задаёт максимальный <value>размер</value> хэш-таблицы переменных.
 Подробнее смотрите в документе по
 <link doc="../hash.xml">настройке хэшей</link>.
 </para>
 </directive>
 </section>
 <section id="variables" name="Встроенные переменные">
 <para>
-Модуль <code>ngx_http_core_module</code> поддерживает встроенные переменные,
+Модуль <literal>ngx_http_core_module</literal> поддерживает встроенные переменные,
 имена которых совпадают с именами переменных веб-сервера Apache.
 Прежде всего, это переменные, представляющие из себя поля заголовка
 запроса клиента, такие как <var>$http_user_agent</var>, <var>$http_cookie</var>
 и тому подобное.
 Кроме того, есть и другие переменные:
 <list type="tag">
-<tag-name><var>$arg_</var><argument>имя</argument></tag-name>
+<tag-name><var>$arg_</var><value>имя</value></tag-name>
 <tag-desc>
-аргумент <argument>имя</argument> в строке запроса
+аргумент <value>имя</value> в строке запроса
 </tag-desc>
 <tag-name><var>$args</var></tag-name>
 <tag-desc>
 аргументы в строке запроса
 <tag-name><var>$content_type</var></tag-name>
 <tag-desc>
 поле <header>Content-Type</header> заголовка запроса
 </tag-desc>
-<tag-name><var>$cookie_</var><argument>имя</argument></tag-name>
+<tag-name><var>$cookie_</var><value>имя</value></tag-name>
 <tag-desc>
-cookie <argument>имя</argument>
+cookie <value>имя</value>
 </tag-desc>
 <tag-name><var>$document_root</var></tag-name>
 <tag-desc>
 значение директивы <link id="root"/> для текущего запроса
 <tag-name><var>$hostname</var></tag-name>
 <tag-desc>
 имя хоста
 </tag-desc>
-<tag-name><var>$http_</var><argument>имя</argument></tag-name>
+<tag-name><var>$http_</var><value>имя</value></tag-name>
 <tag-desc>
-поле <argument>имя</argument> заголовка запроса
+поле <value>имя</value> заголовка запроса
 </tag-desc>
 <tag-name><var>$https</var></tag-name>
 <tag-desc>
-“<code>on</code>”
+“<literal>on</literal>”
 если соединение работает в режиме SSL,
 либо пустая строка
 </tag-desc>
 <tag-name><var>$is_args</var></tag-name>
 <tag-desc>
-“<code>?</code>”, если в строке запроса есть аргументы,
+“<literal>?</literal>”, если в строке запроса есть аргументы,
 и пустая строка, если их нет
 </tag-desc>
 <tag-name><var>$limit_rate</var></tag-name>
 <tag-desc>
 </para>
 </tag-desc>
 <tag-name><var>$request_completion</var></tag-name>
 <tag-desc>
-“<code>OK</code>” если запрос завершился,
+“<literal>OK</literal>” если запрос завершился,
 либо пустая строка
 </tag-desc>
 <tag-name><var>$request_filename</var></tag-name>
 <tag-desc>
 </tag-desc>
 <tag-name><var>$request_method</var></tag-name>
 <tag-desc>
 метод запроса, обычно
-“<code>GET</code>” или “<code>POST</code>”
+“<literal>GET</literal>” или “<literal>POST</literal>”
 </tag-desc>
 <tag-name><var>$request_uri</var></tag-name>
 <tag-desc>
 оригинальный URI запроса целиком (с аргументами)
 </tag-desc>
 <tag-name><var>$scheme</var></tag-name>
 <tag-desc>
-схема запроса, “<code>http</code>” или “<code>https</code>”
+схема запроса, “<literal>http</literal>” или “<literal>https</literal>”
 </tag-desc>
-<tag-name><var>$sent_http_</var><argument>имя</argument></tag-name>
+<tag-name><var>$sent_http_</var><value>имя</value></tag-name>
 <tag-desc>
-поле <argument>имя</argument> заголовка ответа
+поле <value>имя</value> заголовка ответа
 </tag-desc>
 <tag-name><var>$server_addr</var></tag-name>
 <tag-desc>
 адрес сервера, принявшего запрос
 <para>
 Получение значения этой переменной обычно требует одного системного вызова.
 Чтобы избежать системного вызова, в директивах <link id="listen"/>
-следует указывать адреса и использовать параметр <parameter>bind</parameter>.
+следует указывать адреса и использовать параметр <literal>bind</literal>.
 </para>
 </tag-desc>
 <tag-name><var>$server_name</var></tag-name>
 <tag-desc>
 </tag-desc>
 <tag-name><var>$server_protocol</var></tag-name>
 <tag-desc>
 протокол сервера, обычно
-“<code>HTTP/1.0</code>”
+“<literal>HTTP/1.0</literal>”
 или
-“<code>HTTP/1.1</code>”
+“<literal>HTTP/1.1</literal>”
 </tag-desc>
 <tag-name><var>$uri</var></tag-name>
 <tag-desc>
 текущий URI запроса

Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_core_module.xml @ 271:4c6d2c614d2c