Structuring Documents with FrameBuilder
Some cross-references may show up online with extraneous text added.
For example, if a cross-reference leads to a heading that has index markers in it, the index entries associated with the index markers may appear online next to the cross-reference.
You can handle this problem by moving the index markers away from the heading to a nearby location. Figure 11 shows one repositioning of the markers, with the <IndexToken> elements (and the associated markers) being placed between the <Appendix> and <Head> elements. Similarly, the markers can be placed in the body text near their original positions.
The root of the problem is that the chapter numbers in our Frame docs are in a separate text flow from everything else. Since our filters only export to SGML from a single text flow, the cross-reference anchors in the little text frames where the chapter numbers are must be removed, or the export will fail. Thus, you are left with cross-references that point to nothing.
Currently, these nonfunctional cross-references show up as question marks in PinPoint. To avoid this event, remove the cross-references themselves (not just the anchors) before you export your documents. Consider using references to the chapter title instead; these work fine.
(Peter Cash has removed the chapter number cross-reference format from the latest structured template.)
There is a problem, though, if you use cross-references that contain only a page number. Such cross-references are functional as hyperlinks; however, the textual content of the online cross-reference may not be what you want. They cannot contain a page number, since these do not make sense online, so the style sheet makes substitutions that seem sensible (to it). Be sure to sanity-check them when you have exported your documents.
Please submit comments and questions about these pages to scox@convex.com