diff xml/ru/docs/example.xml @ 76:4a4caa566120

Russian documentation import. Changes in module.dtd: <example> now allowed to contain <value> and <emphasis> elements (we need this to show important parts in examples), less strict checking of <directive> syntax (we don't want to fully document some directives, notably deprecated ones). Known issues: 1. <syntax> elements are preserved as is, they will require manual conversion (likely to some not-yet-existed format a la DocBook cmdsynopsis, as currently used one seems to be incomplete); 2. <value> no longer corresponds to replaceable content, and it's use in examples isn't correct; 3. <link doc="document#fragment"> doesn't work with current xslt, either should be supported or changed to <link doc="document" id="fragment">. The following files are intentionally omitted: maillists.xml (support.xml should be used instead), experimental.xml (obsolete), faq.xml (conflicts with existing one, needs discussion). Not yet linked to site.
author Maxim Dounin <mdounin@mdounin.ru>
date Tue, 11 Oct 2011 12:57:50 +0000
parents
children 7db449e89e92
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/ru/docs/example.xml	Tue Oct 11 12:57:50 2011 +0000
@@ -0,0 +1,159 @@
+<!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
+
+<article title="Пример конфигурации nginx"
+         link="/ru/docs/example.html"
+         lang="ru">
+
+<section>
+
+<para>
+Пример конфигурации сайта, который передаёт все запросы бэкенду, кроме
+картинок и запросов, начинающихся с "/download/".
+<!--
+Директивы, выделенные цветом, скорее всего, будут меняться в будущих версиях.
+-->
+<programlisting>
+user  www www;
+
+worker_processes  2;
+
+pid /var/run/nginx.pid;
+
+#                          [ debug | info | notice | warn | error | crit ]
+
+error_log  /var/log/nginx.error_log  info;
+
+events {
+    connections   2000;
+
+    # use [ kqueue | rtsig | epoll | /dev/poll | select | poll ];
+    use kqueue;
+}
+
+http {
+
+    include       conf/mime.types;
+    default_type  application/octet-stream;
+
+
+    log_format main      '$remote_addr - $remote_user [$time_local] '
+                         '"$request" $status $bytes_sent '
+                         '"$http_referer" "$http_user_agent" '
+                         '"$gzip_ratio"';
+
+    log_format download  '$remote_addr - $remote_user [$time_local] '
+                         '"$request" $status $bytes_sent '
+                         '"$http_referer" "$http_user_agent" '
+                         '"$http_range" "$sent_http_content_range"';
+
+    client_header_timeout  3m;
+    client_body_timeout    3m;
+    send_timeout           3m;
+<!--
+    connection_pool_size         256;
+-->
+    client_header_buffer_size    1k;
+    large_client_header_buffers  4 4k;
+<!--
+    request_pool_size            4k;
+-->
+    gzip on;
+    gzip_min_length  1100;
+    gzip_buffers     4 8k;
+    gzip_types       text/plain;
+
+    output_buffers   1 32k;
+    postpone_output  1460;
+
+    sendfile         on;
+    tcp_nopush       on;
+    tcp_nodelay      on;
+    send_lowat       12000;
+
+    keepalive_timeout  75 20;
+
+    #lingering_time     30;
+    #lingering_timeout  10;
+    #reset_timedout_connection  on;
+
+
+    server {
+        listen        one.example.com;
+        server_name   one.example.com  www.one.example.com;
+
+        access_log   /var/log/nginx.access_log  main;
+
+        location / {
+            proxy_pass         http://127.0.0.1/;
+            proxy_redirect     off;
+
+            proxy_set_header   Host             $host;
+            proxy_set_header   X-Real-IP        $remote_addr;
+            #proxy_set_header  X-Forwarded-For  $proxy_add_x_forwarded_for;
+
+            client_max_body_size       10m;
+            client_body_buffer_size    128k;
+
+            client_body_temp_path      /var/nginx/client_body_temp;
+
+            proxy_connect_timeout      70;
+            proxy_send_timeout         90;
+            proxy_read_timeout         90;
+            proxy_send_lowat           12000;
+
+            proxy_buffer_size          4k;
+            proxy_buffers              4 32k;
+            proxy_busy_buffers_size    64k;
+            proxy_temp_file_write_size 64k;
+
+            proxy_temp_path            /var/nginx/proxy_temp;
+
+            charset  koi8-r;
+        }
+
+        error_page  404  /404.html;
+
+        location /404.html {
+            root  /spool/www;
+
+            charset         on;
+            source_charset  koi8-r;
+        }
+
+        location /old_stuff/ {
+            rewrite   ^/old_stuff/(.*)$  /new_stuff/$1  permanent;
+        }
+
+        location /download/ {
+
+            valid_referers  none  blocked  server_names  *.example.com;
+
+            if ($invalid_referer) {
+                #rewrite   ^/   http://www.example.com/;
+                return   403;
+            }
+
+            #rewrite_log  on;
+
+            # rewrite /download/*/mp3/*.any_ext to /download/*/mp3/*.mp3
+            rewrite ^/(download/.*)/mp3/(.*)\..*$
+                    /$1/mp3/$2.mp3                   break;
+
+            root         /spool/www;
+            #autoindex    on;
+            access_log   /var/log/nginx-download.access_log  download;
+        }
+
+        location ~* \.(jpg|jpeg|gif)$ {
+            root         /spool/www;
+            access_log   off;
+            expires      30d;
+        }
+    }
+}
+</programlisting>
+</para>
+
+</section>
+
+</article>