Table of Contents
Advertisement
17
M o d i f i c a t i o n s t o t h e d e f a u l t t r a n s l a t i o n
where fmtag is the name of an element on a FrameMaker reference page in the associated
FrameMaker template and ename is an SGML entity.
The fmtag element must occur in a flow named Reference Elements. That flow must
be on a reference page with a name that starts with SGML Utilities Page—for
example, SGML Utilities Page 1 or SGML Utilities Page Logos. For information
on working with reference pages, see the FrameMaker using manual.
When FrameMaker encounters references to the specified entity while importing an SGML
document, it copies the appropriate element from its reference page in the associated
FrameMaker template. When it encounters an instance of an element associated with one
of the reference pages while exporting a document, it generates an entity reference.
For example, to have an entity named logo correspond to an anchored frame with your
company's logo, you can add this entity declaration to your DTD:
<!ENTITY logo SDATA "fm ref: Logo">
Alternatively, if your DTD contains an entity declaration such as:
<!ENTITY logo SDATA "[logo]">
you can add the following rule to your rules document:
entity "logo" is fm reference element "Logo";
You can choose to have this translation only happen on import of an SGML document. For
more information, see "Translating entity references on import and export" on page 258.
For information on these rules, see "entity" on page 381 and "is fm reference element" on
page 430.
Translating external text entities as text insets
External text entities specify a reference to an external file that is either markup or text. By
default, on import FrameMaker translates the entity as a text inset. Note that the specified
file cannot be a FrameMaker document because such an entity declaration would not be
valid markup.
If the referenced entity declaration was made in the DTD subset of the markup document,
FrameMaker stores information about it on the Entity Declarations reference page. On
export, it uses that information to generate entity declarations in the DTD subset of the
markup.
Unless the source file is markup, insertion of a FrameMaker text inset in a document always
inserts an end of paragraph in the document. For this reason, you should be careful about
which external text entities must translate to entire paragraphs or occur only at the end of
a paragraph.
FrameMaker has options to update text insets manually or automatically whenever the user
opens the document containing the text insets. By default, external text entities import as
Translating Entities and Processing Instructions
264
Advertisement
Table of Contents
