Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_geoip_module.xml @ 76:4a4caa566120

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Russian documentation import. Changes in module.dtd: <example> now allowed to contain <value> and <emphasis> elements (we need this to show important parts in examples), less strict checking of <directive> syntax (we don't want to fully document some directives, notably deprecated ones). Known issues: 1. <syntax> elements are preserved as is, they will require manual conversion (likely to some not-yet-existed format a la DocBook cmdsynopsis, as currently used one seems to be incomplete); 2. <value> no longer corresponds to replaceable content, and it's use in examples isn't correct; 3. <link doc="document#fragment"> doesn't work with current xslt, either should be supported or changed to <link doc="document" id="fragment">. The following files are intentionally omitted: maillists.xml (support.xml should be used instead), experimental.xml (obsolete), faq.xml (conflicts with existing one, needs discussion). Not yet linked to site.
author Maxim Dounin <mdounin@mdounin.ru>
date Tue, 11 Oct 2011 12:57:50 +0000
parents
children 1d315ef37215
comparison
equal deleted inserted replaced
75:2bf4cd2787c5 76:4a4caa566120
1 <?xml version="1.0" encoding="utf-8"?>
2
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4
5 <module name="Директивы модуля ngx_http_geoip_module"
6 link="/ru/docs/http/ngx_http_geoip_module.html"
7 lang="ru">
8
9 <section name="" id="summary">
10
11 <para>
12 Модуль ngx_http_geoip_module создаёт переменные, значения которых
13 зависят от IP-адреса клиента, используя готовые базы
14 <link url="http://www.maxmind.com">MaxMind</link> (0.8.6+).
15 По умолчанию модуль не собирается, нужно разрешить его сборку
16 при конфигурировании параметром <command>--with-http_geoip_module</command>.
17 Для сборки и работы этого модуля нужна библиотека
18 <link url="http://www.maxmind.com/app/c">MaxMind GeoIP</link>.
19
20 </para>
21
22 </section>
23
24
25 <section name="Пример конфигурации" id="example">
26
27 <para>
28 <example>
29 http {
30 geoip_country GeoIP.dat;
31 geoip_city GeoLiteCity.dat;
32 ...
33 </example>
34 </para>
35
36 </section>
37
38
39 <section name="Директивы" id="directives">
40
41 <directive name="geoip_country">
42 <syntax>geoip_country <value>база</value></syntax>
43 <default>нет</default>
44 <context>http</context>
45
46 <para>
47 Директива geoip_country указывает базу для определения страны в зависимости
48 от значения IP-адреса клиента.
49 При использовании этой базы доступны следующие переменные:
50 <list type="bullet">
51
52 <listitem>
53 $geoip_country_code; — двухбуквенный код страны, например, "RU", "US".
54 </listitem>
55
56 <listitem>
57 $geoip_country_code3; — трёхбуквенный код страны, например, "RUS", "USA".
58 </listitem>
59
60 <listitem>
61 $geoip_country_name; — название страны, например, "Russian Federation",
62 "United States".
63 </listitem>
64
65 </list>
66 </para>
67
68 </directive>
69
70
71 <directive name="geoip_city">
72 <syntax>geoip_city <value>база</value></syntax>
73 <default>нет</default>
74 <context>http</context>
75
76 <para>
77 Директива geoip_city указывает базу для определения страны, региона и города
78 в зависимости от значения IP-адреса клиента.
79 При использовании этой базы доступны следующие переменные:
80 <list type="bullet">
81
82 <listitem>
83 $geoip_city_country_code; — двухбуквенный код страны, например, "RU", "US".
84 </listitem>
85
86 <listitem>
87 $geoip_city_country_code3; — трёхбуквенный код страны, например,
88 "RUS", "USA".
89 </listitem>
90
91 <listitem>
92 $geoip_city_country_name; — название страны, например, "Russian Federation",
93 "United States".
94 </listitem>
95
96 <listitem>
97 $geoip_region; — название региона страны (область, край, штат,
98 провинция, федеральная земля и тому подобное), например, "Moscow City", "DC".
99 </listitem>
100
101 <listitem>
102 $geoip_city; — название города, например, "Moscow", "Washington".
103 </listitem>
104
105 <listitem>
106 $geoip_postal_code; — почтовый индекс.
107 </listitem>
108
109 </list>
110 </para>
111
112 </directive>
113
114 </section>
115
116 </module>