← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/outdated/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/outdated/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