Apache Версия 2.0 Сервера HTTP
Description: |
производит директивные индексы, автоматически, подобный Unix
ls
командовать или Win32
dir
команда снаряда
|
---|---|
Status: | основа |
Module Identifier: | autoindex_module |
Source File: | mod_autoindex.c |
индекс справочника может прибыть от одного из двух источников:
index.html
.
DirectoryIndex
директива устанавливает название этого файла. Этим управляют
mod_dir
.
AddIcon
,
AddIconByEncoding
и
AddIconByType
используются, чтобы заставить список изображений показывать для различных типов файла; для каждого перечисленного файла, первое изображение перечисляло, который соответствует, файл показан. Ими управляют
mod_autoindex
.
две функции отделены так, чтобы Вы могли полностью удалить (или заменить), автоматическое поколение индекса должно Вы хотеть к.
автоматическому поколению индекса позволяют с использованием
Options +Indexes
. см.
Options
директива для большего количества деталей.
если
FancyIndexing
выбор дается с
IndexOptions
директива, удары головой колонки - связи, которые управляют заказом показа. Если Вы выберете связь удара головой, то внесение в список будет восстановлено, сортировано ценностями в той колонке. Отбор того же самого удара головой неоднократно пуговицы между возрастанием и спускающимся заказом. Эти связи удара головой колонки подавлены с
IndexOptions
директива
SuppressColumnSorting
выбор.
отметить, что, когда показ сортирован "Размером", это- фактический размер файлов, это используется, не показанная ценность - так 1010-байтовый файл, будет всегда показываться, перед 1011-байтовым файлом (если в порядке возрастания) даже при том, что их обоих показывают как "1 КБ".
Apache 2.0.23 реорганизовал Аргументы Вопроса за Сортировку Колонки, и вводил всю группу новых вариантов вопроса. Эффективно устранять всего клиента управляют по продукции,
IndexOptions IgnoreClient
выбор был введен.
колонка, сортирующая сами удары головой самоссылается, осуществляет гиперссылку, которые добавляют варианты вопроса вида, показанные ниже. Любой выбор ниже может быть добавлен к любому запросу о директивном ресурсе.
C=N
сортирует справочник названием файла
C=M
сортирует справочник последнее-измененной датой, тогда название файла
C=S
сортирует справочник размером, тогда название файла
C=D
сортирует справочник в соответствии с описанием, тогда название файла
O=A
сортирует внесение в список в порядке возрастания
O=D
сортирует внесение в список в порядке убывания
F=0
форматирует внесение в список как простой список (не FancyIndexed)
F=1
форматирует внесение в список как список FancyIndexed
F=2
форматирует внесение в список как HTMLTable FancyIndexed список
V=0
повреждает сортировку версии
V=1
позволяет сортировку версии
P=
pattern
списки только файлы, соответствующие данному
образец
отметить, что 'аргумент вопроса P'attern проверен
после
обычное
IndexIgnore
директивы обработаны, и все названия файла все еще подвергаются тем же самым критериям как любое другое внесение в список автоиндекса. Анализатор Аргументов Вопроса в
mod_autoindex
остановится резко, когда с непризнанным выбором сталкиваются. Аргументы Вопроса должны быть хорошо сформированы, согласно столу выше.
простой пример ниже, который может быть подрезанным и спасенным в header.html файл, иллюстрирует эти варианты вопроса. Отметьте, что неизвестное "X" аргумент, для представленной кнопки, перечислен последний, чтобы уверить, что аргументы все разобраны прежде, чем mod_autoindex сталкивается со входом X=Go.
<form action="" method="get">
Show me a <select name="F">
<option value="0"> Plain list</option>
<option value="1" selected="selected"> Fancy list</option>
<option value="2"> Table list</option>
</select>
Sorted by <select name="C">
<option value="N" selected="selected"> Name</option>
<option value="M"> Date Modified</option>
<option value="S"> Size</option>
<option value="D"> Description</option>
</select>
<select name="O">
<option value="A" selected="selected"> Ascending</option>
<option value="D"> Descending</option>
</select>
<select name="V">
<option value="0" selected="selected"> in Normal order</option>
<option value="1"> in Version order</option>
</select>
Matching <input type="text" name="P" value="*" />
<input type="submit" name="X" value="Go" />
</form>
Description: | дополнительный текст, чтобы показать для файла, вместо изображения, отобранного именем файла |
---|---|
Syntax: |
AddAlt
string
file
[
file
] ...
|
Context: | сервер config, действительный хозяин, справочник, .htaccess |
Override: | индексы |
Status: | основа |
Module: | mod_autoindex |
AddAlt
обеспечивает дополнительный текст, чтобы показать для файла, вместо изображения, для
FancyIndexing
.
файл
является расширением файла, частичным именем файла, выражением группового символа или полным именем файла для файлов, чтобы описать. Если
вереница
содержит любой whitespace, Вы должны приложить это в кавычках (
"
или
'
). Этот дополнительный текст показан, если клиент неспособен к изображению, имеет изображение, загружающее инвалидов, или не в состоянии восстановить изображение.
AddAlt "PDF file" *.pdf
AddAlt Compressed *.gz *.zip *.Z
Description: | дополнительный текст, чтобы показать для файла вместо изображения, отобранного ЗАШИФРОВЫВАНИЕМ ПАНТОМИМЫ |
---|---|
Syntax: |
AddAltByEncoding
string
MIME-encoding
[
MIME-encoding
] ...
|
Context: | сервер config, действительный хозяин, справочник, .htaccess |
Override: | индексы |
Status: | основа |
Module: | mod_autoindex |
AddAltByEncoding
обеспечивает дополнительный текст, чтобы показать для файла, вместо изображения, для
FancyIndexing
.
ЗАШИФРОВЫВАНИЕ ПАНТОМИМЫ
является действительным довольным зашифровыванием, типа
x-compress
. если
вереница
содержит любой whitespace, Вы должны приложить это в кавычках (
"
или
'
). Этот дополнительный текст показан, если клиент неспособен к изображению, имеет изображение, загружающее инвалидов, или не в состоянии восстановить изображение.
AddAltByEncoding gzip x-gzip
Description: | дополнительный текст, чтобы показать для файла, вместо изображения, отобранного довольным типом MIME |
---|---|
Syntax: |
AddAltByType
string
MIME-type
[
MIME-type
] ...
|
Context: | сервер config, действительный хозяин, справочник, .htaccess |
Override: | индексы |
Status: | основа |
Module: | mod_autoindex |
AddAltByType
заставляет дополнительный текст показывать для файла, вместо изображения, для
FancyIndexing
.
ТИП ПАНТОМИМЫ
является действительным довольным типом, типа
text/html
. если
вереница
содержит любой whitespace, Вы должны приложить это в кавычках (
"
или
'
). Этот дополнительный текст показан, если клиент неспособен к изображению, имеет изображение, загружающее инвалидов, или не в состоянии восстановить изображение.
AddAltByType 'plain text' text/plain
Description: | описание, чтобы показать для файла |
---|---|
Syntax: |
AddDescription
string file
[
file
] ...
|
Context: | сервер config, действительный хозяин, справочник, .htaccess |
Override: | индексы |
Status: | основа |
Module: | mod_autoindex |
это заставляет описание показывать для файла, для
FancyIndexing
.
файл
является расширением файла, частичным именем файла, выражением группового символа или полным именем файла для файлов, чтобы описать.
вереница
приложен в двойных кавычках (
"
).
AddDescription "The planet Mars" /web/pics/mars.gif
типичная, область описания по умолчанию 23 байта шириной. Еще 6 байтов добавлены
IndexOptions SuppressIcon
выбор, 7 байтов добавлены
IndexOptions SuppressSize
выбор, и 19 байтов добавлены
IndexOptions SuppressLastModified
выбор. Поэтому, самый широкий неплатеж, колонка описания когда-либо назначается, - 55 байтов.
см.
DescriptionWidth
IndexOptions
ключевое слово для деталей относительно отвергания размера этой колонки, или позволения описаний неограниченной длины.
описательный текст, определенный с
AddDescription
может содержать повышение HTML, типа объектов характера и признаков. Если ширина колонки описания, должный случиться, усекает теговый элемент (, типа отключения конца bolded фразы), результаты могут затронуть остальную часть директивного внесения в список.
Description: | изображение, чтобы показать для файла, отобранного по имени |
---|---|
Syntax: |
AddIcon
icon
name
[
name
] ...
|
Context: | сервер config, действительный хозяин, справочник, .htaccess |
Override: | индексы |
Status: | основа |
Module: | mod_autoindex |
это заставляет изображение показывать рядом с файлом, заканчивающимся в
название
для
FancyIndexing
.
изображение
является любой (% - убежал), относительный URL к изображению, или формата
(
alttext
,
url
)
где
alttext
является признаком текста, данным для изображения для неграфических браузеров.
название
является также
^^DIRECTORY^^
для справочников,
^^BLANKICON^^
для чистых линий (чтобы форматировать список правильно), расширение файла, выражение группового символа, частичное имя файла или полное имя файла.
AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm
AddIcon /icons/dir.xbm ^^DIRECTORY^^
AddIcon /icons/backup.xbm *~
AddIconByType
должен использоваться в предпочтении к
AddIcon
, когда возможно.
Description: | изображение, чтобы показать рядом с файлами, отобранными довольным зашифровыванием ПАНТОМИМЫ |
---|---|
Syntax: |
AddIconByEncoding
icon
MIME-encoding
[
MIME-encoding
] ...
|
Context: | сервер config, действительный хозяин, справочник, .htaccess |
Override: | индексы |
Status: | основа |
Module: | mod_autoindex |
это заставляет изображение показывать рядом с файлами с
FancyIndexing
.
изображение
является любой (% - убежал), относительный URL к изображению, или формата
(
alttext
,
url
)
где
alttext
является признаком текста, данным для изображения для неграфических браузеров.
ЗАШИФРОВЫВАНИЕ ПАНТОМИМЫ является соответствием выражения группового символа, требовал довольного зашифровывания.
AddIconByEncoding /icons/compress.xbm x-compress
Description: | изображение, чтобы показать рядом с файлами, отобранными довольным типом MIME |
---|---|
Syntax: |
AddIconByType
icon
MIME-type
[
MIME-type
] ...
|
Context: | сервер config, действительный хозяин, справочник, .htaccess |
Override: | индексы |
Status: | основа |
Module: | mod_autoindex |
это заставляет изображение показывать рядом с файлами типа
ТИП ПАНТОМИМЫ
для
FancyIndexing
.
изображение
является любой (% - убежал), относительный URL к изображению, или формата
(
alttext
,
url
)
где
alttext
является признаком текста, данным для изображения для неграфических браузеров.
ТИП ПАНТОМИМЫ является соответствием выражения группового символа, требовал типов пантомимы.
AddIconByType (IMG,/icons/image.xbm) image/*
Description: | изображение, чтобы показать для файлов, когда никакое определенное изображение не формируется |
---|---|
Syntax: |
DefaultIcon
url-path
|
Context: | сервер config, действительный хозяин, справочник, .htaccess |
Override: | индексы |
Status: | основа |
Module: | mod_autoindex |
DefaultIcon
директива заставляет изображение показывать для файлов, когда никакое определенное изображение не известно,
FancyIndexing
.
дорожка URL
является (% - убежал), относительный URL к изображению.
DefaultIcon /icon/unknown.xbm
Description: | название файла, который будет вставлен наверху внесения в список индекса |
---|---|
Syntax: |
HeaderName
filename
|
Context: | сервер config, действительный хозяин, справочник, .htaccess |
Override: | индексы |
Status: | основа |
Module: | mod_autoindex |
HeaderName
директива устанавливает название файла, который будет вставлен наверху внесения в список индекса.
имя файла
является названием файла, чтобы включить.
HeaderName HEADER.html
И HeaderName и
ReadmeName
теперь удовольствие
имя файла
поскольку дорожка ТУРОВ относительно того имела обыкновение получать доступ к внесенному в указатель справочнику. Если
имя файла
начинается с разреза, это будет взято, чтобы быть относительно
DocumentRoot
.
HeaderName /include/HEADER.html
имя файла
должен решить к документу с главным довольным типом
text/*
(
например.
,
text/html
,
text/plain
, и т.д.). Это означает это
имя файла
может обратиться к подлиннику CGI, если фактический тип файла подлинника (в противоположность его продукции) отмечен как
text/html
, типа с директивой как:
AddType text/html .cgi
Content negotiation
будет выполнен если
Options
MultiViews
является в действительности. Если
имя файла
решения к статическому
text/html
документ (не подлинник CGI) и любой
options
Includes
или
IncludesNOEXEC
позволяется, файл будет обработан для стороны сервера, включает (см.
mod_include
документация).
если файл, определенный
HeaderName
содержит начала документа HTML (<html>, <head>, и т.д.), тогда Вы будете вероятно хотеть установить
IndexOptions +SuppressHTMLPreamble
, так, чтобы эти признаки были не повторены.
Description: | добавляет к списку файлов, чтобы скрыться, перечисляя справочник |
---|---|
Syntax: |
IndexIgnore
file
[
file
] ...
|
Context: | сервер config, действительный хозяин, справочник, .htaccess |
Override: | индексы |
Status: | основа |
Module: | mod_autoindex |
IndexIgnore
директива добавляет к списку файлов, чтобы скрыться, перечисляя справочник.
файл
является выражением группового символа стиля снаряда или полным именем файла. Многократные директивы IndexIgnore добавляют к списку, а не замене списка игнорируемых файлов. По умолчанию, список содержит
.
(текущий справочник).
IndexIgnore README .htaccess *.bak *~
Description: | различные параметры настройки конфигурации для директивной индексации |
---|---|
Syntax: |
IndexOptions [+|-]
option
[[+|-]
option
] ...
|
Context: | сервер config, действительный хозяин, справочник, .htaccess |
Override: | индексы |
Status: | основа |
Module: | mod_autoindex |
IndexOptions
директива определяет поведение директивной индексации.
выбор
может быть один из
DescriptionWidth
ключевое слово позволяет Вам определять ширину колонки описания в характерах.
-DescriptionWidth
(или сброс), позволяет
mod_autoindex
вычислять лучшую ширину.
DescriptionWidth=
n
устанавливает ширину колонки к
n
широкие байты.
DescriptionWidth=*
выращивает колонку к ширине, необходимой приспособить самую длинную вереницу описания.
AddDescription
для опасностей, врожденных усечению описаний.
FoldersFirst
позволяется, подсправочник
Zed
будет перечислен перед подсправочником
Beta
, который будет перечислен перед нормальными файлами
Gamma
и
Alpha
.
этот выбор только имеет эффект если
FancyIndexing
также позволяется.
height
и
width
признаки в
img
признак для изображения файла. Это позволяет браузеру предвычислять расположение страницы, не имея необходимость ждать, пока все изображения не были загружены. Если никакая ценность не дается для выбора, это, неплатежи к стандартной высоте изображений снабжали Apacheским программным обеспечением.
IconHeight
, заставит сервер включать
height
и
width
признаки в
img
признак для изображения файла. Это позволяет браузеру предвычислять расположение страницы, не имея необходимость ждать, пока все изображения не были загружены. Если никакая ценность не дается для выбора, это, неплатежи к стандартной ширине изображений снабжали Apacheским программным обеспечением.
mod_autoindex
игнорировать все переменные вопроса от клиента, включая заказ вида (подразумевает
SuppressColumnSorting
.)
NameWidth
ключевое слово позволяет Вам определять ширину колонки имени файла в байтах.
-NameWidth
(или сброс), позволяет
mod_autoindex
вычислять лучшую ширину.
NameWidth=
n
устанавливает ширину колонки к
n
широкие байты.
NameWidth=*
выращивает колонку к необходимой ширине.
AddDescription
тогда httpd прочитает документ за ценность
title
элемент. Это - центральный процессор и интенсивный диск.
AddDescription
для информации об урегулировании описания файла. См. также
DescriptionWidth
выбор индекса ограничивать размер колонки описания.
HeaderName
директива, модуль обычно включает содержание файла после стандартной преамбулы HTML (
<html>
,
<head>
,
и так далее
).
SuppressHTMLPreamble
выбор повреждает это поведение, заставляя модуль начать показ с содержания файла удара головой. Файл удара головой должен содержать соответствующие инструкции HTML в этом случае. Если нет никакого файла удара головой, преамбула произведена как обычно.
SuppressIcon
и
SuppressRules
приводит к надлежащему HTML 3.2 продукции, которые заключительной спецификацией запрещают
img
и
hr
элементы от
pre
блок (имел обыкновение форматировать списки FancyIndexed.)
hr
элементы) в директивных списках. Объединение обоих
SuppressIcon
и
SuppressRules
приводит к надлежащему HTML 3.2 продукции, которые заключительной спецификацией запрещают
img
и
hr
элементы от
pre
блок (имел обыкновение форматировать списки FancyIndexed.)
HEAD
запрос. Отметьте, что некоторые операционные системы правильно отслеживают новые и удаленные файлы, но не отслеживают изменения к размерам или датам файлов в пределах справочника.
изменения к размеру или печати даты существующего файла не будут обновлять Последнее-измененный удар головой на всех платформах Unix.
если это - беспокойство, отпуск эти инвалиды выбора.
VersionSort
ключевое слово вызывает файлы, содержащие числа версии к виду естественным способом. Вереницы сортированы как обычно, за исключением того, что подвереницы цифр на название и описание сравнены согласно их числовой ценности.
foo-1.7
foo-1.7.2
foo-1.7.12
foo-1.8.2
foo-1.8.2a
foo-1.12
если число начинается с ноля, то это, как полагают, является фракцией:
foo-1.001
foo-1.002
foo-1.030
foo-1.04
XHTML
силы ключевого слова
mod_autoindex
испускать XHTML 1.0 кодекса вместо HTML 3.2.
Apache 1.3.3 вводил некоторые существенные изменения в обработке
IndexOptions
директивы. В особенности:
IndexOptions
директивы для единственного справочника теперь слиты вместе. Результат:
<Directory /foo>
IndexOptions HTMLTable
IndexOptions SuppressColumnsorting
</Directory>
будет эквивалент
IndexOptions HTMLTable SuppressColumnsorting
+
или
-
).
всякий раз, когда '+' или '-'предустановил ключевое слово, сталкивается, это применено к потоку
IndexOptions
параметры настройки (который, возможно, был унаследован от справочника верхнего уровня). Однако, всякий раз, когда unprefixed ключевое слово обработано, это очищает все унаследованные варианты и любые возрастающие параметры настройки, с которыми сталкиваются пока. Рассмотрите следующий пример:
IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing
IndexOptions +SuppressSize
результирующее влияние эквивалентно
IndexOptions FancyIndexing +SuppressSize
, потому что unprefixed
FancyIndexing
отказанный возрастающие ключевые слова прежде, чем это, но позволенный их, чтобы начать накапливаться снова позже.
безоговорочно установить
IndexOptions
для специфического справочника, очищая унаследованные параметры настройки, определяют ключевые слова без любого
+
или
-
приставки.
Description: | устанавливает заказ по умолчанию директивного индекса |
---|---|
Syntax: |
IndexOrderDefault Ascending|Descending Name|Date|Size|Description
|
Default: |
IndexOrderDefault Ascending Name
|
Context: | сервер config, действительный хозяин, справочник, .htaccess |
Override: | индексы |
Status: | основа |
Module: | mod_autoindex |
IndexOrderDefault
директива используется в комбинации с
FancyIndexing
выбор индекса. По умолчанию, fancyindexed директивные списки показаны в порядке возрастания именем файла;
IndexOrderDefault
позволяете Вы изменять этот начальный заказ показа.
IndexOrderDefault
берет два аргумента. Первое должно быть также
Ascending
или
Descending
, указывая руководство вида. Вторым аргументом должно быть одно из ключевых слов
Name
,
Date
,
Size
, или
Description
, и идентифицирует первичный ключ. Вторичный ключ
всегда
имя файла возрастания.
Вы можете вынудить внесение в список справочника только быть показанным в специфическом заказе, комбинируя эту директиву с
SuppressColumnSorting
выбор индекса; это будет препятствовать клиенту просить директивное внесение в список в различном заказе.
Description: | название файла, который будет вставлен в конце внесения в список индекса |
---|---|
Syntax: |
ReadmeName
filename
|
Context: | сервер config, действительный хозяин, справочник, .htaccess |
Override: | индексы |
Status: | основа |
Module: | mod_autoindex |
ReadmeName
директива устанавливает название файла, который будет приложен до конца внесения в список индекса.
имя файла
является названием файла, чтобы включить, и взят, чтобы быть относительно внесенного в указатель местоположения. Если
имя файла
начинается с разреза, это будет взято, чтобы быть относительно
DocumentRoot
.
ReadmeName FOOTER.html
ReadmeName /include/FOOTER.html
см. также
HeaderName
, где это поведение описано в больших деталях.