NAME
dwww-convert - convert files to HTML for dwww
SYNOPSIS
dwww-convert [--no-path-info] type location
DESCRIPTION
dwww-convert is part of the dwww package, which provides access to on-line documentation on a Debian system via WWW. dwww-convert converts documentation to HTML so that it can be viewed with a WWW browser. dwww-convert is usually run by the WWW server, but can also be run by hand.
The type argument gives the type of the file, one of:
file |
An arbitrary file; the type is guessed using simple heuristics based on the filename. | ||
dir |
A directory. If the directory contains the file index.html or index.htm that file will be returned. Otherwise, A listing of the files in the directory is generated. | ||
html |
An HTML file. The file is returned as is. | ||
man |
A manual page. The location is the pathname of the nroff source file. | ||
runman |
A manual page. The location is the name of the manual page and its section, separated by a slash. For example, the location would be intro/1 to refer to the intro(1) manual page. | ||
info |
An Info file. | ||
text |
A plain text file (using the ISO-8859-1 character set). |
An unknown file type is treated as text.
The location argument gives the filename of the file. The name must be complete, i.e., it must start at the root directory (/). The name must not contain any symbolic links (cf. realpath(1)). The file must be located in or below a directory that has been allowed by the system administrator; see dwww(7) for more info.
The file may be compressed with gzip(1) or bzip2(1). It is uncompressed automatically and invisibly. Compression is indicated by a filename that ends in ’.gz’ or ’.bz2’.
OPTIONS
--no-path-info
Internal option used by the dwww’s CGI script to let dwww-convert know, that the arguments following the option do not come from the PATH_INFO variable, but from the QUERY_STRING.
FILES
/etc/dwww/dwww.conf
Configuration file for dwww. See dwww(7) for more information.
SEE ALSO
dwww(7), dwww-txt2html(8), dwww-build(8), dwww-cache(8).
AUTHOR
Lars Wirzenius.
Modified by Robert Luberda.
See dwww(7) for copyrights and stuff.