summaryrefslogtreecommitdiff
path: root/doc/dirlisting.txt
blob: 3b337529691d9163964f8d53aa731ac6a4dba8a3 (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
==================
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"