Mod dirlisting » History » Revision 14
Revision 13 (Anonymous, 2007-08-21 21:12) → Revision 14/40 (hr, 2007-11-14 16:36)
[[TracNav(DocsToc)]]
{{{
#!rst
==================
Directory Listings
==================
----------------------
Module: mod_dirlisting
----------------------
.. meta::
:keywords: lighttpd, directory listings, dirlisting
.. contents:: Table of Contents
Description
===========
mod_dirlisting is one of the modules that is loaded by default and doesn'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 an 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 recommended.
Options
=======
dir-listing.activate
enables virtual directory listings if a directory is requested no
index-file was found.
Default value: disable
dir-listing.hide-dotfiles
if enabled, does not list hidden files in directory listings generated
by the dir-listing option.
Default value: disable
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.
Use inside of conditionals was broken before 1.4.14. See http://trac.lighttpd.net/trac/ticket/1260.
dir-listing.encoding
set a encoding for the generated directory listing.
If your 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
show the contents of the README.txt file after the directory listing.
Default value: disable
dir-listing.hide-readme-file
hide README.txt files from the directory listing.
Default value: disable
dir-listing.show-header
show the contents of the HEADER.txt file before the directory listing.
Default value: disable
dir-listing.hide-header-file
hide HEADER.txt files from the directory listing.
Default value: disable
dir-listing.set-footer
displays a string in the footer of a listing page.
Default value: "<PACKAGE_NAME>/<PACKAGE_VERSION>" ie. "lighttpd/1.4.18"
}}}