Mercurial > hg > nginx-site
changeset 342:a076f7661569
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 </head> - '</head><script language="javascript" src="$script"></script>'; - sub_filter_once on; + sub_filter </head> + '</head><script language="javascript" src="$script"></script>'; + 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>