Mercurial > hg > nginx-site
changeset 346:e5bf97f56d72
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>