diff xml/ru/docs/http/ngx_http_browser_module.xml @ 303:1c239146beb4

Revision.
author Ruslan Ermilov <ru@nginx.com>
date Sat, 31 Dec 2011 14:49:04 +0000
parents 2305be197a84
children e9f292167117
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_browser_module.xml	Thu Dec 29 15:36:38 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_browser_module.xml	Sat Dec 31 14:49:04 2011 +0000
@@ -2,30 +2,34 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Директивы модуля ngx_http_browser_module"
+<module name="Модуль ngx_http_browser_module"
         link="/ru/docs/http/ngx_http_browser_module.html"
         lang="ru">
 
 <section id="summary">
 
 <para>
-Модуль ngx_http_browser_module создаёт переменные, значение которых
-зависят от строки "User-Agent" в заголовке запроса:
-<list type="bullet">
+Модуль <literal>ngx_http_browser_module</literal> создаёт переменные,
+значения которых зависят от значения поля <header>User-Agent</header>
+в заголовке запроса:
+<list type="tag">
 
-<listitem>
-$modern_browser — равна значению, заданному директивой
-<link id="modern_browser_value"/>, если браузер опознан как современный;
-</listitem>
+<tag-name><var>$modern_browser</var></tag-name>
+<tag-desc>
+равна значению, заданному директивой <link id="modern_browser_value"/>,
+если браузер опознан как современный;
+</tag-desc>
 
-<listitem>
-$ancient_browser — равна значению, заданному директивой
-<link id="ancient_browser_value"/>, если браузер опознан как устаревший;
-</listitem>
+<tag-name><var>$ancient_browser</var></tag-name>
+<tag-desc>
+равна значению, заданному директивой <link id="ancient_browser_value"/>,
+если браузер опознан как устаревший;
+</tag-desc>
 
-<listitem>
-$msie — равна "1", если браузер опознан как MSIE любой версии;
-</listitem>
+<tag-name><var>$msie</var></tag-name>
+<tag-desc>
+равна “1”, если браузер опознан как MSIE любой версии.
+</tag-desc>
 
 </list>
 </para>
@@ -33,38 +37,38 @@
 </section>
 
 
-<section name="Примеры конфигурации" id="example">
+<section id="example" name="Пример конфигурации">
 
 <para>
 Выбор индексного файла:
 <example>
-    modern_browser_value  "modern.";
+    modern_browser_value "modern.";
 
-    modern_browser   msie       5.5;
-    modern_browser   gecko      1.0.0;
-    modern_browser   opera      9.0;
-    modern_browser   safari     413;
-    modern_browser   konqueror  3.0;
+    modern_browser msie      5.5;
+    modern_browser gecko     1.0.0;
+    modern_browser opera     9.0;
+    modern_browser safari    413;
+    modern_browser konqueror 3.0;
 
-    index  index.${modern_browser}html index.html;
+    index index.${modern_browser}html index.html;
 </example>
 </para>
 
 <para>
-Редирект для старых браузеров:
+Перенаправление для старых браузеров:
 <example>
-    modern_browser   msie       5.0;
-    modern_browser   gecko      0.9.1;
-    modern_browser   opera      8.0;
-    modern_browser   safari     413;
-    modern_browser   konqueror  3.0;
+    modern_browser msie      5.0;
+    modern_browser gecko     0.9.1;
+    modern_browser opera     8.0;
+    modern_browser safari    413;
+    modern_browser konqueror 3.0;
 
-    modern_browser   unlisted;
+    modern_browser unlisted;
 
-    ancient_browser  Links  Lynx  netscape4;
+    ancient_browser Links Lynx netscape4;
 
     if ($ancient_browser) {
-        rewrite  ^  /ancient.html;
+        rewrite ^ /ancient.html;
     }
 </example>
 </para>
@@ -72,18 +76,20 @@
 </section>
 
 
-<section name="Директивы" id="directives">
+<section id="directives" name="Директивы">
 
 <directive name="ancient_browser">
 <syntax><value>строка</value> ...</syntax>
 <default/>
-<context>http, server, location</context>
+<context>http</context>
+<context>server</context>
+<context>location</context>
 
 <para>
-Директива задаёт подстроки, при нахождении которых в строке "User-Agent",
-браузер считается устаревшим.
-Специальная строка "netscape4" соответствует регулярному
-выражению "^Mozilla/[1-4]".
+Задаёт подстроки, при нахождении которых в поле <header>User-Agent</header>
+заголовка запроса браузер считается устаревшим.
+Специальная строка <literal>netscape4</literal> соответствует
+регулярному выражению “<literal>^Mozilla/[1-4]</literal>”.
 </para>
 
 </directive>
@@ -92,10 +98,12 @@
 <directive name="ancient_browser_value">
 <syntax><value>строка</value></syntax>
 <default>1</default>
-<context>http, server, location</context>
+<context>http</context>
+<context>server</context>
+<context>location</context>
 
 <para>
-Директива задаёт значение для переменных $ancient_browser.
+Задаёт значение для переменных <var>$ancient_browser</var>.
 </para>
 
 </directive>
@@ -105,25 +113,31 @@
 <syntax><value>браузер</value> <value>версия</value></syntax>
 <syntax><literal>unlisted</literal></syntax>
 <default/>
-<context>http, server, location</context>
+<context>http</context>
+<context>server</context>
+<context>location</context>
 
 <para>
-Директива задаёт версию браузера, начиная с которой он считается современным.
-В качестве браузера можно задать msie, gecko (браузеры, созданные
-на основе Mozilla) opera, safari, konqueror.
+Задаёт версию браузера, начиная с которой он считается современным.
+В качестве браузера можно задать <literal>msie</literal>,
+<literal>gecko</literal> (браузеры, созданные на основе Mozilla),
+<literal>opera</literal>, <literal>safari</literal>,
+<literal>konqueror</literal>.
 </para>
 
 <para>
-Версии можно задать в формате X, X.X, X.X.X, или X.X.X.X.
-Максимальные значения для каждого из форматов соответственно — 4000,
-4000.99, 4000.99.99, и 4000.99.99.99.
+Версии можно задать в форматах X, X.X, X.X.X или X.X.X.X.
+Максимальные значения для каждого из форматов соответственно —
+4000, 4000.99, 4000.99.99 и 4000.99.99.99.
 </para>
 
 <para>
-Специальное значение "unlisted" указывает считать современным браузер,
-не описанный директивами modern_browser и <link id="ancient_browser"/>.
+Специальное значение <literal>unlisted</literal> указывает считать
+современным браузер, не описанный директивами <literal>modern_browser</literal>
+и <link id="ancient_browser"/>.
 В противном случае неперечисленный браузер будет считаться устаревшим.
-Если в запросе нет строки "User-Agent", то браузер считается неперечисленным.
+Если в заголовке запроса нет поля <header>User-Agent</header>, то браузер
+считается неперечисленным.
 </para>
 
 </directive>
@@ -132,10 +146,12 @@
 <directive name="modern_browser_value">
 <syntax><value>строка</value></syntax>
 <default>1</default>
-<context>http, server, location</context>
+<context>http</context>
+<context>server</context>
+<context>location</context>
 
 <para>
-Директива задаёт значение для переменных $modern_browser.
+Задаёт значение для переменных <var>$modern_browser</var>.
 </para>
 
 </directive>