lighttpd 1.4.x
https://www.lighttpd.net/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
126 lines
2.9 KiB
126 lines
2.9 KiB
================== |
|
Directory Listings |
|
================== |
|
|
|
---------------------- |
|
Module: mod_dirlisting |
|
---------------------- |
|
|
|
:Author: Jan Kneschke |
|
:Date: $Date: 2004/11/03 22:26:05 $ |
|
:Revision: $Revision: 1.2 $ |
|
|
|
:abstract: |
|
mod_dirlisting generates HTML based directory listings with full CSS |
|
control |
|
|
|
.. meta:: |
|
:keywords: lighttpd, directory listings, dirlisting |
|
|
|
.. contents:: Table of Contents |
|
|
|
Description |
|
=========== |
|
|
|
mod_dirlisting is one of the modules which is loaded by default and don't have to |
|
be specified on server.modules to work. |
|
|
|
A directory listing is generated if a directory is requested and no index-file |
|
was found in that directory. |
|
|
|
To enable directory listings globally: :: |
|
|
|
dir-listing.activate = "enable" |
|
|
|
If you need it only for a directory, use conditionals: :: |
|
|
|
$HTTP["url"] =~ "^/download($|/)" { |
|
dir-listing.activate = "enable" |
|
} |
|
|
|
You can also use a external generator for directory listings if you use |
|
mod_indexfile. :: |
|
|
|
index-file.names = ( "/dir-generator.php" ) |
|
|
|
If a directory is requested the dir-generator.php is called instead which can |
|
take the REQUEST_URI to see which directory was requested. |
|
|
|
For large folders this is highly recommend. |
|
|
|
Options |
|
======= |
|
|
|
dir-listing.activate |
|
enables virtual directory listings if a directory is requested no |
|
index-file was found |
|
|
|
Default: disabled |
|
|
|
dir-listing.hide-dotfiles |
|
if enabled, does not list hidden files in directory listings generated |
|
by the dir-listing option. |
|
|
|
Default: enabled |
|
|
|
dir-listing.external-css |
|
path to an external css stylesheet for the directory listing |
|
|
|
dir-listing.exclude |
|
list of regular expressions. Files that match any of the specified regular |
|
expressions will be excluded from directory listings. |
|
|
|
dir-listing.encoding |
|
set a encoding for the generated directory listing |
|
|
|
If you file-system is not using ASCII you have to set the encoding of |
|
the filenames as they are put into the HTML listing AS IS (with XML |
|
encoding) |
|
|
|
Example: :: |
|
|
|
dir-listing.encoding = "utf-8" |
|
|
|
dir-listing.show-readme |
|
shows README.txt after the dirlisting if it exists in the directory |
|
|
|
Default: disabled |
|
|
|
dir-listing.hide-readme-file |
|
hides README.txt in the dirlisting |
|
|
|
Default: disabled |
|
|
|
dir-listing.show-header |
|
shows HEADER.txt before the dirlisting if it exists in the directory |
|
|
|
Default: disabled |
|
|
|
dir-listing.hide-header-file |
|
hides HEADER.txt in the dirlisting |
|
|
|
Default: disabled |
|
|
|
dir-listing.set-footer |
|
|
|
Default: empty, uses server.tag instead |
|
|
|
dir-listing.encode-readme |
|
encodes all control characters, '&', '<', '>' and '\x7f' as &#x**; |
|
|
|
Default: enabled |
|
|
|
dir-listing.encode-header |
|
encodes all control characters, '&', '<', '>' and '\x7f' as &#x**; |
|
|
|
Default: enabled |
|
|
|
dir-listing.auto-layout |
|
Disable this if you want your own html header and footer; specify |
|
them in HEADER.txt and README.txt |
|
|
|
you have to enable dir-list.show-readme/header for this of course |
|
|
|
.external-css and .set-footer will be ignored if this is disabled |
|
|
|
Default: enabled
|
|
|