GuiSGML Config

Tool Types

Tooltypes are used to set the defaults of GuiSGML. Some tooltypes can't yet be changed once GuiSGML is running. This will be improved in the future. This page is not yet complete.

ToolType	Description	Version
PUBSCREEN	Makes GuiSGML open its windows on a public screen. E.G. PUBSCREEN=WWW	V0.2
SGMLPATH	The path to the directory holding the source SGML files.	V0.2
PUBLISHPATH	The path to the directory where SGML files are saved when published. This can be changed by clicking Set Publish Dir when GuiSGML is running.	V0.2
TEMPLATEPATH	The path to the directory holding the template files. Each template file in this directory will be loaded in to the template list.	V0.2
SGMLVIEWCMD	The name of the script or command to view SGML/HTML with. A script called ViewSGML is included which calls upon YAM2URL to display the file. YAM2URL is not included, visit www.yam.ch for YAM2URL	V0.2
PATHMAPS	The name of the path mapping file. A path mapping file can be used to on-the-fly translate filenames in the sourcefiles to a different system type E.G. Amiga paths /xxx are read as ../xxx because the batch processing uses the linux version instead of the Amiga version where the source filewas created. This file is in SGML format (why create a new format when you have a good parser???) A file can be made up from one or more of the following directives. Only the same directive should be used in the file. You can't put AMIGATOPC and AMIGATOUNIX in the same file. The latter will be ignored. <AMIGATOPC> <AMIGATOPC FROM=Work: TO=D:> <AMIGATOUNIX FROM=Work: TO=.> <PCTOUNIX FROM=D: TO=.> (and viceversa) PCTOAMIGA, UNIXTOAMIGA, PCTOUNIX	V0.6
All tooltypes can be system wide environment variables to enable use from the command line.

Tag_List File

The file Tag_List is used to add tags to the tag list in the main control panel. This file can be a simple list of the tags, each on a separate line. V0.2 supported only this. From V0.3, it is possible to define how any given tag is displayed in the SGML window using display formats.

A Display format is defined using the SGML tag name DISPLAYFMT. A NAME argument specifies the name of the display format. A FMT arg specifies the format to be displayed. $_ can be used for the tag name being displayed, and arguments from the tag being displayed can be used. For example, A display format may want to show on the screen the HREF argument of an anchor (A).

DISPLAYFMT NAME=HREFTEST FMT="$_ ($HREF)"

DISPLAYFMT defines a format that can be shared among many tags. To define a tag and the display format it uses, use the SGML tag NEWTAG. A NAME argument will supply the name of the tag to be added.Use DISPLAYFMT and the name of a previousy defined format as described above.

NEWTAG NAME=A DISPLAYFMT=HREFTEST

For examples, look at the Tag_List file included in the archive. This is loaded when GuiSGML is run.

Questions? Drop the author an email.