Abstract

docsite is a Document Site Generator .

Its main purpose is to simply generate an entire tree of directories and documents for a web server from a set of preformatted documents in a source folder tree and a file describing the folder structure, document titles and some additional text.

Usage

On a Windows operating system the GUI version of the generator is started by

docsite-gui

In a Unix/Linux environment the call is simply

docsite

When at least three additional arguments are passed on the command line, the batch version of the generator is used automatically.

The arguments are the same as for the Windows command line version:

docsite <desc-file> <source-dir> <target-dir>

Where

desc-file

is the description file for the site. Either a local file or a URL may be used here.

source-dir

is the source directory for files to be placed in the site. This may either be a local directory or an FTP URL.

target-dir

is the target directory for the site. This may either be a local directory or an FTP URL.

FTP-URLs

An FTP URL has the following general format:

ftp://username@hostname:port/directory?locale=us_en

If the :port part is left out, the FTP standard port 21 is used.

username

the login name of the FTP user.

hostname

the host name or IP address of the FTP server.

port

the port number of the FTP command server.

directory

base directory

locale=xx_yy

locale used on the FTP server. This is mainly used to parse date information from FTP file listings.