Sgml Declarations; Log Files For A Translated Edd; Sample Documents And Edds - Adobe 65030365 - FrameMaker - PC Developer's Manual

8
S a m p l e d o c u m e n t s a n d E D D s

SGML declarations

FrameMaker runs a new DTD through an XML or SGML parser. In the process, it may
identify errors in the syntax of the DTD. Two of the most common errors are invalid SGML
names and an inappropriate SGML declaration. You can use read/write rules to translate
FrameMaker element tags to valid SGML names.
For SGML, if the default SGML declaration that FrameMaker provides is not appropriate for
your DTD, you can modify the declaration to avoid capacity and quantity errors. The default
SGML declaration for FrameMaker uses the reference concrete syntax and the reference
quantity set. To change to a different declaration, insert an SGMLDeclaration element in
the application's definition in structapps.fm and type the pathname for the new
declaration. For a description of the default SGML declaration and the variations that
FrameMaker supports, see Appendix D, "SGML Declaration."
If you need to reapply the parser to a DTD but not recreate the DTD, select File>Structure
Tools>Parse Structured Document.

Log files for a translated EDD

If FrameMaker encounters any problems while creating a DTD from an EDD, 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 EDD or the resulting DTD. 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 FrameMaker syntax errors, read/write rule errors, capacity and
quantity errors, and missing files.
This is an example of a message in a log file:
/usr/fmsgml/tutorial/chapter.edd; line 24
Invalid property specified for element "AFrame".
The first line in the message gives the location of the problem in the EDD; you can click
this line to go to the problem in the EDD. The second line describes the problem; you can
click this line to see a longer explanation.
A log file is initially locked so that you can click in it to use the hypertext links. If you want
to save the log file, you must first unlock it by pressing Esc Flk. (Press Esc Flk again to
relock the file.) For general information on log files, see "Log files" on page 71.

Sample documents and EDDs

FrameMaker comes with several structured documents and EDDs that you can review as
samples or use as a starting point for developing EDDs of your own. You'll find the files in
the following directories.
•
For UNIX:
Structure Application Developer's Guide 107