Mercurial > hg > nginx-site

changeset 346:e5bf97f56d72

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 16:40:41 +0000
parents b9a84ab82ec1
children daae2b619815
files xml/ru/docs/http/ngx_http_geoip_module.xml xml/ru/docs/http/ngx_http_map_module.xml
diffstat 2 files changed, 118 insertions(+), 94 deletions(-) [+]
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_geoip_module.xml	Mon Jan 23 15:26:51 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_geoip_module.xml	Mon Jan 23 16:40:41 2012 +0000
@@ -2,33 +2,38 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Директивы модуля ngx_http_geoip_module"
+<module name="Модуль ngx_http_geoip_module"
         link="/ru/docs/http/ngx_http_geoip_module.html"
         lang="ru">
 
 <section id="summary">
 
 <para>
-Модуль ngx_http_geoip_module создаёт переменные, значения которых
-зависят от IP-адреса клиента, используя готовые базы
-<link url="http://www.maxmind.com">MaxMind</link> (0.8.6+).
-По умолчанию модуль не собирается, нужно разрешить его сборку
-при конфигурировании параметром <literal>--with-http_geoip_module</literal>.
+Модуль <literal>ngx_http_geoip_module</literal> (0.8.6+) создаёт переменные,
+значения которых зависят от IP-адреса клиента, используя готовые базы данных
+<link url="http://www.maxmind.com">MaxMind</link>.
+</para>
+
+<para>
+По умолчанию этот модуль не собирается, его сборку необходимо
+разрешить с помощью конфигурационного параметра
+<literal>--with-http_geoip_module</literal>.
+<note>
 Для сборки и работы этого модуля нужна библиотека
 <link url="http://www.maxmind.com/app/c">MaxMind GeoIP</link>.
-
+</note>
 </para>
 
 </section>
 
 
-<section name="Пример конфигурации" id="example">
+<section id="example" name="Пример конфигурации">
 
 <para>
 <example>
 http {
-    geoip_country  GeoIP.dat;
-    geoip_city     GeoLiteCity.dat;
+    geoip_country GeoIP.dat;
+    geoip_city    GeoLiteCity.dat;
     ...
 </example>
 </para>
@@ -36,7 +41,7 @@
 </section>
 
 
-<section name="Директивы" id="directives">
+<section id="directives" name="Директивы">
 
 <directive name="geoip_country">
 <syntax><value>база</value></syntax>
@@ -44,23 +49,28 @@
 <context>http</context>
 
 <para>
-Директива geoip_country указывает базу для определения страны в зависимости
+Задаёт базу данных для определения страны в зависимости
 от значения IP-адреса клиента.
-При использовании этой базы доступны следующие переменные:
-<list type="bullet">
+При использовании этой базы данных доступны следующие переменные:
+<list type="tag">
 
-<listitem>
-$geoip_country_code; — двухбуквенный код страны, например, "RU", "US".
-</listitem>
+<tag-name><var>$geoip_country_code</var></tag-name>
+<tag-desc>
+двухбуквенный код страны, например,
+“<literal>RU</literal>”, “<literal>US</literal>”.
+</tag-desc>
 
-<listitem>
-$geoip_country_code3; — трёхбуквенный код страны, например, "RUS", "USA".
-</listitem>
+<tag-name><var>$geoip_country_code3</var></tag-name>
+<tag-desc>
+трёхбуквенный код страны, например,
+“<literal>RUS</literal>”, “<literal>USA</literal>”.
+</tag-desc>
 
-<listitem>
-$geoip_country_name; — название страны, например, "Russian Federation",
-"United States".
-</listitem>
+<tag-name><var>$geoip_country_name</var></tag-name>
+<tag-desc>
+название страны, например,
+“<literal>Russian Federation</literal>”, “<literal>United States</literal>”.
+</tag-desc>
 
 </list>
 </para>
@@ -74,37 +84,46 @@
 <context>http</context>
 
 <para>
-Директива geoip_city указывает базу для определения страны, региона и города
+Задаёт базу данных для определения страны, региона и города
 в зависимости от значения IP-адреса клиента.
-При использовании этой базы доступны следующие переменные:
-<list type="bullet">
+При использовании этой базы данных доступны следующие переменные:
+<list type="tag">
 
-<listitem>
-$geoip_city_country_code; — двухбуквенный код страны, например, "RU", "US".
-</listitem>
+<tag-name><var>$geoip_city_country_code</var></tag-name>
+<tag-desc>
+двухбуквенный код страны, например,
+“<literal>RU</literal>”, “<literal>US</literal>”.
+</tag-desc>
 
-<listitem>
-$geoip_city_country_code3; — трёхбуквенный код страны, например,
-"RUS", "USA".
-</listitem>
+<tag-name><var>$geoip_city_country_code3</var></tag-name>
+<tag-desc>
+трёхбуквенный код страны, например,
+“<literal>RUS</literal>”, “<literal>USA</literal>”.
+</tag-desc>
 
-<listitem>
-$geoip_city_country_name; — название страны, например, "Russian Federation",
-"United States".
-</listitem>
+<tag-name><var>$geoip_city_country_name</var></tag-name>
+<tag-desc>
+название страны, например,
+“<literal>Russian Federation</literal>”, “<literal>United States</literal>”.
+</tag-desc>
 
-<listitem>
-$geoip_region; — название региона страны (область, край, штат,
-провинция, федеральная земля и тому подобное), например, "Moscow City", "DC".
-</listitem>
+<tag-name><var>$geoip_region</var></tag-name>
+<tag-desc>
+название региона страны (область, край, штат,
+провинция, федеральная земля и тому подобное), например,
+“<literal>Moscow City</literal>”, “<literal>DC</literal>”.
+</tag-desc>
 
-<listitem>
-$geoip_city; — название города, например, "Moscow", "Washington".
-</listitem>
+<tag-name><var>$geoip_city</var></tag-name>
+<tag-desc>
+название города, например,
+“<literal>Moscow</literal>”, “<literal>Washington</literal>”.
+</tag-desc>
 
-<listitem>
-$geoip_postal_code; — почтовый индекс.
-</listitem>
+<tag-name><var>$geoip_postal_code</var></tag-name>
+<tag-desc>
+почтовый индекс.
+</tag-desc>
 
 </list>
 </para>
--- a/xml/ru/docs/http/ngx_http_map_module.xml	Mon Jan 23 15:26:51 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_map_module.xml	Mon Jan 23 16:40:41 2012 +0000
@@ -2,81 +2,86 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Директивы модуля ngx_http_map_module"
+<module name="Модуль ngx_http_map_module"
         link="/ru/docs/http/ngx_http_map_module.html"
         lang="ru">
 
 <section id="summary">
 
 <para>
-Модуль ngx_http_map_module создаёт переменные, значение которых
-зависят от значения других переменных.
+Модуль <literal>ngx_http_map_module</literal> создаёт переменные,
+значения которых зависят от значений других переменных.
 </para>
 
 </section>
 
 
-<section name="Пример конфигурации" id="example">
+<section id="example" name="Пример конфигурации">
 
 <para>
 <example>
-    map  $http_host  $name  {
-        hostnames;
+map $http_host $name  {
+    hostnames;
 
-        default          0;
+    default       0;
 
-        example.com      1;
-        *.example.com    1;
-        test.com         2;
-        *.test.com       2;
-        .site.com        3;
-        wap.*            4;
-    }
+    example.com   1;
+    *.example.com 1;
+    test.com      2;
+    *.test.com    2;
+    .site.com     3;
+    wap.*         4;
+}
 </example>
 </para>
 
 </section>
 
 
-<section name="Директивы" id="directives">
+<section id="directives" name="Директивы">
 
 <directive name="map">
-<syntax block="yes"><value>$переменная1</value> <value>$переменная2</value></syntax>
+<syntax block="yes">
+    <value>$переменная1</value>
+    <value>$переменная2</value></syntax>
 <default/>
 <context>http</context>
 
 <para>
-Директива создаёт переменную, значение которой
+Создаёт переменную, значение которой
 зависит от значения исходной переменной.
 Директива поддерживает три специальных параметра:
-<list type="bullet">
-<listitem>
-default — задаёт значение для второй переменной, если значение
+<list type="tag">
+<tag-name><literal>default</literal> <value>значение</value></tag-name>
+<tag-desc>
+задаёт значение для второй переменной, если значение
 первой переменной не найдено.
-</listitem>
+</tag-desc>
 
-<listitem>
-hostnames — указывает, что в качестве исходных значений можно
+<tag-name><literal>hostnames</literal></tag-name>
+<tag-desc>
+указывает, что в качестве исходных значений можно
 использовать маску для первой или последней части имени хоста, например,
 <example>
-*.example.com  1;
-example.*      1;
+*.example.com 1;
+example.*     1;
 </example>
 Вместо двух записей
 <example>
-example.com    1;
-*.example.com  1;
+example.com   1;
+*.example.com 1;
 </example>
-можно использовать одну
+можно использовать одну:
 <example>
-.example.com   1;
+.example.com  1;
 </example>
-</listitem>
+</tag-desc>
 
-<listitem>
-include — включает файл со значениями.
+<tag-name><literal>include</literal> <value>файл</value></tag-name>
+<tag-desc>
+включает файл со значениями.
 Включений может быть несколько.
-</listitem>
+</tag-desc>
 
 </list>
 </para>
@@ -84,30 +89,30 @@
 </directive>
 
 
-<directive name="map_hash_max_size">
-<syntax><value>число</value></syntax>
-<default>2048</default>
+<directive name="map_hash_bucket_size">
+<syntax><value>размер</value></syntax>
+<default>32|64|128</default>
 <context>http</context>
 
 <para>
-Директива задаёт максимальный размер хэш-таблиц для переменных map.
-Подробнее смотри в <link doc="../hash.xml">описании
-настройки хэшей</link>.
+Задаёт размер корзины в хэш-таблицах для переменных <link id="map"/>.
+Значение по умолчанию зависит от размера строки кэша процессора.
+Подробнее смотрите в документе по
+<link doc="../hash.xml">настройке хэшей</link>.
 </para>
 
 </directive>
 
 
-<directive name="map_hash_bucket_size">
-<syntax><value>число</value></syntax>
-<default>32/64/128</default>
+<directive name="map_hash_max_size">
+<syntax><value>размер</value></syntax>
+<default>2048</default>
 <context>http</context>
 
 <para>
-Директива задаёт размер корзины в хэш-таблицах для переменных map.
-Значение по умолчанию зависит от размера строки кэша процессора.
-Подробнее смотри в <link doc="../hash.xml">описании
-настройки хэшей</link>.
+Задаёт максимальный размер хэш-таблиц для переменных <link id="map"/>.
+Подробнее смотрите в документе по
+<link doc="../hash.xml">настройке хэшей</link>.
 </para>
 
 </directive>