Mercurial > hg > nginx-site

changeset 342:a076f7661569

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Revision.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 23 Jan 2012 11:34:54 +0000
parents a21a5ae60b1e
children 46e75d7ae0e7
files xml/ru/docs/http/ngx_http_realip_module.xml xml/ru/docs/http/ngx_http_secure_link_module.xml xml/ru/docs/http/ngx_http_split_clients_module.xml xml/ru/docs/http/ngx_http_sub_module.xml
diffstat 4 files changed, 91 insertions(+), 66 deletions(-) [+]
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_realip_module.xml	Sat Jan 21 21:43:12 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_realip_module.xml	Mon Jan 23 11:34:54 2012 +0000
@@ -2,44 +2,50 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Директивы модуля ngx_http_realip_module"
+<module name="Модуль ngx_http_realip_module"
         link="/ru/docs/http/ngx_http_realip_module.html"
         lang="ru">
 
 <section id="summary">
 
 <para>
-Модуль ngx_http_realip_module позволяет менять адрес клиента
-на переданный в указанной строке заголовка.
-По умолчанию модуль не собирается, нужно разрешить его сборку
-при конфигурировании параметром <literal>--with-http_realip_module</literal>.
+Модуль <literal>ngx_http_realip_module</literal> позволяет менять адрес клиента
+на переданный в указанном поле заголовка.
+</para>
+
+<para>
+По умолчанию этот модуль не собирается, его сборку необходимо
+разрешить с помощью конфигурационного параметра
+<literal>--with-http_realip_module</literal>.
 </para>
 
 </section>
 
 
-<section name="Пример конфигурации" id="example">
+<section id="example" name="Пример конфигурации">
 
 <para>
 <example>
-    set_real_ip_from   192.168.1.0/24;
-    set_real_ip_from   192.168.2.1;
-    real_ip_header     X-Real-IP;
+    set_real_ip_from 192.168.1.0/24;
+    set_real_ip_from 192.168.2.1;
+    real_ip_header   X-Real-IP;
 </example>
 </para>
 
 </section>
 
 
-<section name="Директивы" id="directives">
+<section id="directives" name="Директивы">
 
 <directive name="set_real_ip_from">
 <syntax><value>адрес</value> | <value>CIDR</value></syntax>
 <default/>
-<context>http, server, location</context>
+<context>http</context>
+<context>server</context>
+<context>location</context>
 
 <para>
-Директива описывает доверенные адреса, которые передают верный адрес
+Описывает доверенные адреса, которые передают верный адрес
 для замены.
 </para>
 
@@ -52,13 +58,16 @@
   <literal>X-Real-IP</literal> |
   <literal>X-Forwarded-For</literal></syntax>
 <default>X-Real-IP</default>
-<context>http, server, location</context>
+<context>http</context>
+<context>server</context>
+<context>location</context>
 
 <para>
-Директива задаёт поле заголовка запроса,
+Задаёт поле заголовка запроса,
 в котором передаётся адрес для замены.
-В случае строки "X-Forwarded-For" используется последний адрес в значении
-строки. Для остальных строк используется всё значение.
+В случае поля <header>X-Forwarded-For</header> используется
+последний адрес в значении поля.
+Для остальных полей используется всё значение.
 </para>
 
 </directive>
--- a/xml/ru/docs/http/ngx_http_secure_link_module.xml	Sat Jan 21 21:43:12 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_secure_link_module.xml	Mon Jan 23 11:34:54 2012 +0000
@@ -2,29 +2,32 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Директивы модуля ngx_http_secure_link_module"
+<module name="Модуль ngx_http_secure_link_module"
         link="/ru/docs/http/ngx_http_secure_link_module.html"
         lang="ru">
 
 <section id="summary">
 
 <para>
-Модуль ngx_http_secure_link_module — это модуль проверяющий
+Модуль <literal>ngx_http_secure_link_module</literal> проверяет
 правильность запрашиваемой ссылки (0.7.18+).
-По умолчанию модуль не собирается, нужно разрешить его сборку
-при конфигурировании параметром
+</para>
+
+<para>
+По умолчанию этот модуль не собирается, его сборку необходимо
+разрешить с помощью конфигурационного параметра
 <literal>--with-http_secure_link_module</literal>.
 </para>
 
 </section>
 
 
-<section name="Пример конфигурации" id="example">
+<section id="example" name="Пример конфигурации">
 
 <para>
 <example>
 location /p/ {
-    secure_link_secret   some_secret_word;
+    secure_link_secret some_secret_word;
 
     if ($secure_link = "") {
         return 403;
@@ -36,7 +39,7 @@
 </section>
 
 
-<section name="Директивы" id="directives">
+<section id="directives" name="Директивы">
 
 <directive name="secure_link_secret">
 <syntax><value>слово</value></syntax>
@@ -44,12 +47,12 @@
 <context>location</context>
 
 <para>
-Директива задаёт секретное слово для проверки правильности ссылки.
+Задаёт секретное <value>слово</value> для проверки правильности ссылки.
 Полный URL защищённой ссылки выглядит так:
 <example>
 /prefix/<value>hash</value>/<value>ссылка</value>
 </example>
-где hash считается как
+где <value>hash</value> считается как
 <example>
 md5(ссылка, секретное_слово);
 </example>
@@ -64,15 +67,16 @@
 </section>
 
 
-<section name="Встроенные переменные" id="variables">
+<section id="variables" name="Встроенные переменные">
 
 <para>
-<list type="bullet">
+<list type="tag">
 
-<listitem>
-$secure_link, эта переменная равна ссылке выделенной из полного URL'а.
+<tag-name><var>$secure_link</var></tag-name>
+<tag-desc>
+равна ссылке, выделенной из полного URL’а.
 Если хэш неверный, то переменная равна пустой строке.
-</listitem>
+</tag-desc>
 
 </list>
 </para>
--- a/xml/ru/docs/http/ngx_http_split_clients_module.xml	Sat Jan 21 21:43:12 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_split_clients_module.xml	Mon Jan 23 11:34:54 2012 +0000
@@ -2,60 +2,62 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Директивы модуля ngx_http_split_clients_module"
+<module name="Модуль ngx_http_split_clients_module"
         link="/ru/docs/http/ngx_http_split_clients_module.html"
         lang="ru">
 
 <section id="summary">
 
 <para>
-Модуль ngx_http_split_clients_module создаёт переменные для
-A/B split-тестирования.
+Модуль <literal>ngx_http_split_clients_module</literal> создаёт переменные для
+A/B тестирования (также известного как “split-тестирование”).
 </para>
 
 </section>
 
 
-<section name="Пример конфигурации" id="example">
+<section id="example" name="Пример конфигурации">
 
 <para>
 <example>
 http {
-    split_clients "${remote_addr}AAA"  $variant {
-                   0.5%                .one;
-                   2.0%                .two;
-                   *                   "";
+    split_clients "${remote_addr}AAA" $variant {
+                   0.5%               .one;
+                   2.0%               .two;
+                   *                  "";
     }
 
     server {
         location / {
-            index  index${variant}.html;
+            index index${variant}.html;
 </example>
 </para>
 </section>
 
 
-<section name="Директивы" id="directives">
+<section id="directives" name="Директивы">
 
 <directive name="split_clients">
-<syntax block="yes"><value>$переменная1</value> <value>$переменная2</value></syntax>
+<syntax block="yes">
+    <value>строка</value>
+    <value>$переменная</value></syntax>
 <default/>
 <context>http</context>
 
 <para>
-Директива создаёт переменную для A/B split-тестирования, например:
+Создаёт переменную для A/B тестирования, например:
 <example>
-split_clients "${remote_addr}AAA"  $variant {
-               0.5%                .one;
-               2.0%                .two;
-               *                   "";
+split_clients "${remote_addr}AAA" $variant {
+               0.5%               .one;
+               2.0%               .two;
+               *                  "";
 }
 </example>
-Значение исходной строки переменных хэшируется с помощью CRC32.
+Значение исходной строки хэшируется с помощью MurmurHash2.
 В приведённом примере при значениях хэша от 0 до 21474836 (0.5%)
-переменная $variant получит значение ".one".
-При значениях хэша от 21474837 до 107374182 (2%) — ".two".
-И при значениях хэша от 107374183 до 4294967297 — "".
+переменная <var>$variant</var> получит значение <literal>".one"</literal>.
+При значениях хэша от 21474837 до 107374182 (2%) — <literal>".two"</literal>.
+И при значениях хэша от 107374183 до 4294967297 — <literal>""</literal>.
 </para>
 
 </directive>
--- a/xml/ru/docs/http/ngx_http_sub_module.xml	Sat Jan 21 21:43:12 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_sub_module.xml	Mon Jan 23 11:34:54 2012 +0000
@@ -2,30 +2,34 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Директивы модуля ngx_http_sub_module"
+<module name="Модуль ngx_http_sub_module"
         link="/ru/docs/http/ngx_http_sub_module.html"
         lang="ru">
 
 <section id="summary">
 
 <para>
-Модуль ngx_http_sub_module — это фильтр,
+Модуль <literal>ngx_http_sub_module</literal> — это фильтр,
 изменяющий в ответе одну заданную строку на другую.
-По умолчанию модуль не собирается, нужно разрешить его сборку
-при конфигурировании параметром <literal>--with-http_sub_module</literal>.
+</para>
+
+<para>
+По умолчанию этот модуль не собирается, его сборку необходимо
+разрешить с помощью конфигурационного параметра
+<literal>--with-http_sub_module</literal>.
 </para>
 
 </section>
 
 
-<section name="Пример конфигурации" id="example">
+<section id="example" name="Пример конфигурации">
 
 <para>
 <example>
 location / {
-    sub_filter        &lt;/head&gt;
-           '&lt;/head&gt;&lt;script language="javascript" src="$script"&gt;&lt;/script&gt;';
-    sub_filter_once   on;
+    sub_filter      &lt;/head&gt;
+        '&lt;/head&gt;&lt;script language="javascript" src="$script"&gt;&lt;/script&gt;';
+    sub_filter_once on;
 }
 </example>
 </para>
@@ -33,15 +37,17 @@
 </section>
 
 
-<section name="Директивы" id="directives">
+<section id="directives" name="Директивы">
 
 <directive name="sub_filter">
 <syntax><value>строка</value> <value>замена</value></syntax>
 <default/>
-<context>http, server, location</context>
+<context>http</context>
+<context>server</context>
+<context>location</context>
 
 <para>
-Директива задаёт строку, которую нужно заменить, и строку замены.
+Задаёт строку, которую нужно заменить, и строку замены.
 Заменяемая строка проверяется без учёта регистра.
 В строке замены можно использовать переменные.
 </para>
@@ -52,10 +58,12 @@
 <directive name="sub_filter_once">
 <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>
 
@@ -65,11 +73,13 @@
 <directive name="sub_filter_types">
 <syntax><value>mime-тип</value> ...</syntax>
 <default>text/html</default>
-<context>http, server, location</context>
+<context>http</context>
+<context>server</context>
+<context>location</context>
 
 <para>
-Директива разрешает замену строк в ответах с указанными MIME-типами
-в дополнение к "text/html".
+Разрешает замену строк в ответах с указанными MIME-типами
+в дополнение к “<literal>text/html</literal>”.
 </para>
 
 </directive>