Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_autoindex_module.xml @ 2846:fdf1464e1977
Moved banner to the external file to make partial rollout possible.
An idea is to have several banners and show them with different probability
specified by split directive in the nginx.conf
author | Sergey Budnevitch <sb@waeme.net> |
---|---|
date | Tue, 10 May 2022 18:07:27 +0400 |
parents | 6866a74393e0 |
children |
rev | line source |
---|---|
222
bfe3eff81d04
Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents:
110
diff
changeset
|
1 <?xml version="1.0"?> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2 |
580
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
3 <!-- |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
4 Copyright (C) Igor Sysoev |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
5 Copyright (C) Nginx, Inc. |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
6 --> |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
7 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
9 |
303 | 10 <module name="Модуль ngx_http_autoindex_module" |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
11 link="/ru/docs/http/ngx_http_autoindex_module.html" |
589 | 12 lang="ru" |
1540
6866a74393e0
Added a hint about xslt transformation to autoindex_format.
Valentin Bartenev <vbart@nginx.com>
parents:
1374
diff
changeset
|
13 rev="4"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
14 |
110
40eec261c2a6
Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
15 <section id="summary"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
16 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
17 <para> |
724
0422511d9bee
Improved descriptions of indexing modules and mentioned others in index module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
18 Модуль <literal>ngx_http_autoindex_module</literal> обслуживает запросы, |
0422511d9bee
Improved descriptions of indexing modules and mentioned others in index module.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
19 оканчивающиеся слэшом (‘<literal>/</literal>’), и выдаёт листинг каталога. |
303 | 20 Обычно запрос попадает к модулю <literal>ngx_http_autoindex_module</literal>, |
21 когда модуль <link doc="ngx_http_index_module.xml">ngx_http_index_module</link> | |
22 не нашёл индексный файл. | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
23 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
24 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
25 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
26 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
27 |
303 | 28 <section id="example" name="Пример конфигурации"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
29 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
30 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
31 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
311
diff
changeset
|
32 location / { |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
311
diff
changeset
|
33 autoindex on; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
311
diff
changeset
|
34 } |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
35 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
36 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
37 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
38 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
39 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
40 |
303 | 41 <section id="directives" name="Директивы"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
42 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
43 <directive name="autoindex"> |
271 | 44 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
76
diff
changeset
|
45 <default>off</default> |
303 | 46 <context>http</context> |
47 <context>server</context> | |
48 <context>location</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
49 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
50 <para> |
303 | 51 Разрешает или запрещает вывод листинга каталога. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
52 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
53 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
54 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
55 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
56 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
57 <directive name="autoindex_exact_size"> |
271 | 58 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
76
diff
changeset
|
59 <default>on</default> |
303 | 60 <context>http</context> |
61 <context>server</context> | |
62 <context>location</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
63 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
64 <para> |
1374
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
65 Для <link id="autoindex_format">формата</link> HTML |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
66 определяет, как выводить размеры файлов в листинге |
966 | 67 каталога: точно или округляя до килобайт, мегабайт и гигабайт. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
68 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
69 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
70 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
71 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
72 |
1374
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
73 <directive name="autoindex_format"> |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
74 <syntax> |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
75 <literal>html</literal> | |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
76 <literal>xml</literal> | |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
77 <literal>json</literal> | |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
78 <literal>jsonp</literal></syntax> |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
79 <default>html</default> |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
80 <context>http</context> |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
81 <context>server</context> |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
82 <context>location</context> |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
83 <appeared-in>1.7.9</appeared-in> |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
84 |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
85 <para> |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
86 Задаёт формат вывода листинга каталога. |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
87 </para> |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
88 |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
89 <para> |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
90 При использовании формата JSONP имя callback-функции |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
91 задаётся в аргументе запроса <literal>callback</literal>. |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
92 Если аргумент отсутствует или имеет пустое значение, |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
93 то используется формат JSON. |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
94 </para> |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
95 |
1540
6866a74393e0
Added a hint about xslt transformation to autoindex_format.
Valentin Bartenev <vbart@nginx.com>
parents:
1374
diff
changeset
|
96 <para> |
6866a74393e0
Added a hint about xslt transformation to autoindex_format.
Valentin Bartenev <vbart@nginx.com>
parents:
1374
diff
changeset
|
97 Вывод в формате XML может быть преобразован при помощи модуля |
6866a74393e0
Added a hint about xslt transformation to autoindex_format.
Valentin Bartenev <vbart@nginx.com>
parents:
1374
diff
changeset
|
98 <link doc="ngx_http_xslt_module.xml">ngx_http_xslt_module</link>. |
6866a74393e0
Added a hint about xslt transformation to autoindex_format.
Valentin Bartenev <vbart@nginx.com>
parents:
1374
diff
changeset
|
99 </para> |
6866a74393e0
Added a hint about xslt transformation to autoindex_format.
Valentin Bartenev <vbart@nginx.com>
parents:
1374
diff
changeset
|
100 |
1374
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
101 </directive> |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
102 |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
103 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
104 <directive name="autoindex_localtime"> |
271 | 105 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
76
diff
changeset
|
106 <default>off</default> |
303 | 107 <context>http</context> |
108 <context>server</context> | |
109 <context>location</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
110 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
111 <para> |
1374
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
112 Для <link id="autoindex_format">формата</link> HTML |
90922e31756d
Documented the autoindex_format directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
966
diff
changeset
|
113 определяет, в какой временной зоне выводить время в листинге |
966 | 114 каталога: в локальной или в UTC. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
115 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
116 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
117 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
118 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
119 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
120 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
121 </module> |