Mod dirlisting » History » Revision 24
« Previous |
Revision 24/40
(diff)
| Next »
KittyKatt, 2010-03-06 22:21
- Table of contents
- Module mod_dirlisting - Directory Listings
- Description
- Options
- dir-listing.activate
- dir-listing.hide-dotfiles
- dir-listing.external-css
- dir-listing.exclude
- dir-listing.encoding
- dir-listing.show-readme
- dir-listing.hide-readme-file
- dir-listing.show-header
- dir-listing.hide-header-file
- dir-listing.set-footer
- dir-listing.encode-header
- dir-listing.encode-readme
- dir-listing.auto-layout
Module mod_dirlisting - Directory Listings¶
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" )For those with an old config file, the obsolete value is:
server.indexfiles = ( "/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.
The dir-generator.php file can be found at the bottom of this document or at:
http://www.archerseven.com/kittykatt/index.php?page=scripts&sub=lighttpdlisting
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 #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"
The following 3 options are currently available as of 1.4.23:¶
dir-listing.encode-header¶
this option is a boolean.
It gives the ability to provide a valid html file as HEADER.txt, this file is just printed before the actual listing. See also dir-listing.encode-readme.
default value: enable
dir-listing.encode-readme¶
this option is a boolean.
It gives the ability to provide a valid html file as README.txt, this file is just printed after the actual listing. See also dir-listing.encode-header.
default value: enable
dir-listing.auto-layout¶
this option is a boolean.
When disabled, it will remove the html part lighttpd was automatically outputing as the start of the page and the end (from <DOCTYPE to <body> and </body></html>). This lets the possibility to take care of those parts in the header and readme files.
default value: enable
Updated by KittyKatt over 14 years ago · 24 revisions