==================
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"