annotate xml/ru/docs/http/ngx_http_autoindex_module.xml @ 2769:16f6fa718be2

Updated TLSv1.3 support notes. Previous notes described some early development snapshot of OpenSSL 1.1.1 with disabled TLSv1.3 by default. It was then enabled in the first alpha. Further, the updated text covers later major releases such as OpenSSL 3.0.
author Sergey Kandaurov <pluknet@nginx.com>
date Thu, 30 Sep 2021 16:29:20 +0300
parents 6866a74393e0
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
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
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
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
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
20 Обычно запрос попадает к модулю <literal>ngx_http_autoindex_module</literal>,
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
21 когда модуль <link doc="ngx_http_index_module.xml">ngx_http_index_module</link>
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
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
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
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
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
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
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
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
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
46 <context>http</context>
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
47 <context>server</context>
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
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
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
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
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
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
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
60 <context>http</context>
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
61 <context>server</context>
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
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
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 724
diff changeset
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
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
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
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
107 <context>http</context>
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
108 <context>server</context>
1c239146beb4 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
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
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 724
diff changeset
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>