Mercurial > hg > nginx-site
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=<<value>путь</value>></command>—задаёт каталог, +<literal>--prefix=<value>путь</value></literal>—задаёт каталог, в котором будут находиться файлы сервера. Этот же каталог будет использоваться для всех относительных путей, -задаваемых <command>./configure</command> (кроме путей к исходным текстам -библиотек) и в конфигурационном файле <command>nginx.conf</command>. -По умолчанию—каталог <command>/usr/local/nginx</command>. +задаваемых <command>configure</command> (кроме путей к исходным текстам +библиотек) и в конфигурационном файле <path>nginx.conf</path>. +По умолчанию—каталог <path>/usr/local/nginx</path>. </para> </listitem> <listitem> <para> -<command>--sbin-path=<<value>путь</value>></command>—задаёт +<literal>--sbin-path=<value>путь</value></literal>—задаёт имя исполняемого файла nginx. Это имя используется только на стадии установки. По умолчанию файл называется -<command><<value>prefix</value>>/sbin/nginx</command>. +<path><value>префикс</value>/sbin/nginx</path>. </para> </listitem> <listitem> <para> -<command>--conf-path=<<value>путь</value>></command>—задаёт -имя конфигурационного файла <command>nginx.conf</command>. +<literal>--conf-path=<value>путь</value></literal>—задаёт +имя конфигурационного файла <path>nginx.conf</path>. При желании nginx можно всегда запустить с другим конфигурационным файлом, указав его в параметре командной строки -<nobr><command>-c <<value>файл</value>></command></nobr>. +<nobr><literal>-c <value>файл</value></literal></nobr>. По умолчанию файл называется -<command><<value>prefix</value>>/conf/nginx.conf</command>. +<path><value>префикс</value>/conf/nginx.conf</path>. </para> </listitem> <listitem> <para> -<command>--pid-path=<<value>путь</value>></command>—задаёт +<literal>--pid-path=<value>путь</value></literal>—задаёт имя файла nginx.pid, в котором будет храниться номер главного процесса. После установки имя файла можно всегда поменять в конфигурационном -файле <command>nginx.conf</command> с помощью директивы +файле <path>nginx.conf</path> с помощью директивы <link doc="ngx_core_module.xml" id="pid"/>. По умолчанию имя -файла—<command><<value>prefix</value>>/logs/nginx.pid</command>. +файла—<path><value>префикс</value>/logs/nginx.pid</path>. </para> </listitem> <listitem> <para> -<command>--error-log-path=<<value>путь</value>></command>—задаёт +<literal>--error-log-path=<value>путь</value></literal>—задаёт имя основного файла ошибок, предупреждений и диагностики. После установки имя файла можно всегда поменять в конфигурационном -файле <command>nginx.conf</command> с помощью директивы +файле <path>nginx.conf</path> с помощью директивы <link doc="ngx_core_module.xml" id="error_log"/>. По умолчанию имя -файла—<command><<value>prefix</value>>/logs/error.log</command>. +файла—<path><value>префикс</value>/logs/error.log</path>. </para> </listitem> <listitem> <para> -<command>--http-log-path=<<value>путь</value>></command>—задаёт +<literal>--http-log-path=<value>путь</value></literal>—задаёт имя основного файла регистрации запросов HTTP-сервера. После установки имя файла можно всегда поменять в конфигурационном -файле <command>nginx.conf</command> с помощью директивы +файле <path>nginx.conf</path> с помощью директивы <link doc="http/ngx_http_log_module.xml" id="access_log"/>. По умолчанию имя -файла—<command><<value>prefix</value>>/logs/access.log</command>. +файла—<path><value>префикс</value>/logs/access.log</path>. </para> </listitem> <listitem> <para> -<command>--user=<<value>имя</value>></command>—задаёт +<literal>--user=<value>имя</value></literal>—задаёт имя непривилегированного пользователя, с правами которого будут выполняться рабочие процессы. После установки это имя можно всегда поменять в конфигурационном -файле <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=<<value>имя</value>></command>—задаёт +<literal>--group=<value>имя</value></literal>—задаёт имя группы, с правами которой будут выполняться рабочие процессы. После установки это имя можно всегда поменять в конфигурационном -файле <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>—разрешает или запрещает +<literal>--with-select_module</literal><br/> +<literal>--without-select_module</literal>—разрешает или запрещает сборку модуля для работы сервера с помощью метода <c-func>select</c-func>. Этот модуль собирается автоматически, если на платформе не обнаружено более подходящего метода—kqueue, epoll, rtsig или /dev/poll. @@ -118,8 +118,8 @@ <listitem> <para> -<command>--with-poll_module</command><br/> -<command>--without-poll_module</command>—разрешает или запрещает +<literal>--with-poll_module</literal><br/> +<literal>--without-poll_module</literal>—разрешает или запрещает сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>. Этот модуль собирается автоматически, если на платформе не обнаружено более подходящего метода—kqueue, epoll, rtsig или /dev/poll. @@ -128,7 +128,7 @@ <listitem> <para> -<command>--without-http_gzip_module</command>—запрещает сборку модуля +<literal>--without-http_gzip_module</literal>—запрещает сборку модуля <link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера. Для сборки и работы этого модуля нужна библиотека zlib. </para> @@ -136,7 +136,7 @@ <listitem> <para> -<command>--without-http_rewrite_module</command>—запрещает сборку модуля +<literal>--without-http_rewrite_module</literal>—запрещает сборку модуля HTTP-сервера, позволяющего <link doc="http/ngx_http_rewrite_module.xml">делать перенаправления и менять URI запросов</link>. Для сборки и работы этого модуля нужна библиотека PCRE. @@ -146,7 +146,7 @@ <listitem> <para> -<command>--without-http_proxy_module</command>—запрещает сборку +<literal>--without-http_proxy_module</literal>—запрещает сборку <link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link> HTTP-сервера. <!-- @@ -157,7 +157,7 @@ <listitem> <para> -<command>--with-http_ssl_module</command>—разрешает сборку модуля +<literal>--with-http_ssl_module</literal>—разрешает сборку модуля для работы HTTP-сервера по <link doc="http/ngx_http_ssl_module.xml">протоколу HTTPS</link>. По умолчанию модуль не собирается. @@ -167,7 +167,7 @@ <listitem> <para> -<command>--with-pcre=<<value>путь</value>></command>—задаёт +<literal>--with-pcre=<value>путь</value></literal>—задаёт путь к исходным текстам библиотеки PCRE. Дистрибутив библиотеки (версию 4.4—6.1) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link> @@ -182,7 +182,7 @@ <listitem> <para> -<command>--with-zlib=<<value>путь</value>></command>—задаёт +<literal>--with-zlib=<value>путь</value></literal>—задаёт путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию 1.1.3—1.2.2) нужно взять на сайте <link url="http://www.gzip.org/zlib/">zlib</link> и распаковать. @@ -194,22 +194,22 @@ <listitem> <para> -<command>--with-cc-opt=<<value>параметры</value>></command>—задаёт +<literal>--with-cc-opt=<value>параметры</value></literal>—задаёт дополнительные параметры, которые будут добавлены к переменной 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=<<value>параметры</value>></command>—задаёт +<literal>--with-ld-opt=<value>параметры</value></literal>—задаёт дополнительные параметры, которые будут использованы при линковке. При использовании системной библиотеки PCRE во FreeBSD, нужно указать -<command>--with-ld-opt="-L /usr/local/lib"</command>. +<literal>--with-ld-opt="-L /usr/local/lib"</literal>. </para> </listitem>