Mercurial > hg > nginx-site
changeset 79:0a45870d0160
Fixed cross-document links to use doc and id.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Wed, 12 Oct 2011 15:47:58 +0000 |
parents | 78def4689ff7 |
children | 0f1b206eb401 |
files | xml/ru/docs/control.xml xml/ru/docs/hash.xml xml/ru/docs/http/ngx_http_core_module.xml xml/ru/docs/http/ngx_http_dav_module.xml xml/ru/docs/http/ngx_http_fastcgi_module.xml xml/ru/docs/http/ngx_http_gzip_module.xml xml/ru/docs/http/ngx_http_gzip_static_module.xml xml/ru/docs/http/ngx_http_log_module.xml xml/ru/docs/http/ngx_http_perl_module.xml xml/ru/docs/http/ngx_http_proxy_module.xml xml/ru/docs/http/ngx_http_rewrite_module.xml xml/ru/docs/http/ngx_http_ssl_module.xml xml/ru/docs/http/ngx_http_upstream.xml xml/ru/docs/ngx_core_module.xml |
diffstat | 14 files changed, 48 insertions(+), 37 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/ru/docs/control.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/control.xml Wed Oct 12 15:47:58 2011 +0000 @@ -11,7 +11,7 @@ записывается в файл <command>/usr/local/nginx/logs/nginx.pid</command>. Изменить имя этого файла можно при конфигурации сборки или же в <command>nginx.conf</command> директивой -<link doc="ngx_core_module.xml#pid">pid</link>. +<link doc="ngx_core_module.xml" id="pid">pid</link>. Главный процесс поддерживает следующие сигналы: <note> <table>
--- a/xml/ru/docs/hash.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/hash.xml Wed Oct 12 15:47:58 2011 +0000 @@ -19,8 +19,8 @@ hash max size. Для большинства хэшей есть директивы, которые позволяют менять эти параметры, например, для хэшей имён серверов директивы называются -<link doc="http/ngx_http_core_module.xml#server_names_hash_max_size">server_names_hash_max_size</link> -и <link doc="http/ngx_http_core_module.xml#server_names_hash_bucket_size">server_names_hash_bucket_size</link>. +<link doc="http/ngx_http_core_module.xml" id="server_names_hash_max_size">server_names_hash_max_size</link> +и <link doc="http/ngx_http_core_module.xml" id="server_names_hash_bucket_size">server_names_hash_bucket_size</link>. </para> <para>
--- a/xml/ru/docs/http/ngx_http_core_module.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/http/ngx_http_core_module.xml Wed Oct 12 15:47:58 2011 +0000 @@ -164,7 +164,8 @@ <para> Директива определяет, сохранять ли всё тело запроса клиента в файл. Директиву можно использовать для отладки и при использовании -переменной $request_body_file или метода <link doc="ngx_http_perl_module.xml#methods">$r->request_body_file</link> +переменной $request_body_file или метода +<link doc="ngx_http_perl_module.xml" id="methods">$r->request_body_file</link> модуля ngx_http_perl_module. </para> @@ -534,7 +535,8 @@ <para> Директива ограничивает HTTP-методы, доступные внутри location. Метод GET также включает в себя метод HEAD. -Для ограничения могут использоваться директивы модулей <link doc="ngx_http_access_module.xml">ngx_http_access_module</link> +Для ограничения могут использоваться директивы модулей +<link doc="ngx_http_access_module.xml">ngx_http_access_module</link> и <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>: <example> limit_except GET { @@ -838,7 +840,8 @@ <context>http, server, location</context> <para> -Директива разрешает или запрещает записывать в <link doc="ngx_http_log_module.xml#access_log">access_log</link> +Директива разрешает или запрещает записывать в +<link doc="ngx_http_log_module.xml" id="access_log">access_log</link> подзапросы. </para> @@ -1756,8 +1759,8 @@ <listitem> $request_body, эта переменная содержит тело запроса. Значение переменной появляется в location'ах, обрабатываемых директивами -<link doc="ngx_http_proxy_module.xml#proxy_pass">proxy_pass</link> -и <link doc="ngx_http_fastcgi_module.xml#fastcgi_pass">fastcgi_pass</link>. +<link doc="ngx_http_proxy_module.xml" id="proxy_pass">proxy_pass</link> +и <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass">fastcgi_pass</link>. </listitem> <listitem> @@ -1765,7 +1768,7 @@ хранится тело запроса. По завершению работы файл необходимо удалить. Для того, чтобы тело запроса клиента всегда записывалось в файл, нужно -указать <link doc="ngx_http_core_module.xml#client_body_in_file_only">client_body_in_file_only on</link>. +указать <link doc="ngx_http_core_module.xml" id="client_body_in_file_only">client_body_in_file_only on</link>. При передаче имени в проксированном запросе или в запросе к FastCGI-серверу следует запретить передачу самого тела директивами "proxy_pass_request_body off" или
--- a/xml/ru/docs/http/ngx_http_dav_module.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/http/ngx_http_dav_module.xml Wed Oct 12 15:47:58 2011 +0000 @@ -86,7 +86,8 @@ что в этом случае вместо дешёвой операции переименовывания в пределах одной файловой системы файл копируется с одной файловой системы на другую. Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой -системе, что и каталог с временными файлами, задаваемый директивой <link doc="ngx_http_core_module.xml#client_body_temp_path">client_body_temp_path</link> +системе, что и каталог с временными файлами, задаваемый директивой +<link doc="ngx_http_core_module.xml" id="client_body_temp_path">client_body_temp_path</link> для данного location. </para>
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml Wed Oct 12 15:47:58 2011 +0000 @@ -561,8 +561,8 @@ <para> Директива разрешает сохранение на диск файлов. Параметр "on" сохраняет файлы в соответствии с путями, указаными в директивах -<link doc="ngx_http_core_module.xml#alias">alias</link> или -<link doc="ngx_http_core_module.xml#root">root</link>. +<link doc="ngx_http_core_module.xml" id="alias">alias</link> или +<link doc="ngx_http_core_module.xml" id="root">root</link>. Параметр "off" запрещает сохранение файлов. Кроме того, имя файла можно явно задать с помощью строки с переменными: <example>
--- a/xml/ru/docs/http/ngx_http_gzip_module.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/http/ngx_http_gzip_module.xml Wed Oct 12 15:47:58 2011 +0000 @@ -204,7 +204,7 @@ Разрешает или запрещает выдавать в ответе строку заголовка "Vary: Accept-Encoding", если директивы <link id="gzip"/> или -<link doc="ngx_http_gzip_static_module.xml#gzip_static">gzip_static</link> +<link doc="ngx_http_gzip_static_module.xml" id="gzip_static">gzip_static</link> активны. </para>
--- a/xml/ru/docs/http/ngx_http_gzip_static_module.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/http/ngx_http_gzip_static_module.xml Wed Oct 12 15:47:58 2011 +0000 @@ -44,10 +44,10 @@ <para> Разрешает или запрещает проверку готового сжатого файла. При использовании также учитываются директивы -<link doc="ngx_http_gzip_module.xml#gzip_http_version">gzip_http_version</link>, -<link doc="ngx_http_gzip_module.xml#gzip_proxied">gzip_proxied</link>, -<link doc="ngx_http_gzip_module.xml#gzip_disable">gzip_disable</link> -и <link doc="ngx_http_gzip_module.xml#gzip_vary">gzip_vary</link>. +<link doc="ngx_http_gzip_module.xml" id="gzip_http_version">gzip_http_version</link>, +<link doc="ngx_http_gzip_module.xml" id="gzip_proxied">gzip_proxied</link>, +<link doc="ngx_http_gzip_module.xml" id="gzip_disable">gzip_disable</link> +и <link doc="ngx_http_gzip_module.xml" id="gzip_vary">gzip_vary</link>. </para> <para>
--- a/xml/ru/docs/http/ngx_http_log_module.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/http/ngx_http_log_module.xml Wed Oct 12 15:47:58 2011 +0000 @@ -76,7 +76,7 @@ <listitem> при каждой записи в лог проверяется существование каталога root'а для запроса — если этот каталог не существует, то лог не создаётся. -Поэтому <link doc="ngx_http_core_module.xml#root">root</link> +Поэтому <link doc="ngx_http_core_module.xml" id="root">root</link> и access_log нужно описывать на одном уровне: <example> server {
--- a/xml/ru/docs/http/ngx_http_perl_module.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/http/ngx_http_perl_module.xml Wed Oct 12 15:47:58 2011 +0000 @@ -55,7 +55,7 @@ будет увеличиваться в размерах при каждой переконфигурации. Когда основной процесс вырастет до неприемлемых размеров, можно воспользоваться процедурой -<link doc="../control.html#upgrade">обновления сервера на лету</link>, +<link doc="../control.html" id="upgrade">обновления сервера на лету</link>, не меняя при этом сам исполняемый файл. </para> @@ -352,9 +352,10 @@ <emphasis>$r->request_body</emphasis> — метод возвращает тело запроса клиента при условии, что тело не записано во временный файл. Для того, чтобы тело запроса клиента гарантировано находилось в памяти, -нужно ограничить его размер с помощью <link doc="ngx_http_core_module.xml#client_max_body_size">client_max_body_size</link> +нужно ограничить его размер с помощью +<link doc="ngx_http_core_module.xml" id="client_max_body_size">client_max_body_size</link> и задать достаточной размер для буфера -<link doc="ngx_http_core_module.xml#client_body_buffer_size">client_body_buffer_size</link>. +<link doc="ngx_http_core_module.xml" id="client_body_buffer_size">client_body_buffer_size</link>. </listitem> <listitem> @@ -362,7 +363,7 @@ в котором хранится тело запроса клиента. По завершению работы файл необходимо удалить. Для того, чтобы тело запроса клиента всегда записывалось в файл, нужно -указать <link doc="ngx_http_core_module.xml#client_body_in_file_only">client_body_in_file_only on</link>. +указать <link doc="ngx_http_core_module.xml" id="client_body_in_file_only">client_body_in_file_only on</link>. </listitem> <listitem> @@ -385,7 +386,8 @@ Собственно передача данных происходит уже после завершения perl'ового обработчика. Необходимо учитывать, что при использовании -этого метода в подзапросе и директиве <link doc="ngx_http_core_module.xml#sendfile">sendfile on</link> +этого метода в подзапросе и директиве +<link doc="ngx_http_core_module.xml" id="sendfile">sendfile on</link> содержимое файла не будет проходить через <link doc="ngx_http_gzip_module.xml">gzip</link>, <link doc="ngx_http_ssi_module.xml">SSI</link> и
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/http/ngx_http_proxy_module.xml Wed Oct 12 15:47:58 2011 +0000 @@ -504,7 +504,8 @@ <para> В этом случае имя сервера ищется среди описанных <link doc="ngx_http_upstream.xml">групп серверов</link> -и если не найдено, то определяется с помощью <link doc="ngx_http_core_module.xml#resolver">resolver'а</link>. +и если не найдено, то определяется с помощью +<link doc="ngx_http_core_module.xml" id="resolver">resolver'а</link>. </para> </directive> @@ -718,8 +719,8 @@ <para> Директива разрешает сохранение на диск файлов. Параметр "on" сохраняет файлы в соответствии с путями, указаными в директивах -<link doc="ngx_http_core_module.xml#alias">alias</link> или -<link doc="ngx_http_core_module.xml#root">root</link>. +<link doc="ngx_http_core_module.xml" id="alias">alias</link> или +<link doc="ngx_http_core_module.xml" id="root">root</link>. Параметр "off" запрещает сохранение файлов. Кроме того, имя файла можно явно задать с помощью строки с переменными: <example>
--- a/xml/ru/docs/http/ngx_http_rewrite_module.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/http/ngx_http_rewrite_module.xml Wed Oct 12 15:47:58 2011 +0000 @@ -128,7 +128,8 @@ return 403; } </example> -Значение встроенной переменной $invalid_referer задаётся директивой <link doc="ngx_http_referer_module.xml#valid_referers">valid_referers</link>. +Значение встроенной переменной $invalid_referer задаётся директивой +<link doc="ngx_http_referer_module.xml" id="valid_referers">valid_referers</link>. </para> </directive>
--- a/xml/ru/docs/http/ngx_http_ssl_module.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/http/ngx_http_ssl_module.xml Wed Oct 12 15:47:58 2011 +0000 @@ -129,7 +129,7 @@ } </example> иначе для второго сайта будет выдаваться -<link doc="../faq.xml#name_based_vhost_ssl">сертификат +<link doc="../faq.xml" id="name_based_vhost_ssl">сертификат первого сервера</link>. </para> @@ -333,7 +333,8 @@ <para> Модуль ngx_http_ssl_module поддерживает несколько нестандартных кодов ошибок, -которые можно использовать для перенаправления с помощью директивы <link doc="ngx_http_core_module.xml#error_page">error_page</link>: +которые можно использовать для перенаправления с помощью директивы +<link doc="ngx_http_core_module.xml" id="error_page">error_page</link>: <list type="bullet"> <listitem> @@ -374,7 +375,8 @@ $ssl_client_cert возвращает клиентский сертификат для установленного SSL-соединения в формате PEM перед каждой строкой которого, кроме первой, вставляется символ табуляции; -предназачен для использования в директиве <link doc="ngx_http_proxy_module.xml#proxy_set_header">proxy_set_header</link>. +предназачен для использования в директиве +<link doc="ngx_http_proxy_module.xml" id="proxy_set_header">proxy_set_header</link>. </listitem> <listitem>
--- a/xml/ru/docs/http/ngx_http_upstream.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/http/ngx_http_upstream.xml Wed Oct 12 15:47:58 2011 +0000 @@ -11,8 +11,8 @@ <para> Модуль позволяет описывать группы серверов, которые могут использоваться в директивах -<link doc="ngx_http_proxy_module.xml#proxy_pass">proxy_pass</link> -и <link doc="ngx_http_fastcgi_module.xml#fastcgi_pass">fastcgi_pass</link>. +<link doc="ngx_http_proxy_module.xml" id="proxy_pass">proxy_pass</link> +и <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass">fastcgi_pass</link>. </para> </section> @@ -107,8 +107,8 @@ По умолчанию число попыток равно одной. Нулевое значение запрещает учёт попыток. Что считается неудачной попыткой, задаётся директивами -<link doc="ngx_http_proxy_module.xml#proxy_next_upstream">proxy_next_upstream</link> -и <link doc="ngx_http_fastcgi_module.xml#fastcgi_next_upstream">fastcgi_next_upstream</link>. +<link doc="ngx_http_proxy_module.xml" id="proxy_next_upstream">proxy_next_upstream</link> +и <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_next_upstream">fastcgi_next_upstream</link>. Состояние http_404 не считается неудачной попыткой. </listitem>
--- a/xml/ru/docs/ngx_core_module.xml Wed Oct 12 05:36:20 2011 +0000 +++ b/xml/ru/docs/ngx_core_module.xml Wed Oct 12 15:47:58 2011 +0000 @@ -55,12 +55,13 @@ <list type="bullet"> <listitem> -наследование переменных во время <link doc="../control.xml#upgrade">обновления исполняемого файла -на лету</link>; +наследование переменных во время +<link doc="control.xml" id="upgrade">обновления исполняемого файла на лету</link>; </listitem> <listitem> -использование переменных модулем <link doc="ngx_http_perl_module.xml">ngx_http_perl_module</link>; +использование переменных модулем +<link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>; </listitem> <listitem>