| 1 | ================== |
|---|
| 2 | Directory Listings |
|---|
| 3 | ================== |
|---|
| 4 | |
|---|
| 5 | ---------------------- |
|---|
| 6 | Module: mod_dirlisting |
|---|
| 7 | ---------------------- |
|---|
| 8 | |
|---|
| 9 | :Author: Jan Kneschke |
|---|
| 10 | :Date: $Date: 2004/11/03 22:26:05 $ |
|---|
| 11 | :Revision: $Revision: 1.2 $ |
|---|
| 12 | |
|---|
| 13 | :abstract: |
|---|
| 14 | mod_dirlisting generates HTML based directory listings with full CSS |
|---|
| 15 | control |
|---|
| 16 | |
|---|
| 17 | .. meta:: |
|---|
| 18 | :keywords: lighttpd, directory listings, dirlisting |
|---|
| 19 | |
|---|
| 20 | .. contents:: Table of Contents |
|---|
| 21 | |
|---|
| 22 | Description |
|---|
| 23 | =========== |
|---|
| 24 | |
|---|
| 25 | mod_dirlisting is one of the modules which is loaded by default and don't have to |
|---|
| 26 | be specified on server.modules to work. |
|---|
| 27 | |
|---|
| 28 | A directory listing is generated if a directory is requested and no index-file |
|---|
| 29 | was found in that directory. |
|---|
| 30 | |
|---|
| 31 | To enable directory listings globally: :: |
|---|
| 32 | |
|---|
| 33 | dir-listing.activate = "enable" |
|---|
| 34 | |
|---|
| 35 | If you need it only for a directory, use conditionals: :: |
|---|
| 36 | |
|---|
| 37 | $HTTP["url"] =~ "^/download($|/)" { |
|---|
| 38 | dir-listing.activate = "enable" |
|---|
| 39 | } |
|---|
| 40 | |
|---|
| 41 | You can also use a external generator for directory listings if you use |
|---|
| 42 | mod_indexfile. :: |
|---|
| 43 | |
|---|
| 44 | index-file.names = ( "/dir-generator.php" ) |
|---|
| 45 | |
|---|
| 46 | If a directory is requested the dir-generator.php is called instead which can |
|---|
| 47 | take the REQUEST_URI to see which directory was requested. |
|---|
| 48 | |
|---|
| 49 | For large folders this is highly recommend. |
|---|
| 50 | |
|---|
| 51 | Options |
|---|
| 52 | ======= |
|---|
| 53 | |
|---|
| 54 | dir-listing.activate |
|---|
| 55 | enables virtual directory listings if a directory is requested no |
|---|
| 56 | index-file was found |
|---|
| 57 | |
|---|
| 58 | Default: disabled |
|---|
| 59 | |
|---|
| 60 | dir-listing.hide-dotfiles |
|---|
| 61 | if enabled, does not list hidden files in directory listings generated |
|---|
| 62 | by the dir-listing option. |
|---|
| 63 | |
|---|
| 64 | Default: enabled |
|---|
| 65 | |
|---|
| 66 | dir-listing.external-css |
|---|
| 67 | path to an external css stylesheet for the directory listing |
|---|
| 68 | |
|---|
| 69 | dir-listing.exclude |
|---|
| 70 | list of regular expressions. Files that match any of the specified regular |
|---|
| 71 | expressions will be excluded from directory listings. |
|---|
| 72 | |
|---|
| 73 | dir-listing.encoding |
|---|
| 74 | set a encoding for the generated directory listing |
|---|
| 75 | |
|---|
| 76 | If you file-system is not using ASCII you have to set the encoding of |
|---|
| 77 | the filenames as they are put into the HTML listing AS IS (with XML |
|---|
| 78 | encoding) |
|---|
| 79 | |
|---|
| 80 | Example: :: |
|---|
| 81 | |
|---|
| 82 | dir-listing.encoding = "utf-8" |
|---|
