summaryrefslogtreecommitdiff
path: root/data/lighttpd/lighttpd-1.4.53/doc/outdated/dirlisting.txt
blob: 5dd6873d9555e2e0afea852fba2f1caf4408f0b5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
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