The output produced by GED2HTML is extensively customizable to suit
the tastes of individual users. There are two main ways to customize
the output: (1) by selecting various options settings on the GED2HTML
command line; (2) by modifying or rewriting the output program that
controls the generation of the HTML output.
Most people will probably find the amount of customization that
can be performed via the command line options to be adequate for their needs.
We discuss the mechanics of making these customizations below.
Modifying the output programs is more involved, and is discussed
GED2HTML understands command-line arguments according to the following
"Unix man page style" synopsis:
ged2html [-HvDft] [[--] <gedcom-file> ...]
The various arguments have the following meanings:
Nearly all the processing options that can be selected in a GED2HTML run
are accessed by initializing certain variables of the output interpreter
to have certain values. Initialization of output interpreter variables
can be accomplished in three different ways:
- By using the -D command line option to initialize the variables.
- By using the -f command line option to select an options file.
The "set_options" procedure in the options file
is executed before any other processing occurs, for the purpose
of initializing output interpreter variables.
- By adding code to the procedure "do_initialize" in the output
program, to perform the desired initializations.
For a list of all the output interpreter variables that can be
initialized to select processing options, see
As indicated above, GED2HTML has several different mechanisms for
selecting options that modify its behavior. A summary of these
mechanisms, in the order in which they occur when GED2HTML is run
is the following:
- When GED2HTML starts, predefined default values are set for
all the options.
- If an options file has been specified using the "-f" command
line flag, then this file is read and compiled by the
GED2HTML output language compiler. Then, the procedure
"set_options" in this file is executed by the GED2HTML
output language interpreter.
- GED2HTML processes any additional options the user might
have specified using the "-D" command line flag.
Any such additional options settings override those
from steps (1) and (2).
- If an assignment has been made to the OUTPUT_PROGRAM option
variable in step (2) or (3), then the specified output
program is located and compiled. Otherwise, the built-in
standard output program is used.
- GED2HTML executes the procedure do_initialize in the
output program. Any options settings made in this procedure
will override those made in previous steps.
- GED2HTML reads the GEDCOM file and produces output.
GED2HTML home page
Copyright © 1995-2004 Eugene W. Stark. All rights reserved.
SEND ME EMAIL