Mercurial > hg > nginx-site

comparison xml/cn/docs/http/ngx_http_random_index_module.xml @ 792:ceb8a4e374b7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Updated the Chinese documentation.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 25 Dec 2012 06:34:37 +0000
parents
children
comparison
equal deleted inserted replaced
791:15f2bab0740d 792:ceb8a4e374b7
1 <?xml version="1.0"?>
2
3 <!--
4 Copyright (C) Igor Sysoev
5 Copyright (C) Nginx, Inc.
6 -->
7
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9
10 <module name="Module ngx_http_random_index_module"
11 link="/en/docs/http/ngx_http_random_index_module.html"
12 lang="en"
13 rev="1">
14
15 <section id="summary">
16
17 <para>
18 The module <literal>ngx_http_random_index_module</literal> picks a random
19 file in a directory as an index file.
20 It works before the
21 <link doc="ngx_http_index_module.xml">ngx_http_index_module</link>
22 module.
23 </para>
24
25 <para>
26 This module is not built by default, it should be enabled with the
27 <literal>--with-http_random_index_module</literal>
28 configuration parameter.
29 </para>
30
31 </section>
32
33
34 <section id="example" name="Example Configuration">
35
36 <para>
37 <example>
38 location / {
39 random_index on;
40 }
41 </example>
42 </para>
43
44 </section>
45
46
47 <section id="directives" name="Directives">
48
49 <directive name="random_index">
50 <syntax><literal>on</literal> | <literal>off</literal></syntax>
51 <default>off</default>
52 <context>location</context>
53
54 <para>
55 Enables or disables module processing in a surrounding location.
56 </para>
57
58 </directive>
59
60 </section>
61
62 </module>