diff xml/en/docs/http/ngx_http_index_module.xml @ 153:317ac898ba50

Initial translation of the "ngx_http_index_module" and "ngx_http_random_index_module".
author Ruslan Ermilov <ru@nginx.com>
date Wed, 26 Oct 2011 08:37:48 +0000
parents
children bfe3eff81d04
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/en/docs/http/ngx_http_index_module.xml	Wed Oct 26 08:37:48 2011 +0000
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
+
+<module name="Module ngx_http_index_module"
+        link="/en/docs/http/ngx_http_index_module.html"
+        lang="en">
+
+<section id="summary">
+
+<para>
+The module <code>ngx_http_index_module</code> processes requests
+ending with the slash character (‘<code>/</code>’).
+</para>
+
+</section>
+
+
+<section name="Example Configuration" id="example">
+
+<para>
+<example>
+    location / {
+        index index.$geo.html index.html;
+    }
+</example>
+</para>
+
+</section>
+
+
+<section name="Directives" id="directives">
+
+<directive name="index">
+<syntax><argument>file</argument>...</syntax>
+<default>index.html</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Defines files that will be used as an index.
+The <argument>file</argument> name can contain variables.
+Files are checked in the specified order.
+The last element of the list can be a file with an absolute path.
+Example:
+<example>
+    index index.$geo.html index.0.html /index.html;
+</example>
+</para>
+
+<para>
+It should be noted that when using an index file, an internal redirect
+is made, and request can be processed in a different location.
+For example, with the following configuration:
+<example>
+    location = / {
+        index index.html;
+    }
+
+    location / {
+        ...
+    }
+</example>
+a request of “<code>/</code>” will actually be processed in the
+second location as “<code>/index.html</code>”.
+</para>
+
+</directive>
+
+</section>
+
+</module>