(c) 2004 by Peer Schaefer (email@example.com). dir2html is free software (see license below).
dir2html generates an (optionally) commented HTML indexfile for a directory and (optionally) for all its subdirectories (and all its subsubdirs etc.)
And here are the downloads (written for perl v5.6.1):
Bug-reports, suggestions, corrections of my bad english (or just congratulations) are welcome! Send to Peer Schaefer, firstname.lastname@example.org.
Usage: dir2html [OPTIONS] [--] [DIRECTORY]
DIRECTORY should specify the directory (path from the current directory) for which the indexfile has to be generated. If DIRECTORY is omitted, the indexfile is created for the current directory.
|-o FILE, --output FILE||The default name for the created indexfile is
`index.html'. With this option you can
change it to FILE. If you specify `-' as FILE, then all output will be written to the standard output STDOUT. Multiple files
will be seperated by form feeds (\f = 0x0c = ASCII #12).
|-r, --recursively||An indexfile is not only generated for the specified
DIRECTORY but also for all its subdirectories (and
subsubdirs etc.). Each
indexfile is placed in the respective directory.
|-c FILE, --commentfile FILE||Creates a commented indexfile. All comments are
generated using the specified FILE. The FILE should be a
plain textfile (ASCII)
and each line should be in the following format:
If the created indexfile contains a reference to the
file (or directory) FILENAME, then the COMMENTARY is
written beneath the
|-b NAME, --base NAME||In the indexfile use NAME as the name of the DIRECTORY. The default is `/'. If you create indexfiles for subdirectories (using the -r option) the paths of these are based on NAME. That makes NAME your virtual `root'.|
|-p CHAR, --pathseparator CHAR||Uses the character CHAR to separate the names of files and directories in the path which is displayed in the title of the indexfile. Default is the Unix style slash `/'. Windows users may find it convenient to replace it with a backslash `\' (to avoid confusing your shell you may use the keyword `backslash' instead of `\').|
|-v, --version||Display the program version|
|-l, --license||Display the license|
|-h, --help||Display this help screen|
|-h2, --advanced-help||Display another help screen with advanced options.|
There are some advanced options for controlling the standard behaviour of the program. For these options please refer to the advanced help-screen, available through the -h2 option.
Send bug reports or suggestions to: email@example.com
A DIRECTORY name beginning with an `-' can be placed after a `--' to make clear that it is not an OPTION.
The program looks for a file named `dir2html.ini' in the current directory. If the file (called INI-file) is present, the program reads the file and scans it. Inside the INI-file you can configure the program similar to configuring it with options like -o or -r (use -h option for details). The INI-file should be a plain ASCII-textfile. The INI-file should have a section titled `[Defaults]' that contains commands in the format
KEY = VALUE
The following KEYS are available:
|KEY||EFFECT AS OPTION||POSSIBLE VALUES|
|OutputFile||-o||see description of the -o option|
|Recursively||-r||YES or NO|
|CommentFile||-c||see description of the -c option|
|Base||-b||see description of the -b option|
|Exclamation||-x||see description of the -x option|
|PathSeparator||-p||see description of the -p option|
|Timestamp||-s||see description of the -s option|
|Title||-t||see description of the -t option|
|Filetype||-f||see description of the -f option|
|FileCounter||-cf||YES or NO|
|DirCounter||-cd||YES or NO|
|Tree||-e||YES or NO|
|Dirfiles||-d||see description of the -d option|
To create an example INI-file (containing the default values) use the option -ci or --create-inifile.
dir2html generates an (optionally) commented HTML indexfile for a directory and (optionally) for all its subdirectories (and all its subsubdirs etc.).
Written & copyright (c) 2004 by Peer Schaefer.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the
Free Software Foundation, Inc.
59 Temple Place, Suite 330, Boston, MA 02111-1307
It's also available from the web at http://www.gnu.org.
Return to my home page (in german)