Table of Contents
Advertisement
7
A p p l i c a t i o n d e f i n i t i o n f i l e
Element
Public
EntitySearchPaths
If you use the EntityCatalogFile element, you cannot use any of the elements Entity,
FilenamePattern, or Public.
You can have only one Entities element for each application, although that Entities
element can have more than one of some of its child elements. The Entities element
can also be a child of the Defaults element.
Specifying entities through an entity catalog
The EntityCatalogFile element specifies a file containing mappings of an entity's
public identifier or entity name to a filename. It looks like:
Entity locations
Entity catalog file: fname
where fname is the filename of the entity catalog. Entity catalogs and their specified format
are described later.
You can specify multiple EntityCatalogFile elements in a single Entities element.
If you use this element, you cannot use any of the Entity, FilenamePattern, or Public
elements.
You can use the EntityCatalogFile element both in the Entities element of the
Defaults element and in an SGMLApplication or XMLApplication element to specify
information for a particular application. When searching for an external entity, FrameMaker
searches the application's entity catalogs before searching those in default
EntityCatalogFile elements.
If you have an EntityCatalogFile element in an application definition, the software
ignores Entity, FilenamePattern, and Public elements in the Defaults element.
Why use entity catalogs
Technical Resolution 9401:1994 published by SGML Open relates to entity management
issues affecting how SGML documents work with each other:
•
Interpreting external identifiers in entity declarations so that an SGML document can be
processed by different tools on a single computer system
•
Moving SGML documents to different computers in a way that preserves the association
of external identifiers in entity declarations with the correct files or other storage objects
The technical resolution uses entity catalogs and an interchange packaging scheme to
address these issues. FrameMaker supports such entity catalogs with the
EntityCatalogFile element.
Working with Special Files
Discussed in
"Specifying public identifiers" on page 61
"Specifying a search path for external entity files" on
page 63
58
Advertisement
Table of Contents
