← Back to branch summary

~ubuntu-branches/ubuntu/saucy/lighttpd/saucy

« back to all changes in this revision

Viewing changes to doc/dirlisting.txt

  • Committer: Package Import Robot
  • Author(s): Lorenzo De Liso
  • Date: 2012-12-06 17:54:59 UTC
  • mfrom: (6.1.20 sid)
  • Revision ID: package-import@ubuntu.com-20121206175459-aq6vz5xa9fa202jw
Tags: 1.4.31-3ubuntu1
* Merge from debian unstable, remaining changes:
  - debian/control: libgamin-dev rather than libfam-dev to fix startup warning.
  - debian/index.html: s/Debian/Ubuntu/g branding on the default page.
  - Added a UFW profile set:
    + debian/lighttpd.dirs: added etc/ufw/applications.d
    + debian/rules: install the ufw profile.
    + debian/control: Suggests on ufw.
  - Add lighttpd-dev package:
    + debian/control: Added lighttpd-dev package; Build-depends on
      automake, libtool
    + debian/lighttpd-dev.install: Added.
  - debian/rules: Add override_dh_installinit to set "defaults 91 09" to not
    start before apache2 but in the same runlevel with the same priority.
  - debian/patches/build-dev-package.patch: Updated
  - debian/lighttpd.conf: Comment 'use-ipv6.pl' by default, which causes
    failure to bind port in ipv4
* debian/index.html: corrected BTS Ubuntu link for lighttpd

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/dirlisting.txt
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"
83
 
 
84
 
dir-listing.show-readme
85
 
  shows README.txt after the dirlisting if it exists in the directory
86
 
 
87
 
  Default: disabled
88
 
 
89
 
dir-listing.hide-readme-file
90
 
  hides README.txt in the dirlisting
91
 
 
92
 
  Default: disabled
93
 
 
94
 
dir-listing.show-header
95
 
  shows HEADER.txt before the dirlisting if it exists in the directory
96
 
 
97
 
  Default: disabled
98
 
 
99
 
dir-listing.hide-header-file
100
 
  hides HEADER.txt in the dirlisting
101
 
 
102
 
  Default: disabled
103
 
 
104
 
dir-listing.set-footer
105
 
 
106
 
  Default: empty, uses server.tag instead
107
 
 
108
 
dir-listing.encode-readme
109
 
  encodes all control characers, '&', '<', '>' and '\x7f' as &#x**;
110
 
 
111
 
  Default: enabled
112
 
 
113
 
dir-listing.encode-header
114
 
  encodes all control characers, '&', '<', '>' and '\x7f' as &#x**;
115
 
 
116
 
  Default: enabled
117
 
 
118
 
dir-listing.auto-layout
119
 
  Disable this if you want your own html header and footer; specify
120
 
  them in HEADER.txt and README.txt
121
 
 
122
 
  you have to enable dir-list.show-readme/header for this of course
123
 
 
124
 
  .external-css and .set-footer will be ignored if this is disabled
125
 
 
126
 
  Default: enabled