Mercurial > hg > nginx-site
changeset 303:1c239146beb4
Revision.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Sat, 31 Dec 2011 14:49:04 +0000 |
parents | df728215db07 |
children | 3824ca9f1f72 |
files | xml/ru/docs/http/ngx_http_access_module.xml xml/ru/docs/http/ngx_http_addition_module.xml xml/ru/docs/http/ngx_http_auth_basic_module.xml xml/ru/docs/http/ngx_http_autoindex_module.xml xml/ru/docs/http/ngx_http_browser_module.xml |
diffstat | 5 files changed, 164 insertions(+), 118 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_access_module.xml +++ b/xml/ru/docs/http/ngx_http_access_module.xml @@ -2,7 +2,7 @@ <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> -<module name="Директивы модуля ngx_http_access_module" +<module name="Модуль ngx_http_access_module" link="/ru/docs/http/ngx_http_access_module.html" lang="ru"> @@ -10,30 +10,31 @@ <section id="summary"> <para> -Модуль ngx_http_access_module позволяет закрыть доступ для определённых -IP-адресов клиентов. +Модуль <literal>ngx_http_access_module</literal> позволяет +закрыть доступ для определённых IP-адресов клиентов. </para> </section> -<section name="Пример конфигурации" id="example"> +<section id="example" name="Пример конфигурации"> <para> <example> - location / { - deny 192.168.1.1; - allow 192.168.1.0/24; - allow 10.1.1.0/16; - deny all; + location / { + deny 192.168.1.1; + allow 192.168.1.0/24; + allow 10.1.1.0/16; + deny all; } </example> </para> <para> Правила проверяются в порядке их записи до первого соответствия. -В данном примере доступ разрешён только для сетей 10.1.1.0/16 -и 192.168.1.0/24, кроме адреса 192.168.1.1. +В данном примере доступ разрешён только для сетей +<literal>10.1.1.0/16</literal> и <literal>192.168.1.0/24</literal>, +кроме адреса <literal>192.168.1.1</literal>. Если правил много, то лучше воспользоваться переменными модуля <link doc="ngx_http_geo_module.xml">ngx_http_geo_module</link>. </para> @@ -41,27 +42,39 @@ IP-адресов клиентов. </section> -<section name="Директивы" id="directives"> +<section id="directives" name="Директивы"> <directive name="allow"> -<syntax><value>адрес</value> | <value>CIDR</value> | <literal>all</literal></syntax> +<syntax> + <value>адрес</value> | + <value>CIDR</value> | + <literal>all</literal></syntax> <default/> -<context>http, server, location, limit_except</context> +<context>http</context> +<context>server</context> +<context>location</context> +<context>limit_except</context> <para> -Директива разрешает доступ для указанной сети или адреса. +Разрешает доступ для указанной сети или адреса. </para> </directive> <directive name="deny"> -<syntax><value>адрес</value> | <value>CIDR</value> | <literal>all</literal></syntax> +<syntax> + <value>адрес</value> | + <value>CIDR</value> | + <literal>all</literal></syntax> <default/> -<context>http, server, location, limit_except</context> +<context>http</context> +<context>server</context> +<context>location</context> +<context>limit_except</context> <para> -Директива запрещает доступ для указанной сети или адреса. +Запрещает доступ для указанной сети или адреса. </para> </directive>
--- a/xml/ru/docs/http/ngx_http_addition_module.xml +++ b/xml/ru/docs/http/ngx_http_addition_module.xml @@ -2,29 +2,30 @@ <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> -<module name="Директивы модуля ngx_http_addition_module" +<module name="Модуль ngx_http_addition_module" link="/ru/docs/http/ngx_http_addition_module.html" lang="ru"> <section id="summary"> <para> -Модуль ngx_http_addition_module — это фильтр, +Модуль <literal>ngx_http_addition_module</literal> — это фильтр, добавляющий текст до и после ответа. -По умолчанию модуль не собирается, нужно разрешить его сборку -при конфигурировании параметром <literal>--with-http_addition_module</literal>. +По умолчанию этот модуль не собирается, его сборку необходимо +разрешить с помощью конфигурационного параметра +<literal>--with-http_addition_module</literal>. </para> </section> -<section name="Пример конфигурации" id="example"> +<section id="example" name="Пример конфигурации"> <para> <example> location / { - add_before_body /before_action; - add_after_body /after_action; + add_before_body /before_action; + add_after_body /after_action; } </example> </para> @@ -32,7 +33,7 @@ </section> -<section name="Директивы" id="directives"> +<section id="directives" name="Директивы"> <directive name="add_before_body"> <syntax><value>uri</value></syntax> @@ -40,7 +41,7 @@ <context>location</context> <para> -Директива добавляет перед телом ответа текст, выдаваемый в результате +Добавляет перед телом ответа текст, выдаваемый в результате работы заданного подзапроса. </para> @@ -53,7 +54,7 @@ <context>location</context> <para> -Директива добавляет после тела ответа текст, выдаваемый в результате +Добавляет после тела ответа текст, выдаваемый в результате работы заданного подзапроса. </para> @@ -63,11 +64,14 @@ <directive name="addition_types"> <syntax><value>mime-тип</value> ...</syntax> <default>text/html</default> -<context>http, server, location</context> +<context>http</context> +<context>server</context> +<context>location</context> +<appeared-in>0.7.9</appeared-in> <para> -Директива (0.7.9) разрешает добавлять текст в ответах -с указанными MIME-типами в дополнение к "text/html". +Разрешает добавлять текст в ответах с указанными MIME-типами +в дополнение к “<literal>text/html</literal>”. </para> </directive>
--- a/xml/ru/docs/http/ngx_http_auth_basic_module.xml +++ b/xml/ru/docs/http/ngx_http_auth_basic_module.xml @@ -2,27 +2,28 @@ <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> -<module name="Директивы модуля ngx_http_auth_basic_module" +<module name="Модуль ngx_http_auth_basic_module" link="/ru/docs/http/ngx_http_auth_basic_module.html" lang="ru"> <section id="summary"> <para> -Модуль ngx_http_auth_basic_module позволяет закрыть доступ с проверкой -имени и пароля по протоколу HTTP Basic Authentication. +Модуль <literal>ngx_http_auth_basic_module</literal> позволяет +ограничить доступ к ресурсам с проверкой имени и пароля по протоколу +“HTTP Basic Authentication”. </para> </section> -<section name="Пример конфигурации" id="example"> +<section id="example" name="Пример конфигурации"> <para> <example> - location / { - auth_basic "closed site"; - auth_basic_user_file conf/htpasswd; + location / { + auth_basic "closed site"; + auth_basic_user_file conf/htpasswd; } </example> </para> @@ -30,19 +31,21 @@ </section> -<section name="Директивы" id="directives"> +<section id="directives" name="Директивы"> <directive name="auth_basic"> <syntax><value>строка</value> | <literal>off</literal></syntax> <default>off</default> -<context>http, server, location, limit_except</context> +<context>http</context> +<context>server</context> +<context>location</context> +<context>limit_except</context> <para> -Директива включает проверку имени и пароля по протоколу -HTTP Basic Authentication. -Заданный параметр используется в качестве realm. -Параметр "off" позволяет отменить действие унаследованной с нижележащего -уровня директивы. +Включает проверку имени и пароля по протоколу “HTTP Basic Authentication”. +Заданный параметр используется в качестве <value>realm</value>. +Параметр <literal>off</literal> позволяет отменить действие унаследованной +с предыдущего уровня конфигурации директивы <literal>auth_basic</literal>. </para> </directive> @@ -51,11 +54,14 @@ HTTP Basic Authentication. <directive name="auth_basic_user_file"> <syntax><value>файл</value></syntax> <default/> -<context>http, server, location, limit_except</context> +<context>http</context> +<context>server</context> +<context>location</context> +<context>limit_except</context> <para> -Директива задаёт файл, в котором хранятся имена и пароли -пользователей. Формат файла следующий: +Задаёт файл, в котором хранятся имена и пароли пользователей. +Формат файла следующий: <example> # комментарий имя1:пароль1 @@ -65,9 +71,9 @@ HTTP Basic Authentication. </para> <para> -Пароли должны быть зашифрованы функцией crypt(3). -Для создания файла с паролями можно воспользоваться программой -<command>htpasswd</command> из дистрибутива Apache. +Пароли должны быть зашифрованы функцией <c-func>crypt</c-func>. +Для создания файла с паролями можно воспользоваться командой +<command>htpasswd</command> из дистрибутива веб-сервера Apache. </para> </directive>
--- a/xml/ru/docs/http/ngx_http_autoindex_module.xml +++ b/xml/ru/docs/http/ngx_http_autoindex_module.xml @@ -2,27 +2,29 @@ <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> -<module name="Директивы модуля ngx_http_autoindex_module" +<module name="Модуль ngx_http_autoindex_module" link="/ru/docs/http/ngx_http_autoindex_module.html" lang="ru"> <section id="summary"> <para> -Модуль ngx_http_autoindex_module выдаёт листинг каталога. -Обычно запрос попадает к модулю ngx_http_autoindex_module, -когда модуль <link doc="ngx_http_index_module.xml">ngx_http_index_module</link> не нашёл индексный файл. +Модуль <literal>ngx_http_autoindex_module</literal> выдаёт +листинг каталога. +Обычно запрос попадает к модулю <literal>ngx_http_autoindex_module</literal>, +когда модуль <link doc="ngx_http_index_module.xml">ngx_http_index_module</link> +не нашёл индексный файл. </para> </section> -<section name="Пример конфигурации" id="example"> +<section id="example" name="Пример конфигурации"> <para> <example> - location / { - autoindex on; + location / { + autoindex on; } </example> </para> @@ -30,15 +32,17 @@ </section> -<section name="Директивы" id="directives"> +<section id="directives" name="Директивы"> <directive name="autoindex"> <syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> -<context>http, server, location</context> +<context>http</context> +<context>server</context> +<context>location</context> <para> -Директива разрешает или запрещает вывод листинга каталога. +Разрешает или запрещает вывод листинга каталога. </para> </directive> @@ -47,25 +51,28 @@ <directive name="autoindex_exact_size"> <syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> -<context>http, server, location</context> +<context>http</context> +<context>server</context> +<context>location</context> <para> -Директива определяет, как выводить размеры файлов в листинге +Определяет, как выводить размеры файлов в листинге каталога — точно, или округляя до килобайт, мегабайт и гигабайт. </para> - </directive> <directive name="autoindex_localtime"> <syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> -<context>http, server, location</context> +<context>http</context> +<context>server</context> +<context>location</context> <para> -Директива определяет, в какой временной зоне выводить время в листинге +Определяет, в какой временной зоне выводить время в листинге каталога — в локальной или в GMT. </para>
--- a/xml/ru/docs/http/ngx_http_browser_module.xml +++ b/xml/ru/docs/http/ngx_http_browser_module.xml @@ -2,30 +2,34 @@ <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> -<module name="Директивы модуля ngx_http_browser_module" +<module name="Модуль ngx_http_browser_module" link="/ru/docs/http/ngx_http_browser_module.html" lang="ru"> <section id="summary"> <para> -Модуль ngx_http_browser_module создаёт переменные, значение которых -зависят от строки "User-Agent" в заголовке запроса: -<list type="bullet"> +Модуль <literal>ngx_http_browser_module</literal> создаёт переменные, +значения которых зависят от значения поля <header>User-Agent</header> +в заголовке запроса: +<list type="tag"> -<listitem> -$modern_browser — равна значению, заданному директивой -<link id="modern_browser_value"/>, если браузер опознан как современный; -</listitem> +<tag-name><var>$modern_browser</var></tag-name> +<tag-desc> +равна значению, заданному директивой <link id="modern_browser_value"/>, +если браузер опознан как современный; +</tag-desc> -<listitem> -$ancient_browser — равна значению, заданному директивой -<link id="ancient_browser_value"/>, если браузер опознан как устаревший; -</listitem> +<tag-name><var>$ancient_browser</var></tag-name> +<tag-desc> +равна значению, заданному директивой <link id="ancient_browser_value"/>, +если браузер опознан как устаревший; +</tag-desc> -<listitem> -$msie — равна "1", если браузер опознан как MSIE любой версии; -</listitem> +<tag-name><var>$msie</var></tag-name> +<tag-desc> +равна “1”, если браузер опознан как MSIE любой версии. +</tag-desc> </list> </para> @@ -33,38 +37,38 @@ </section> -<section name="Примеры конфигурации" id="example"> +<section id="example" name="Пример конфигурации"> <para> Выбор индексного файла: <example> - modern_browser_value "modern."; + modern_browser_value "modern."; - modern_browser msie 5.5; - modern_browser gecko 1.0.0; - modern_browser opera 9.0; - modern_browser safari 413; - modern_browser konqueror 3.0; + modern_browser msie 5.5; + modern_browser gecko 1.0.0; + modern_browser opera 9.0; + modern_browser safari 413; + modern_browser konqueror 3.0; - index index.${modern_browser}html index.html; + index index.${modern_browser}html index.html; </example> </para> <para> -Редирект для старых браузеров: +Перенаправление для старых браузеров: <example> - modern_browser msie 5.0; - modern_browser gecko 0.9.1; - modern_browser opera 8.0; - modern_browser safari 413; - modern_browser konqueror 3.0; + modern_browser msie 5.0; + modern_browser gecko 0.9.1; + modern_browser opera 8.0; + modern_browser safari 413; + modern_browser konqueror 3.0; - modern_browser unlisted; + modern_browser unlisted; - ancient_browser Links Lynx netscape4; + ancient_browser Links Lynx netscape4; if ($ancient_browser) { - rewrite ^ /ancient.html; + rewrite ^ /ancient.html; } </example> </para> @@ -72,18 +76,20 @@ </section> -<section name="Директивы" id="directives"> +<section id="directives" name="Директивы"> <directive name="ancient_browser"> <syntax><value>строка</value> ...</syntax> <default/> -<context>http, server, location</context> +<context>http</context> +<context>server</context> +<context>location</context> <para> -Директива задаёт подстроки, при нахождении которых в строке "User-Agent", -браузер считается устаревшим. -Специальная строка "netscape4" соответствует регулярному -выражению "^Mozilla/[1-4]". +Задаёт подстроки, при нахождении которых в поле <header>User-Agent</header> +заголовка запроса браузер считается устаревшим. +Специальная строка <literal>netscape4</literal> соответствует +регулярному выражению “<literal>^Mozilla/[1-4]</literal>”. </para> </directive> @@ -92,10 +98,12 @@ <directive name="ancient_browser_value"> <syntax><value>строка</value></syntax> <default>1</default> -<context>http, server, location</context> +<context>http</context> +<context>server</context> +<context>location</context> <para> -Директива задаёт значение для переменных $ancient_browser. +Задаёт значение для переменных <var>$ancient_browser</var>. </para> </directive> @@ -105,25 +113,31 @@ <syntax><value>браузер</value> <value>версия</value></syntax> <syntax><literal>unlisted</literal></syntax> <default/> -<context>http, server, location</context> +<context>http</context> +<context>server</context> +<context>location</context> <para> -Директива задаёт версию браузера, начиная с которой он считается современным. -В качестве браузера можно задать msie, gecko (браузеры, созданные -на основе Mozilla) opera, safari, konqueror. +Задаёт версию браузера, начиная с которой он считается современным. +В качестве браузера можно задать <literal>msie</literal>, +<literal>gecko</literal> (браузеры, созданные на основе Mozilla), +<literal>opera</literal>, <literal>safari</literal>, +<literal>konqueror</literal>. </para> <para> -Версии можно задать в формате X, X.X, X.X.X, или X.X.X.X. -Максимальные значения для каждого из форматов соответственно — 4000, -4000.99, 4000.99.99, и 4000.99.99.99. +Версии можно задать в форматах X, X.X, X.X.X или X.X.X.X. +Максимальные значения для каждого из форматов соответственно — +4000, 4000.99, 4000.99.99 и 4000.99.99.99. </para> <para> -Специальное значение "unlisted" указывает считать современным браузер, -не описанный директивами modern_browser и <link id="ancient_browser"/>. +Специальное значение <literal>unlisted</literal> указывает считать +современным браузер, не описанный директивами <literal>modern_browser</literal> +и <link id="ancient_browser"/>. В противном случае неперечисленный браузер будет считаться устаревшим. -Если в запросе нет строки "User-Agent", то браузер считается неперечисленным. +Если в заголовке запроса нет поля <header>User-Agent</header>, то браузер +считается неперечисленным. </para> </directive> @@ -132,10 +146,12 @@ 4000.99, 4000.99.99, и 4000.99.99.99. <directive name="modern_browser_value"> <syntax><value>строка</value></syntax> <default>1</default> -<context>http, server, location</context> +<context>http</context> +<context>server</context> +<context>location</context> <para> -Директива задаёт значение для переменных $modern_browser. +Задаёт значение для переменных <var>$modern_browser</var>. </para> </directive>