changeset 214:c99c8df86eb9

Translated the "Debugging Log" article into Russian.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 30 Nov 2011 09:20:19 +0000
parents 5284967934df
children abb48e50ff7f
files xml/menu.xml xml/ru/GNUmakefile xml/ru/docs/debugging_log.xml xml/ru/docs/howto.xml xml/ru/docs/index.xml
diffstat 5 files changed, 116 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- a/xml/menu.xml
+++ b/xml/menu.xml
@@ -112,7 +112,7 @@
 <item href="/en/security_advisories.html" lang="en"> безопасность </item>
 <item href="/ru/docs/"> документация </item>
 <item href="/en/docs/introduction.html" lang="en"> введение </item>
-<item href="/en/docs/howto.html" lang="en"> howto </item>
+<item href="/ru/docs/howto.html"> howto </item>
 <item href="/ru/docs/faq.html"> faq </item>
 <item href="/en/links.html" lang="en"> ссылки </item>
 <item href="/en/books.html" lang="en"> книги </item>
--- a/xml/ru/GNUmakefile
+++ b/xml/ru/GNUmakefile
@@ -1,6 +1,7 @@
 LANG =		ru
 
 DOCS =									\
+		howto							\
 		faq							\
 		install							\
 		windows							\
@@ -15,6 +16,12 @@ DOCS =									\
 DOCS_XML =	$(foreach name, $(DOCS), xml/$(LANG)/docs/$(name).xml)
 DOCS_HTML =	$(foreach name, $(DOCS), $(OUT)/$(LANG)/docs/$(name).html)
 
+HOWTO =									\
+		debugging_log						\
+
+HOWTO_XML =	$(foreach name, $(HOWTO), xml/$(LANG)/docs/$(name).xml)
+HOWTO_HTML =	$(foreach name, $(HOWTO), $(OUT)/$(LANG)/docs/$(name).html)
+
 FAQ =									\
 		sys_errlist						\
 
@@ -73,6 +80,7 @@ REFS_HTML =	$(foreach name, $(REFS), $(O
 		$(OUT)/$(LANG)/docs/index.html				\
 		$(DOCS_HTML)						\
 		$(REFS_HTML)						\
+		$(HOWTO_HTML)						\
 		$(FAQ_HTML)						\
 
 $(OUT)/$(LANG)/download.html:						\
@@ -80,5 +88,8 @@ REFS_HTML =	$(foreach name, $(REFS), $(O
 		$(DOWNLOAD_DEPS)
 	$(call XSLT, xslt/download.xslt, $<, $@)
 
+$(OUT)/$(LANG)/docs/howto.html:						\
+		$(HOWTO_XML)						\
+
 $(OUT)/$(LANG)/docs/faq.html:						\
 		$(FAQ_XML)						\
new file mode 100644
--- /dev/null
+++ b/xml/ru/docs/debugging_log.xml
@@ -0,0 +1,70 @@
+<!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
+
+<article name="Отладочный лог"
+         link="/ru/docs/debugging_log.html"
+         lang="ru">
+
+
+<section>
+
+<para>
+Чтобы включить отладочный лог, при сборке следует сконфигурировать nginx с
+поддержкой отладки:
+
+<programlisting>
+./configure --with-debug ...
+</programlisting>
+
+Затем нужно задать уровень <value>debug</value> с помощью
+директивы <link doc="ngx_core_module.xml" id="error_log"/>:
+
+<programlisting>
+error_log /path/to/log debug;
+</programlisting>
+
+Бинарная версия nginx для Windows всегда собирается с поддержкой отладочного
+лога, поэтому понадобится лишь задать уровень <value>debug</value>.
+</para>
+
+<para>
+Обратите внимание, что переопределение лога без одновременного указания
+уровня <value>debug</value> отключит отладочный лог.
+В примере ниже, переопределение лога на уровне
+<link doc="http/ngx_http_core_module.xml" id="server"/>
+отключает отладочный лог для этого сервера:
+<programlisting>
+error_log /path/to/log debug;
+
+http {
+    server {
+        error_log /path/to/log;
+        ...
+</programlisting>
+Чтобы избежать этого, следует либо закомментировать строку, переопределяющую
+лог, либо добавить определение уровня <value>debug</value>:
+<programlisting>
+error_log /path/to/log debug;
+
+http {
+    server {
+        error_log /path/to/log debug;
+        ...
+</programlisting>
+</para>
+
+<para>
+Можно включить отладочный лог только для определённых адресов:
+
+<programlisting>
+error_log /path/to/log;
+
+events {
+    debug_connection 192.168.1.1;
+    debug_connection 192.168.10.0/24;
+}
+</programlisting>
+</para>
+
+</section>
+
+</article>
new file mode 100644
--- /dev/null
+++ b/xml/ru/docs/howto.xml
@@ -0,0 +1,32 @@
+<!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
+
+<article name="nginx howto"
+         link="/ru/docs/howto.html"
+         lang="ru">
+
+
+<section>
+
+<para>
+<list>
+
+<item>
+<a href="/ru/docs/debugging_log.xml"/>
+</item>
+
+<!--
+<item>
+<a href="/ru/docs/http/converting_rewrite_rules.xml"/>
+</item>
+
+<item>
+<a href="/ru/docs/howto_build_on_win32.xml"/>
+</item>
+-->
+
+</list>
+</para>
+
+</section>
+
+</article>
--- a/xml/ru/docs/index.xml
+++ b/xml/ru/docs/index.xml
@@ -16,12 +16,12 @@
 <a href="/ru/docs/introduction.xml"/>
 </item>
 
+-->
+
 <item>
 <a href="/ru/docs/howto.xml"/>
 </item>
 
--->
-
 <item>
 <a href="/ru/docs/faq.xml"/>
 </item>