Mercurial > hg > nginx-site

changeset 303:1c239146beb4

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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	Thu Dec 29 15:36:38 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_access_module.xml	Sat Dec 31 14:49:04 2011 +0000
@@ -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 @@
 </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	Thu Dec 29 15:36:38 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_addition_module.xml	Sat Dec 31 14:49:04 2011 +0000
@@ -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	Thu Dec 29 15:36:38 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_auth_basic_module.xml	Sat Dec 31 14:49:04 2011 +0000
@@ -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 @@
 <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 @@
 </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	Thu Dec 29 15:36:38 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_autoindex_module.xml	Sat Dec 31 14:49:04 2011 +0000
@@ -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	Thu Dec 29 15:36:38 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_browser_module.xml	Sat Dec 31 14:49:04 2011 +0000
@@ -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 @@
 <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>