As an author or user of printed books, you are probably familiar with
cross-references and perhaps with the markup used to create them. The
same tags are used in online books to create cross-reference links within
a book.
Readers of a printed book can turn to a referenced figure, for example,
and so can readers of an online book. However, cross-reference links in
an online book go a step further. For readers of an online book, moving
to a referenced figure is quicker and easier: they put the cursor on the
cross-reference and press ENTER to move to the referenced item. After
selecting a link for a topic, they see the beginning of the referenced
topic. If they select a link for a table or for a list item, they move to
the table or list item. When they finish viewing the referenced table or
list item, they can easily return to where they began.
The tags shown in Table 2 are available with the GML Starter Set and
BookMaster, and are frequently used in printed books. If any of these
tags are in the markup, the resulting online book automatically has
cross-reference links.
|
|
| Table 2. Typical GML Tags for Cross-Reference Links |
| This tag |
Moves the reader to this location |
| :HDREF |
The referenced document element |
| :FIGREF |
The referenced figure |
:FNREF
|
The referenced footnote, or a window that displays the
footnote text |
| :LIREF |
The referenced list item |
| :TREF |
The referenced table |
The tags shown in Table 3 are available with BookMaster and are common to
many technical or application-specific documents, such as step-by-step
procedures. They also create cross-reference links by their presence in
the markup.
|
|
| Table 3. Special BookMaster Tags for Cross-Reference Links |
| This tag |
Moves the reader to this location |
| :SPOTREF |
The referenced spot |
| :CIREF |
The referenced component item |
| :STEPREF |
The referenced step |
| :QREF |
The referenced question |
| :ANSREF |
The referenced answer |
|
IBM BookManager BUILD/MVS V1R3 Preparing Online Books
Copyright IBM Corporation 1990, 2014