Mercurial > hg > nginx-site
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>