Mercurial > hg > nginx-site

changeset 1826:da6a3e401b26

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Slightly reformatted the error_page description. Information about directives inheritance was moved to the end. Blocks describing various syntaxes of the "uri" argument were put in the following order: - internal redirect to the specified /uri; - internal redirect to a named location; - URL redirection.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 24 Oct 2016 11:57:46 +0300
parents 56b6244ddadb
children 64e2b8c5200d
files xml/en/docs/http/ngx_http_core_module.xml xml/ru/docs/http/ngx_http_core_module.xml
diffstat 2 files changed, 41 insertions(+), 35 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_core_module.xml	Mon Oct 24 11:49:51 2016 +0300
+++ b/xml/en/docs/http/ngx_http_core_module.xml	Mon Oct 24 11:57:46 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_core_module"
         link="/en/docs/http/ngx_http_core_module.html"
         lang="en"
-        rev="61">
+        rev="62">
 
 <section id="directives" name="Directives">
 
@@ -611,10 +611,7 @@
 
 <para>
 Defines the URI that will be shown for the specified errors.
-<literal>error_page</literal> directives are inherited from the previous
-level only if there are no <literal>error_page</literal>
-directives defined on the current level.
-A <literal>uri</literal> value can contain variables.
+A <value>uri</value> value can contain variables.
 </para>
 
 <para>
@@ -644,17 +641,6 @@
 </para>
 
 <para>
-It is also possible to use redirects for error processing:
-<example>
-error_page 403      http://example.com/forbidden.html;
-error_page 404 =301 http://example.com/notfound.html;
-</example>
-In this case, by default, the response code 302 is returned to the client.
-It can only be changed to one of the redirect status
-codes (301, 302, 303, and 307).
-</para>
-
-<para>
 If there is no need to change URI during internal redirection it is
 possible to pass error processing into a named location:
 <example>
@@ -670,11 +656,29 @@
 
 <para>
 <note>
-If <literal>uri</literal> processing leads to an error,
+If <value>uri</value> processing leads to an error,
 the status code of the last occurred error is returned to the client.
 </note>
 </para>
 
+<para>
+It is also possible to use URL redirects for error processing:
+<example>
+error_page 403      http://example.com/forbidden.html;
+error_page 404 =301 http://example.com/notfound.html;
+</example>
+In this case, by default, the response code 302 is returned to the client.
+It can only be changed to one of the redirect status
+codes (301, 302, 303, and 307).
+</para>
+
+<para>
+These directives are inherited from the previous level if and
+only if there are no
+<literal>error_page</literal>
+directives defined on the current level.
+</para>
+
 </directive>
 
 
--- a/xml/ru/docs/http/ngx_http_core_module.xml	Mon Oct 24 11:49:51 2016 +0300
+++ b/xml/ru/docs/http/ngx_http_core_module.xml	Mon Oct 24 11:57:46 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_core_module"
         link="/ru/docs/http/ngx_http_core_module.html"
         lang="ru"
-        rev="61">
+        rev="62">
 
 <section id="directives" name="Директивы">
 
@@ -608,10 +608,7 @@
 
 <para>
 Задаёт URI, который будет показываться для указанных ошибок.
-Директивы <literal>error_page</literal> наследуются с предыдущего уровня
-при условии, что на данном уровне не заданы свои директивы
-<literal>error_page</literal>.
-В значении <literal>uri</literal> можно использовать переменные.
+В значении <value>uri</value> можно использовать переменные.
 </para>
 
 <para>
@@ -640,18 +637,6 @@
 </para>
 
 <para>
-Также существует возможность использовать перенаправления для обработки
-ошибок:
-<example>
-error_page 403      http://example.com/forbidden.html;
-error_page 404 =301 http://example.com/notfound.html;
-</example>
-В этом случае по умолчанию клиенту возвращается код ответа 302.
-Его можно изменить только на один из кодов ответа, относящихся к
-перенаправлениям (301, 302, 303 и 307).
-</para>
-
-<para>
 Если при внутреннем перенаправлении не нужно менять URI, то можно передать
 обработку ошибки в именованный location:
 <example>
@@ -667,11 +652,28 @@
 
 <para>
 <note>
-Если при обработке <literal>uri</literal> происходит ошибка,
+Если при обработке <value>uri</value> происходит ошибка,
 клиенту возвращается ответ с кодом последней случившейся ошибки.
 </note>
 </para>
 
+<para>
+Также существует возможность использовать перенаправления URL для обработки
+ошибок:
+<example>
+error_page 403      http://example.com/forbidden.html;
+error_page 404 =301 http://example.com/notfound.html;
+</example>
+В этом случае по умолчанию клиенту возвращается код ответа 302.
+Его можно изменить только на один из кодов ответа, относящихся к
+перенаправлениям (301, 302, 303 и 307).
+</para>
+
+<para>
+Директивы наследуются с предыдущего уровня при условии, что на данном уровне
+не описаны свои директивы <literal>error_page</literal>.
+</para>
+
 </directive>