Пункт 118. Модуль Apache mod_autoindex
Индекс каталога может поступать из одного из двух источников:
- Файл, расположенный в этом каталоге, обычно называемый
index.html
. Директива DirectoryIndex
устанавливает имя файла или файлов, которые будут использоваться. Это контролируется
mod_dir
.
- В противном случае листинг генерируется сервером. Другие директивы управляют форматом этого списка.
AddIcon
, и используются для установки списка значков, отображаемых для различных типов файлов AddIconByEncoding
;
AddIconByType
для каждого файла в списке отображается первый значок в списке, соответствующий этому файлу. Они контролируются
mod_autoindex
.
Эти две функции разделены, так что вы можете полностью удалить (или заменить) автоматическое создание индекса, если захотите.
Автоматическое создание индекса включается с помощью
Options +Indexes
. См.
Options
директиву для более подробной информации.
Если FancyIndexing
параметр указан вместе с IndexOptions
директивой, заголовки столбцов являются ссылками, управляющими порядком отображения. Если вы выберете ссылку в заголовке, список будет перегенерирован и отсортирован по значениям в этом столбце. При повторном выборе одного и того же заголовка происходит переключение между восходящим и нисходящим порядком. Эти ссылки заголовков столбцов подавляются
опцией IndexOptions
директивы
SuppressColumnSorting
.
Обратите внимание, что когда отображение сортируется по «Размеру», используется
фактический размер файлов, а не отображаемое значение, поэтому файл размером 1010 байт всегда будет отображаться перед файлом размером 1011 байт (в порядке возрастания), даже хотя они оба показаны как «1K».
Аргументы запроса автоиндекса
Доступны различные аргументы строки запроса, чтобы дать клиенту некоторый контроль над порядком списка каталогов, а также над тем, какие файлы перечислены. Если вы не хотите предоставлять клиенту этот контроль, опция 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
перечисляет только файлы, соответствующие заданному шаблону
Обратите внимание, что аргумент запроса «Шаблон» проверяется
после обработки обычных 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>
Директива AddAlt
Описание: | Альтернативный текст для отображения файла вместо значка, выбранного по имени файла |
Синтаксис: | AddAlt string file [file] ... |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
AddAlt
предоставляет альтернативный текст для отображения файла вместо значка для FancyIndexing
.
Файл — это расширение файла, частичное имя файла, выражение с подстановочными знаками или полное имя файла для описания файлов. Если String содержит какие-либо пробелы, вы должны заключить их в кавычки ( "
или '
). Этот альтернативный текст отображается, если клиент не поддерживает изображения, отключил загрузку изображений или не может получить значок.
AddAlt "Файл PDF" *.pdf
AddAlt Сжатый *.gz *.zip *.Z
Директива AddAltByEncoding
Описание: | Альтернативный текст для отображения файла вместо значка, выбранного кодировкой MIME. |
Синтаксис: | AddAltByEncoding string MIME-encoding
[MIME-encoding] ... |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
AddAltByEncoding
предоставляет альтернативный текст для отображения файла вместо значка для FancyIndexing
.
MIME-кодирование — это действительное кодирование содержимого, например
x-compress
. Если String содержит какие-либо пробелы, вы должны заключить их в кавычки ( "
или '
). Этот альтернативный текст отображается, если клиент не поддерживает изображения, отключил загрузку изображений или не может получить значок.
AddAltByEncoding gzip x-gzip
Директива AddAltByType
Описание: | Альтернативный текст для отображения в файле вместо значка, выбранного типом содержимого MIME. |
Синтаксис: | AddAltByType string MIME-type
[MIME-type] ... |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
AddAltByType
устанавливает альтернативный текст для отображения для файла вместо значка для FancyIndexing
.
MIME-тип — это допустимый тип содержимого, например
text/html
. Если String содержит какие-либо пробелы, вы должны заключить их в кавычки ( "
или '
). Этот альтернативный текст отображается, если клиент не поддерживает изображения, отключил загрузку изображений или не может получить значок.
AddAltByType 'обычный текст' текст/обычный
Директива AddDescription
Описание: | Описание для отображения файла |
Синтаксис: | AddDescription string file [file] ... |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
Это устанавливает описание, отображаемое для файла, для
FancyIndexing
.
Файл — это расширение файла, частичное имя файла, выражение с подстановочными знаками или полное имя файла для описания файлов.
Строка заключена в двойные кавычки ( "
).
ДобавитьОписание "Планета Марс" mars.gif
ДобавитьОписание "Мой друг Маршалл" friends/mars.gif
Типичное поле описания по умолчанию имеет ширину 23 байта. Дополнительные 6 байтов добавляются опцией IndexOptions SuppressIcon
, 7 байтов добавляются опцией IndexOptions SuppressSize
и 19 байтов добавляются опцией IndexOptions SuppressLastModified
. Таким образом, максимальное значение по умолчанию для столбца описания составляет 55 байт.
Поскольку аргумент File может быть частичным именем файла, помните, что слишком короткое частичное имя файла может соответствовать непредусмотренным файлам. Например, le.html
будет соответствовать файлу le.html
, но также будет соответствовать файлу
example.html
. В случае возникновения двусмысленности используйте как можно более полное имя файла, но имейте в виду, что будет использовано первое найденное совпадение, и соответствующим образом упорядочьте свой список директив
AddDescription
.
См. ключевое слово DescriptionWidth IndexOptions
для получения подробной информации о переопределении размера этого столбца или разрешении описаний неограниченной длины.
Осторожность
Описательный текст, определенный с помощью, AddDescription
может содержать HTML-разметку, такую как теги и символы. Если ширина столбца описания усекает помеченный элемент (например, обрезает конец выделенной жирным шрифтом фразы), результаты могут повлиять на остальную часть списка каталогов.
Аргументы с информацией о пути
Абсолютные пути в настоящее время не поддерживаются и не соответствуют чему-либо во время выполнения. Аргументы с информацией об относительном пути, которые обычно используются только в контексте htaccess, неявно имеют префикс «*/», чтобы избежать совпадения частичных имен каталогов.
Директива AddIcon
Описание: | Значок для отображения файла, выбранного по имени |
Синтаксис: | AddIcon icon name [name]
... |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
Это устанавливает значок для отображения рядом с файлом, заканчивающимся на
имя для FancyIndexing
. Значок представляет собой относительный URL-адрес (с экранированием %) для значка, полный удаленный URL-адрес или формат, в котором alttext
— это текстовый тег, указанный для значка для неграфических браузеров.
(alttext,url)
Имя используется либо ^^DIRECTORY^^
для каталогов,
^^BLANKICON^^
либо для пустых строк (для правильного форматирования списка), расширения файла, выражения подстановочного знака, частичного имени файла или полного имени файла.
^^BLANKICON^^
используется только для форматирования, поэтому в нем нет необходимости, если вы используете файлы IndexOptions
HTMLTable
.
#Примеры
AddIcon (IMG,/icons/image.png) .gif .jpg .png
ДобавитьИконка /icons/dir.png ^^КАТАЛОГ^^
Добавить значок /icons/backup.png *~
AddIconByType
следует использовать вместо AddIcon
, когда это возможно.
Директива AddIconByEncoding
Описание: | Значок для отображения рядом с файлами, выбранными кодировкой содержимого MIME. |
Синтаксис: | AddIconByEncoding icon MIME-encoding
[MIME-encoding] ... |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
Это устанавливает значок для отображения рядом с файлами с расширением FancyIndexing
.
Значок представляет собой относительный URL-адрес (с экранированием %) для значка, полный удаленный URL-адрес или формат, в
котором alttext — это текстовый тег, указанный для значка для неграфических браузеров. (alttext,url)
MIME-кодирование — это действительное кодирование содержимого, например
x-compress
.
AddIconByEncoding /icons/compress.png
Директива AddIconByType
Описание: | Значок для отображения рядом с файлами, выбранными по типу содержимого MIME. |
Синтаксис: | AddIconByType icon MIME-type
[MIME-type] ... |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
Это устанавливает значок для отображения рядом с файлами типа
MIME для FancyIndexing
.
Значок представляет собой относительный URL-адрес (с экранированием %) для значка, полный удаленный URL-адрес или формат, в
котором alttext — это текстовый тег, указанный для значка для неграфических браузеров. (alttext,url)
MIME-тип — это подстановочное выражение, соответствующее требуемым типам mime.
AddIconByType (IMG,/icons/image.png) изображение/*
Директива DefaultIcon
Описание: | Значок для отображения файлов, если не настроен конкретный значок |
Синтаксис: | DefaultIcon url-path |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
Директива DefaultIcon
устанавливает значок для отображения файлов, когда конкретный значок не известен, для FancyIndexing
.
URL-адрес — это относительный URL-адрес (с экранированием %), соответствующий значку, или полный удаленный URL-адрес.
Значок по умолчанию /icon/unknown.png
Директива HeaderName
Описание: | Имя файла, которое будет вставлено вверху списка указателей. |
Синтаксис: | HeaderName filename |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
Директива HeaderName
устанавливает имя файла, который будет вставлен вверху списка индекса. Имя файла — это имя файла, который необходимо включить.
HEADER.html
И HeaderName, и теперь Filename ReadmeName
рассматривают
путь URI относительно пути, используемого для доступа к индексируемому каталогу. Если имя файла начинается с косой черты, оно будет считаться относительно файла . DocumentRoot
Имя заголовка /include/HEADER.html
Имя файла должно разрешаться в документ с основным типом содержимого text/*
( например ,
text/html
, text/plain
, и т. д.). Это означает, что имя файла может относиться к сценарию CGI, если фактический тип файла сценария (в отличие от его вывода) помечен как
text/html
таковой с помощью такой директивы, как:
AddType текст/html .cgi
Согласование контента будет выполнено, если Options
MultiViews
оно действует. Если имя файла разрешается в статический text/html
документ (не сценарий CGI) и включен один из или options
Includes
, IncludesNOEXEC
файл будет обработан для включений на стороне сервера (см.
mod_include
документацию).
Если указанный файл HeaderName
содержит начало HTML-документа (<html>, <head> и т. д.), то вам, вероятно, потребуется установить IndexOptions
+SuppressHTMLPreamble
, чтобы эти теги не повторялись.
Смотрите также
Директива IndexHeadInsert
Описание: | Вставляет текст в раздел HEAD индексной страницы. |
Синтаксис: | IndexHeadInsert "markup ..." |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
Директива IndexHeadInsert
указывает строку для вставки в раздел <head> HTML-кода, сгенерированного для индексной страницы.
IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">"
Директива IndexIgnore
Описание: | Добавляет в список файлы, которые нужно скрыть при перечислении каталога |
Синтаксис: | IndexIgnore file [file] ... |
По умолчанию: | IndexIgnore "." |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
Директива IndexIgnore
добавляет в список файлы, которые нужно скрыть при отображении каталога. Файл — это подстановочное выражение в стиле оболочки или полное имя файла. Несколько директив IndexIgnore добавляются в список, а не заменяют список игнорируемых файлов. По умолчанию список содержит .
(текущий каталог).
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t
Обычные выражения
Эта директива в настоящее время не работает в разделах конфигурации, которые имеют аргументы регулярного выражения, такие как <DirectoryMatch>
Директива IndexIgnoreReset
Описание: | Очищает список файлов, которые нужно скрыть при отображении каталога. |
Синтаксис: | IndexIgnoreReset ON|OFF |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
Совместимость: | 2.3.10 и выше |
Директива IndexIgnoreReset
удаляет любые файлы, игнорируемые IndexIgnore
в противном случае унаследованные от других разделов конфигурации.
<Каталог "/var/www">
IndexIgnore *.bak .??* *~ *# HEADER* README* RCS CVS *,v *,t
</Каталог>
<Каталог "/var/www/backups">
IndexIgnoreReset ON
IndexIgnore .??* *# HEADER* README* RCS CVS *,v *,t
</Каталог>
Просмотрите конфигурацию по умолчанию для списка шаблонов, которые вы, возможно, захотите явно игнорировать после использования этой директивы.
Директива IndexOptions
Описание: | Различные параметры конфигурации для индексации каталогов |
Синтаксис: | IndexOptions [+|-]option [[+|-]option]
... |
По умолчанию: | By default, no options are enabled. |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
Директива IndexOptions
определяет поведение индексации каталога. Вариант может быть одним из
- Аддальткласс
- Добавляет дополнительное объявление класса CSS в каждую строку таблицы со списком каталогов, когда
IndexOptions HTMLTable
оно действует и IndexStyleSheet
определено. Вместо стандарта even
и odd
классов, которые в противном случае применялись бы к каждой строке таблицы, класс или
где ALT — это либо стандартный замещающий текст, связанный со стилем файла (например, snd ,
txt , img и т. д.), либо замещающий текст. определяется одной из различных директив.
even-ALT
odd-ALT
AddAlt*
- Charset= набор символов ( Apache HTTP Server 2.0.61 и более поздние версии )
- Ключевое
Charset
слово позволяет указать набор символов сгенерированной страницы. По умолчанию используется UTF-8
в Windows и Mac OS X и ISO-8859-1
в других местах. (Это зависит от того, использует ли базовая файловая система имена файлов Unicode или нет.)
Кодировка IndexOptions=UTF-8
- ОписаниеШирина=[ n | *]
- Ключевое
DescriptionWidth
слово позволяет указать ширину столбца описания в символах.
-
-DescriptionWidth
(или unset) позволяет
mod_autoindex
рассчитать наилучшую ширину.
-
DescriptionWidth=n
фиксирует ширину столбца до
n байтов.
-
DescriptionWidth=*
увеличивает столбец до ширины, необходимой для размещения самой длинной строки описания.
См. раздел об AddDescription
опасностях, связанных с усечением описаний.
- FancyIndexing
- Это включает причудливую индексацию каталогов.
- ПапкиПервые
- Если эта опция включена, списки подкаталогов
всегда будут отображаться первыми, а затем обычные файлы в каталоге. Список в основном разбит на два компонента, файлы и подкаталоги, и каждый из них сортируется отдельно, а затем отображается сначала подкаталоги. Например, если порядок сортировки по убыванию имени и
FoldersFirst
включен, подкаталог
Zed
будет указан перед подкаталогом
Beta
, который будет указан перед обычными файлами
Gamma
и файлами Alpha
.
Эта опция имеет эффект только в том случае, если FancyIndexing
она также включена.
- HTMLТаблица
- Эта опция
FancyIndexing
создает простую таблицу для причудливого списка каталогов. Это необходимо для платформ с поддержкой utf-8 или если имена файлов или текст описания будут чередоваться между порядком чтения слева направо и справа налево.
- ИконкиСсылки
- Это делает значки частью якоря для имени файла для причудливой индексации.
- IconHeight[= пикселей ]
- Наличие этой опции при использовании с
IconWidth
, приведет к включению сервером атрибутов height
и
width
в img
тег для значка файла. Это позволяет браузеру предварительно рассчитать макет страницы, не дожидаясь загрузки всех изображений. Если для параметра не задано значение, по умолчанию используется стандартная высота значков, поставляемая с программным обеспечением Apache httpd.
Эта опция имеет эффект только в том случае, если FancyIndexing
она также включена.
- IconWidth[= пикселей ]
- Наличие этой опции при использовании с
IconHeight
, приведет к включению сервером атрибутов height
и
width
в img
тег для значка файла. Это позволяет браузеру предварительно рассчитать макет страницы, не дожидаясь загрузки всех изображений. Если для параметра не задано значение, по умолчанию используется стандартная ширина значков, поставляемая с программным обеспечением Apache httpd.
- Игнорекейс
- Если этот параметр включен, имена сортируются без учета регистра. Например, если порядок сортировки в порядке возрастания имени и
IgnoreCase
включен, файл Zeta будет указан после файла alfa (Примечание: файл GAMMA всегда будет указан перед файлом gamma).
- ИгнорКлиент
- Этот параметр заставляет
mod_autoindex
игнорировать все переменные запроса от клиента, включая порядок сортировки (подразумевается
SuppressColumnSorting
.)
- NameWidth=[ п
| *]
- Ключевое
NameWidth
слово позволяет указать ширину столбца имени файла в байтах.
-
-NameWidth
(или unset) позволяет mod_autoindex
рассчитать наилучшую ширину, но только до 20 байт.
-
NameWidth=n
фиксирует ширину столбца до
n байтов.
-
NameWidth=*
увеличивает столбец до необходимой ширины.
- СканироватьHTMLTitles
- Это позволяет извлекать заголовок из HTML-документов для удобного индексирования. Если у файла нет описания, данного
AddDescription
тогда httpd прочитает документ для значения элемента
title
. Это интенсивное использование процессора и диска.
- ПоказатьЗапрещено
- Если указано, Apache httpd покажет файлы, обычно скрытые, потому что подзапрос возвратил
HTTP_UNAUTHORIZED
или
HTTP_FORBIDDEN
- Подавить сортировку столбцов
- Если указано, Apache httpd не будет превращать заголовки столбцов в каталоге FancyIndexed в ссылки для сортировки. По умолчанию они являются ссылками; выбор заголовка столбца отсортирует список каталогов по значениям в этом столбце. Однако аргументы строки запроса, которые добавляются к URL-адресу, по-прежнему будут учитываться. Это поведение контролируется
IndexOptions
IgnoreClient
.
- Подавить Описание
- Это скроет описание файла в причудливых списках индексации. По умолчанию описания файлов не определены, поэтому при использовании этой опции восстанавливается 23 символа экранного пространства, которое можно использовать для чего-то другого. См
AddDescription
. информацию о настройке описания файла. См. также DescriptionWidth
параметр индекса, чтобы ограничить размер столбца описания.
Эта опция имеет эффект только в том случае, если FancyIndexing
она также включена.
- Подавить преамбулу HTML
- Если каталог действительно содержит файл, указанный в
HeaderName
директиве, модуль обычно включает содержимое файла после стандартной преамбулы HTML ( <html>
,
<head>
, и так далее ). Параметр
SuppressHTMLPreamble
отключает это поведение, заставляя модуль запускать отображение с содержимым файла заголовка. В этом случае заголовочный файл должен содержать соответствующие HTML-инструкции. Если заголовочный файл отсутствует, преамбула формируется как обычно. Если вы также укажете ReadmeName
, и если этот файл существует, закрывающие теги </body></html> также будут исключены из вывода, при условии, что вы, вероятно, поместите эти закрывающие теги в этот файл.
- Подавить значок
- Это скроет значок в причудливых списках индексации. Сочетание обоих
SuppressIcon
и
SuppressRules
дает правильный вывод HTML 3.2, который по окончательной спецификации запрещает img
и
hr
элементы из pre
блока (используется для форматирования списков FancyIndexed).
- Супрессластмодифиед
- Это подавит отображение даты последнего изменения в причудливых списках индексации.
Эта опция имеет эффект только в том случае, если
FancyIndexing
она также включена.
- Подавить правила
- Это скроет горизонтальные линейки (
hr
элементы) в списках каталогов. Сочетание обоих SuppressIcon
и
SuppressRules
дает правильный вывод HTML 3.2, который по окончательной спецификации запрещает img
и
hr
элементы из pre
блока (используется для форматирования списков FancyIndexed).
Этот параметр имеет эффект, только если FancyIndexing
он также включен.
- Подавить размер
- Это уменьшит размер файла в причудливых списках индексации.
Эта опция имеет эффект только в том случае, если
FancyIndexing
она также включена.
- TrackModified
- Это возвращает значения
Last-Modified
и ETag
для указанного каталога в заголовке HTTP. Это допустимо только в том случае, если операционная система и файловая система возвращают соответствующие результаты stat(). Так поступают некоторые системы Unix, а также тома OS2 JFS и Win32 NTFS. Тома OS2 и Win32 FAT, например, этого не делают. После включения этой функции клиент или прокси-сервер могут отслеживать изменения в списке файлов при выполнении запроса HEAD
. Обратите внимание, что некоторые операционные системы правильно отслеживают новые и удаленные файлы, но не отслеживают изменения размеров или дат файлов в каталоге. Изменения размера или отметки даты существующего файла не будут обновлять заголовок
Last-Modified
на всех платформах Unix.
Если это вас беспокоит, оставьте этот параметр отключенным.
- Тип = тип содержимого MIME ( Apache HTTP Server 2.0.61 и более поздние версии )
- Ключевое
Type
слово позволяет указать MIME-тип содержимого сгенерированной страницы. По умолчанию это текст/html .
Тип IndexOptions = текстовый/обычный
- UseOldDateFormat ( HTTP-сервер Apache 2.4.26 и более поздние версии )
- Формат даты, используемый для
Last Modified
поля, был случайно изменен на "%Y-%m-%d %H:%M"
формат
"%d-%b-%Y %H:%M"
2.4.0. Установка этого параметра восстанавливает формат даты 2.2 и более ранних версий.
- VersionSort ( Apache HTTP Server 2.0a3 и более поздние версии )
- Ключевое
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 ( Apache HTTP Server 2.0.49 и более поздние версии )
- Ключевое
XHTML
слово заставляет mod_autoindex
выдавать код XHTML 1.0 вместо HTML 3.2.
Эта опция имеет эффект только в том случае, если FancyIndexing
она также включена.
- Параметры инкрементного индекса
-
Знайте, как IndexOptions
обрабатываются несколько.
Всякий раз, когда встречается ключевое слово с префиксом «+» или «-», оно применяется к текущим IndexOptions
настройкам (которые могут быть унаследованы от каталога верхнего уровня). Однако всякий раз, когда обрабатывается ключевое слово без префикса, все унаследованные параметры и любые добавочные настройки, встречавшиеся до сих пор, очищаются. Рассмотрим следующий пример:
IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing
IndexOptions + Супресссайз
Чистый эффект эквивалентен IndexOptions FancyIndexing
+SuppressSize
, потому что без префикса FancyIndexing
отбрасываются добавочные ключевые слова перед ним, но после этого они снова начинают накапливаться.
Чтобы безоговорочно установить IndexOptions
для определенного каталога, очистив унаследованные настройки, укажите ключевые слова без каких-либо +
или -
префиксов.
Директива IndexOrderDefault
Описание: | Устанавливает порядок индекса каталога по умолчанию |
Синтаксис: | IndexOrderDefault Ascending|Descending
Name|Date|Size|Description |
По умолчанию: | IndexOrderDefault Ascending Name |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
Директива IndexOrderDefault
используется в сочетании с FancyIndexing
параметром index. По умолчанию списки каталогов fancyindexed отображаются в порядке возрастания имени файла; позволяет
IndexOrderDefault
вам изменить этот первоначальный порядок отображения.
IndexOrderDefault
принимает два аргумента. Первым должен быть либо Ascending
или
Descending
, указывающий направление сортировки. Второй аргумент должен быть одним из ключевых слов Name
,
Date
, Size
или Description
, и идентифицирует первичный ключ. Вторичным ключом
всегда является восходящее имя файла.
При желании вы можете запретить клиенту переупорядочивать список, также добавив SuppressColumnSorting
параметр индекса, чтобы удалить ссылку сортировки из верхней части столбца, вместе с параметром IgnoreClient
индекса, чтобы они не могли вручную добавлять параметры сортировки в строку запроса по порядку. отменить ваши предпочтения при заказе.
Директива IndexStyleSheet
Описание: | Добавляет таблицу стилей CSS в указатель каталога |
Синтаксис: | IndexStyleSheet url-path |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
Директива IndexStyleSheet
устанавливает имя файла, который будет использоваться в качестве CSS для листинга индекса.
Таблица стилей индекса "/css/style.css"
Использование этой директивы в сочетании с IndexOptions
HTMLTable
добавляет несколько классов CSS в результирующий HTML. Всей таблице присваивается идентификатор CSS, indexlist
а следующие классы связаны с различными частями листинга:
tr.indexhead | Заголовок списка |
th.indexcolicon и td.indexcolicon | Столбец значков |
th.indexcolname и td.indexcolname | Столбец имени файла |
th.indexcollastmod и td.indexcollastmod | Столбец последнего изменения |
th.indexcolsize и td.indexcolsize | Столбец размера файла |
th.indexcoldesc и td.indexcoldesc | Столбец описания |
tr.breakrow | Горизонтальное правило внизу таблицы |
тр.нечет и тр.чет | Чередование четных и нечетных рядов |
Директива ReadmeName
Описание: | Имя файла, которое будет вставлено в конец индексного листинга |
Синтаксис: | ReadmeName filename |
Контекст: | конфигурация сервера, виртуальный хост, каталог, .htaccess |
Переопределить: | Индексы |
Положение дел: | База |
Модуль: | mod_autoindex |
Директива ReadmeName
устанавливает имя файла, которое будет добавлено в конец списка индекса. Имя файла — это имя файла, который нужно включить, и считается, что оно относится к индексируемому местоположению. Если
имя файла начинается с косой черты, как в примере 2, оно будет считаться относительным для файла DocumentRoot
.
# Пример 1
Файл ReadmeName FOOTER.html
# Пример 2
Имя ReadmeName /include/FOOTER.html
См. также HeaderName
, где это поведение описано более подробно.