Perl Documentation

NAME

typeless_uri - convert typeless URIs (URIs without extension) to working file references

SYNOPSIS

# uri_to_file must go first.
Plugin uri_to_file
Plugin typeless_uri

# required
DirectoryIndex index
# optionally
URIExtensions html xhtml xsp

DESCRIPTION

This plugin provides the filename for a given URI. It supplements uri_to_file and provides typeless URIs, i.e. URIs that do not contain a file extension.

See http://www.w3.org/Provider/Style/URI for a discussion of why this is a Good Thing (TM).

It works by trying several extensions on the given URI until the resulting file exists.

CONFIG

URIExtensions STRINGLIST

A list of file extensions to try in sequence not including the leading dot.

<Files>

Since file types can vary widely depending on filesystem contents, this plugin adds <Files> sections that work exactly like <Location> sections, except they match against the fully qualified file name of the requested page. Use this sparingly, as it can lead to all sorts of problems. Mainly, it is intended to set type-specific options, nothing else. Use <Location> for all other purposes.

TODO

Content Negotiation should be investigated for another level of flexibility.