summaryrefslogtreecommitdiff
path: root/data/lighttpd/lighttpd-1.4.53/doc/outdated/dirlisting.txt
diff options
context:
space:
mode:
Diffstat (limited to 'data/lighttpd/lighttpd-1.4.53/doc/outdated/dirlisting.txt')
-rw-r--r--data/lighttpd/lighttpd-1.4.53/doc/outdated/dirlisting.txt126
1 files changed, 126 insertions, 0 deletions
diff --git a/data/lighttpd/lighttpd-1.4.53/doc/outdated/dirlisting.txt b/data/lighttpd/lighttpd-1.4.53/doc/outdated/dirlisting.txt
new file mode 100644
index 000000000..5dd6873d9
--- /dev/null
+++ b/data/lighttpd/lighttpd-1.4.53/doc/outdated/dirlisting.txt
@@ -0,0 +1,126 @@
+==================
+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 characers, '&', '<', '>' and '\x7f' as &#x**;
+
+ Default: enabled
+
+dir-listing.encode-header
+ encodes all control characers, '&', '<', '>' 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