diff xml/ru/docs/install.xml @ 271:4c6d2c614d2c

Cleaned up XML tag mess: - all of <parameter> and <code>, and some of <dirname>, <value>, and <command> were replaced by <literal>; - the rest of <dirname> were replaced by links; - <argument> were replaced by <value>; - <value> is now rendered in HTML in italic; - <literal> and <path> can now contain <value>. Cleaned up terminology mess: - directives take "parameters".
author Ruslan Ermilov <ru@nginx.com>
date Fri, 23 Dec 2011 17:29:59 +0000
parents e93ece6bd34e
children 64107bc400c4
line wrap: on
line diff
--- a/xml/ru/docs/install.xml	Thu Dec 22 13:39:18 2011 +0000
+++ b/xml/ru/docs/install.xml	Fri Dec 23 17:29:59 2011 +0000
@@ -10,86 +10,86 @@
 Конфигурация сборки осуществляется командой <command>configure</command>.
 Она определяет особенности системы и, в частности, методы, которые nginx
 может использовать для обработки соединений.
-В конце концов она создаёт <command>Makefile</command>.
+В конце концов она создаёт <path>Makefile</path>.
 Команда <command>configure</command> поддерживает следующие параметры:
 <list>
 
 <listitem>
 <para>
-<command>--prefix=&lt;<value>путь</value>&gt;</command>&mdash;задаёт каталог,
+<literal>--prefix=<value>путь</value></literal>&mdash;задаёт каталог,
 в котором будут находиться файлы сервера.
 Этот же каталог будет использоваться для всех относительных путей,
-задаваемых <command>./configure</command> (кроме путей к исходным текстам
-библиотек) и в конфигурационном файле <command>nginx.conf</command>.
-По умолчанию&mdash;каталог <command>/usr/local/nginx</command>.
+задаваемых <command>configure</command> (кроме путей к исходным текстам
+библиотек) и в конфигурационном файле <path>nginx.conf</path>.
+По умолчанию&mdash;каталог <path>/usr/local/nginx</path>.
 </para>
 </listitem>
 
 <listitem>
 <para>
-<command>--sbin-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
+<literal>--sbin-path=<value>путь</value></literal>&mdash;задаёт
 имя исполняемого файла nginx.
 Это имя используется только на стадии установки.
 По умолчанию файл называется
-<command>&lt;<value>prefix</value>&gt;/sbin/nginx</command>.
+<path><value>префикс</value>/sbin/nginx</path>.
 </para>
 </listitem>
 
 <listitem>
 <para>
-<command>--conf-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
-имя конфигурационного файла <command>nginx.conf</command>.
+<literal>--conf-path=<value>путь</value></literal>&mdash;задаёт
+имя конфигурационного файла <path>nginx.conf</path>.
 При желании nginx можно всегда запустить с другим конфигурационным файлом,
 указав его в параметре командной строки
-<nobr><command>-c &lt;<value>файл</value>&gt;</command></nobr>.
+<nobr><literal>-c <value>файл</value></literal></nobr>.
 По умолчанию файл называется
-<command>&lt;<value>prefix</value>&gt;/conf/nginx.conf</command>.
+<path><value>префикс</value>/conf/nginx.conf</path>.
 </para>
 </listitem>
 
 <listitem>
 <para>
-<command>--pid-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
+<literal>--pid-path=<value>путь</value></literal>&mdash;задаёт
 имя файла nginx.pid, в котором будет храниться номер главного процесса.
 После установки имя файла можно всегда поменять в конфигурационном
-файле <command>nginx.conf</command> с помощью директивы
+файле <path>nginx.conf</path> с помощью директивы
 <link doc="ngx_core_module.xml" id="pid"/>.
 По умолчанию имя
-файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/nginx.pid</command>.
+файла&mdash;<path><value>префикс</value>/logs/nginx.pid</path>.
 </para>
 </listitem>
 
 <listitem>
 <para>
-<command>--error-log-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
+<literal>--error-log-path=<value>путь</value></literal>&mdash;задаёт
 имя основного файла ошибок, предупреждений и диагностики.
 После установки имя файла можно всегда поменять в конфигурационном
-файле <command>nginx.conf</command> с помощью директивы
+файле <path>nginx.conf</path> с помощью директивы
 <link doc="ngx_core_module.xml" id="error_log"/>.
 По умолчанию имя
-файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/error.log</command>.
+файла&mdash;<path><value>префикс</value>/logs/error.log</path>.
 </para>
 </listitem>
 
 <listitem>
 <para>
-<command>--http-log-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
+<literal>--http-log-path=<value>путь</value></literal>&mdash;задаёт
 имя основного файла регистрации запросов HTTP-сервера.
 После установки имя файла можно всегда поменять в конфигурационном
-файле <command>nginx.conf</command> с помощью директивы
+файле <path>nginx.conf</path> с помощью директивы
 <link doc="http/ngx_http_log_module.xml" id="access_log"/>.
 По умолчанию имя
-файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/access.log</command>.
+файла&mdash;<path><value>префикс</value>/logs/access.log</path>.
 </para>
 </listitem>
 
 <listitem>
 <para>
-<command>--user=&lt;<value>имя</value>&gt;</command>&mdash;задаёт
+<literal>--user=<value>имя</value></literal>&mdash;задаёт
 имя непривилегированного пользователя, с правами которого будут
 выполняться рабочие процессы.
 После установки это имя можно всегда поменять в конфигурационном
-файле <command>nginx.conf</command> с помощью директивы
+файле <path>nginx.conf</path> с помощью директивы
 <link doc="ngx_core_module.xml" id="user"/>.
 По умолчанию имя пользователя nobody.
 </para>
@@ -97,10 +97,10 @@
 
 <listitem>
 <para>
-<command>--group=&lt;<value>имя</value>&gt;</command>&mdash;задаёт
+<literal>--group=<value>имя</value></literal>&mdash;задаёт
 имя группы, с правами которой будут выполняться рабочие процессы.
 После установки это имя можно всегда поменять в конфигурационном
-файле <command>nginx.conf</command> с помощью директивы
+файле <path>nginx.conf</path> с помощью директивы
 <link doc="ngx_core_module.xml" id="user"/>.
 По умолчанию группа совпадает с именем непривилегированного пользователя.
 </para>
@@ -108,8 +108,8 @@
 
 <listitem>
 <para>
-<command>--with-select_module</command><br/>
-<command>--without-select_module</command>&mdash;разрешает или запрещает
+<literal>--with-select_module</literal><br/>
+<literal>--without-select_module</literal>&mdash;разрешает или запрещает
 сборку модуля для работы сервера с помощью метода <c-func>select</c-func>.
 Этот модуль собирается автоматически, если на платформе не обнаружено
 более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
@@ -118,8 +118,8 @@
 
 <listitem>
 <para>
-<command>--with-poll_module</command><br/>
-<command>--without-poll_module</command>&mdash;разрешает или запрещает
+<literal>--with-poll_module</literal><br/>
+<literal>--without-poll_module</literal>&mdash;разрешает или запрещает
 сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>.
 Этот модуль собирается автоматически, если на платформе не обнаружено
 более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
@@ -128,7 +128,7 @@
 
 <listitem>
 <para>
-<command>--without-http_gzip_module</command>&mdash;запрещает сборку модуля
+<literal>--without-http_gzip_module</literal>&mdash;запрещает сборку модуля
 <link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера.
 Для сборки и работы этого модуля нужна библиотека zlib.
 </para>
@@ -136,7 +136,7 @@
 
 <listitem>
 <para>
-<command>--without-http_rewrite_module</command>&mdash;запрещает сборку модуля
+<literal>--without-http_rewrite_module</literal>&mdash;запрещает сборку модуля
 HTTP-сервера, позволяющего <link doc="http/ngx_http_rewrite_module.xml">делать
 перенаправления и менять URI запросов</link>.
 Для сборки и работы этого модуля нужна библиотека PCRE.
@@ -146,7 +146,7 @@
 
 <listitem>
 <para>
-<command>--without-http_proxy_module</command>&mdash;запрещает сборку
+<literal>--without-http_proxy_module</literal>&mdash;запрещает сборку
 <link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link>
 HTTP-сервера.
 <!--
@@ -157,7 +157,7 @@
 
 <listitem>
 <para>
-<command>--with-http_ssl_module</command>&mdash;разрешает сборку модуля
+<literal>--with-http_ssl_module</literal>&mdash;разрешает сборку модуля
 для работы HTTP-сервера по <link doc="http/ngx_http_ssl_module.xml">протоколу
 HTTPS</link>.
 По умолчанию модуль не собирается.
@@ -167,7 +167,7 @@
 
 <listitem>
 <para>
-<command>--with-pcre=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
+<literal>--with-pcre=<value>путь</value></literal>&mdash;задаёт
 путь к исходным текстам библиотеки PCRE.
 Дистрибутив библиотеки (версию
 4.4&mdash;6.1) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link>
@@ -182,7 +182,7 @@
 
 <listitem>
 <para>
-<command>--with-zlib=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
+<literal>--with-zlib=<value>путь</value></literal>&mdash;задаёт
 путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию
 1.1.3&mdash;1.2.2) нужно взять на сайте
 <link url="http://www.gzip.org/zlib/">zlib</link> и распаковать.
@@ -194,22 +194,22 @@
 
 <listitem>
 <para>
-<command>--with-cc-opt=&lt;<value>параметры</value>&gt;</command>&mdash;задаёт
+<literal>--with-cc-opt=<value>параметры</value></literal>&mdash;задаёт
 дополнительные параметры, которые будут добавлены к переменной CFLAGS.
 При использовании системной библиотеки PCRE во FreeBSD, нужно указать
-<command>--with-cc-opt="-I /usr/local/include"</command>.
+<literal>--with-cc-opt="-I /usr/local/include"</literal>.
 Если нужно увеличить число файлов, с которыми может работать
 <c-func>select</c-func>, то это тоже можно задать здесь же:
-<command>--with-cc-opt="-D FD_SETSIZE=2048"</command>.
+<literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>.
 </para>
 </listitem>
 
 <listitem>
 <para>
-<command>--with-ld-opt=&lt;<value>параметры</value>&gt;</command>&mdash;задаёт
+<literal>--with-ld-opt=<value>параметры</value></literal>&mdash;задаёт
 дополнительные параметры, которые будут использованы при линковке.
 При использовании системной библиотеки PCRE во FreeBSD, нужно указать
-<command>--with-ld-opt="-L /usr/local/lib"</command>.
+<literal>--with-ld-opt="-L /usr/local/lib"</literal>.
 </para>
 </listitem>