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