Catalogs

Catalog files

epcEdit uses SGML Open catalog files to locate DTDs and SGML entities. Existing catalogs can be used by epcEdit without modifications (although some constructs in catalogs are not supported and may produce a warning when encountered).Although catalogs can be stored in the same directories as SGML documents, we strongly advise against this practice. Basically, storing catalogs together with documents is acceptable as long as documents will never be moved into other directories; strange results can occur when documents are stored (either by saving from an SGML editor or by copying) in directories without the corresponding catalog files.

We therefore suggest to use a centralized SGML catalog that can include the required subcatalogs by means of a CATALOG statement. To allow epcEdit to find the central catalog(s), the pathname of the catalog file(s) should be stored in the environment variable SGML_CATALOG_FILES. This environment variable could be set in your personal startup file (~/.profile) or in a system-wide profile (for the bash-shell, this would be etc/profile or a file included by this system wide startup file).

As an example, the following two lines might be added to ~/.profile (assuming that the central catalog is stored in the file /usr/share/sgml/catalog):

SGML_CATALOG_FILES=/usr/share/sgml/catalog
export SGML_CATALOG_FILES

Please consult your shell documentation for details on setting environment variables and startup files.

epcEdit makes use of this environment variable to locate catalog files, as well as it can use its own catalog files (set in Edit - Preferences - Catalogs) in addition to that. The syntax of catalog files is described in the epcEdit Manual.

[Home] [News] [Products] [Support] [License] [Contact]