Customizing GED2HTML Output under Unix

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 here.

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:

  1. By using the -D command line option to initialize the variables.
  2. 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.
  3. 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 here.

Order of Options Processing

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:
  1. When GED2HTML starts, predefined default values are set for all the options.

  2. 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.

  3. 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).

  4. 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.

  5. GED2HTML executes the procedure do_initialize in the output program. Any options settings made in this procedure will override those made in previous steps.

  6. GED2HTML reads the GEDCOM file and produces output.

GED2HTML home page

Copyright © 1995-2004 Eugene W. Stark. All rights reserved.