Use the method described in this section to create a cross-book link to another book using the FrameMaker Marker tool. Note that you can use this procedure only with target books for which you have SGML source files.

To create a cross-book link using markers:

The result is a piece of your document with this structure:

<type-18_marker>text<type-19_marker>

text is the text that will be marked as a link, the type-18 marker contains the name of the target book and the ID of the target element, and the type-19 marker is empty (a placeholder to indicate the end of the cross-reference text).

---

Note: Unless the text between the markers is a document title, the text between the two markers cannot contain character tags. In the case of a document title, tag the document title and both markers with the DocTitle character tag.

---

The following procedure explains how to create a link to another book using the FrameMaker cross-reference utility. Note that in order to create a cross-book link using this method, you need to have access to the FrameMaker document files that were used to create the book to which you are linking. You also need to know the target book's short title. The short title can be obtained from the target book's Makefile.

This procedure is a bit tricky because you have to specify both the target filename and the short title of the target book. To make a cross-book link, follow these steps:

---

Note: Be sure to use separate directories for different language versions of the same book. The same TITLE is used for the same book in all languages. For example, PerSysAdmin is used for the German, French and English versions of the same book. IRIS InSight checks the lang environment variable and uses the TITLE (PerSysAdmin) from the appropriate lang directory. If lang is set to DE, the German PerSysAdmin is used.

---

To find the cross references in IRIS InSight:

All the external cross references in the IRIS InSight book are highlighted. If you look at the top of the Table of Contents for the IRIS InSight book, you see a number that indicates how many times an external cross reference occurs.

To test the external cross references, scroll through the book to the locations indicated by the search results and look for bold red text. All red text indicates external cross references or launchable reference pages.

Click the external cross reference (red text). Another IRIS InSight viewer opens and displays the linked book. The linked book shows either its first chapter or introductory section or a specific heading for which the link was established. Continue checking all external cross references.

If the cross-referenced book is not installed, or if the link was incorrectly created, a dialog box, such as shown in Figure 4-1, appears.

Figure 4-1. Example of a Link That Cannot Be Followed

Notice the title of the book that cannot be followed is SiteAdmin. This is the short title of the book. A typical short title is a series of initials or an abbreviation sometimes separated by an underscore. If you see a book's part number in the IRIS InSight Warning dialog box, the link did not work because part numbers cannot be used in place of the short title. If the short title format appears correct but doesn't work, check to be sure the short title is spelled correctly.

Hypertext books incorporate cross references and cross-reference targets. A cross reference is an item you click in order to jump to another location. The target is the location where you end up after clicking on a cross reference.

While reading an online document, the reader sees most of the text in black but occasionally some text in blue. This blue text is the cross reference. In the example shown in Figure 4-2, the cross reference is referring to Figure A, and Figure A is located two paragraphs below the cross reference. When the reader clicks on the blue “Figure A” text, they are automatically jumped to the image and title for Figure A.

Figure 4-2. Diagram of Cross Reference Targets

Multiple cross references targets usually occur when a writer copies a chunk of text, including the target markers, from one document file and then pastes it into another document file.

Once a figure title (tagged as FigTitle) is created in FrameMaker, a cross reference can be made to FigTitle. Figure 4-3 shows an example of a figure title that has no cross reference linking to it.

Figure 4-3. Figure without a Cross Reference Target Marker

Figure 4-4 shows a figure title after a cross reference target marker was made. Notice the bold T symbol after the text “Figure A.” The T symbol is the marker that is automatically generated when a cross reference is created.

Figure 4-4. Figure with a Cross Reference Target Marker

Once an anchored frame and its figure title and the cross reference are created, a writer might copy the figure and figure title (and the cross reference marker) and then paste it somewhere else in the document. If you were to look at the text for the marker in Figure 4-4, it would look like this:

24340: FigTitle: Figure\ 1-3 A Figure with a Cross Reference Target Marker

You can see this for yourself in a Frame document by selecting the marker and choosing Marker ... from the Special menu. The number 24340 is the unique identifier that is used by the online build tools to create Targets. If the marker is copied, the unique identifier is copied with it. So if the figure title for Figure 4-4 were copied and used for Figure 1-4, the marker for Figure 1-4 would look like:

24340: FigTitle: Figure\ 1-4 A Different Figure 

Notice that the number at the beginning of the string is exactly the same. This poses a problem for the tools, which look primarily at this number and not the title. The tools ignore the figure number and title that show up in the marker box. The tools create a figure number and title from other information supplied, such as autonumbering.

---

Note: Multiple cross-reference targets are no longer a problem in some versions of FrameMaker.

---

This section explains how to identify and fix multiple cross reference targets.

Link targets appearing multiple times in book:
 ----------------------------------------------
 48482 :  Bouton de la barre d'outils permettant d'afficher et de cacher l'étagère.
 48482 :   Bouton de la barre d'outils permettant d'afficher les fichiers images.
 60723 :  Utiliser la barre du chemin d'accès.
 60723 :   Utilisation de la barre du chemin.
 93693 :  Commande “Chercher icône” 
 93693 :   Commande “Chercher icône”