127 lines
2.9 KiB

Directory Listings
Module: mod_dirlisting
:Author: Jan Kneschke
:Date: $Date: 2004/11/03 22:26:05 $
:Revision: $Revision: 1.2 $
mod_dirlisting generates HTML based directory listings with full CSS
.. meta::
:keywords: lighttpd, directory listings, dirlisting
.. contents:: Table of Contents
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.
enables virtual directory listings if a directory is requested no
index-file was found
Default: disabled
if enabled, does not list hidden files in directory listings generated
by the dir-listing option.
Default: enabled
path to an external css stylesheet for the directory listing
list of regular expressions. Files that match any of the specified regular
expressions will be excluded from directory listings.
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
Example: ::
dir-listing.encoding = "utf-8"
shows README.txt after the dirlisting if it exists in the directory
Default: disabled
hides README.txt in the dirlisting
Default: disabled
shows HEADER.txt before the dirlisting if it exists in the directory
Default: disabled
hides HEADER.txt in the dirlisting
Default: disabled
Default: empty, uses server.tag instead
encodes all control characters, '&', '<', '>' and '\x7f' as &#x**;
Default: enabled
encodes all control characters, '&', '<', '>' and '\x7f' as &#x**;
Default: enabled
Disable this if you want your own html header and footer; specify
them in HEADER.txt and README.txt
you have to enable for this of course
.external-css and .set-footer will be ignored if this is disabled
Default: enabled