Table of Contents
Advertisement
8
C r e a t i n g o r u p d a t i n g a n E D D f r o m a D T D
to a FrameMaker element definition of the same name, and it produces an attribute
definition for each attribute defined for the element.
Note that DTDs contain syntactic information about the structure of a class of documents,
but they do not address the semantics of elements they define. For example, DTDs do not
distinguish between an element used to define an equation and one used to define a
marker. For this reason, the default translation may not convert all of the markup elements
correctly. (An exception to this is CALS tables. If your DTD uses the CALS table model,
FrameMaker does recognize those elements as table elements.) You can modify the default
translation using read/write rules.
For details on the translation of each type of element, see Part III, "Translating between
markup data and FrameMaker."
Updating an EDD from a DTD
These are two of the reasons you may need to update an EDD:
•
If you started the EDD from a DTD, in most cases you need to modify the translation by
developing and testing read/write rules in an iterative process. As part of each iteration,
you update the EDD using the DTD and your current set of read/write rules.
•
If any element or attribute declarations in the DTD change, you update the EDD to revise
the corresponding definitions in the EDD.
To update an EDD from a DTD, choose Import DTD from the File>Structure Tools submenu
in the EDD. Select the DTD in the Import DTD dialog box. If the Use Application dialog box
appears, select a structure application for the EDD. (Use Application appears only if no
application is specified in the EDD.)
In the updated EDD, FrameMaker adds definitions for new elements from the DTD, removes
definitions for elements that are no longer defined, and revises the content rules and
attribute definitions for the remaining elements to match changes in the DTD and the current
read/write rules. Any format rules and comments in the EDD are not affected, except for
those in definitions that have been removed. (The software records these changes in a log
file.) You can save the modified EDD if you want to keep the changes.
Log files for a translated DTD
If FrameMaker encounters any problems while starting or updating an EDD from a DTD, it
produces a log file of warnings and errors. A warning is a notification of a potential problem,
but it does not necessarily mean something is wrong with the DTD or the resulting EDD.
An error indicates an actual problem in the processing; some errors can cause the
processing to stop altogether.
A log file can have warning messages for conditions such as name changes, and it can
have error messages for markup syntax errors, read/write rule errors, and missing files. If
you're updating an EDD from a DTD, the log file also includes a list of changes made to
Structure Application Developer's Guide
79
Advertisement
Table of Contents
