6.11.2.2 Making cross references active and updatable

For Word output, by default Mif2Go converts cross references to hypertext links, then makes them act like cross references implemented as Word bookmarks:

[WordOptions]

; Xrefs = Standard (default, working), or None (plain text)

Xrefs=Standard

; XrefHyper = Yes (default, make xrefs work as hyperlinks) or No

XrefHyper=Yes

; LockXrefs = Yes (default, faster load)

;  or No (allow updating of xrefs)

LockXrefs=Yes

The default values for these settings have the following effects:

Xrefs=Standard	Changing the source text in Word, then updating the cross-reference field, changes the text in the reference.
XrefHyper=Yes	Clicking the reference in Word (Ctrl-clicking in Word 2003) takes you to the source of the reference.
LockXrefs=Yes	Updating a cross reference to reflect changes to the source text requires unlocking the reference first.

When Xrefs=None, cross references are converted to text, and are not updatable; but if XrefHyper=Yes, they work as clickable links.

When XrefHyper=No, cross references do not work as links; but if Xrefs=Standard, they can be updated to match the source text.

When LockXrefs=No, you can update all cross references in Word without unlocking them first. However, what you lose is accurate page numbers in references. If your cross references do not include page numbers, this does not matter. If your cross references do include page numbers, there is little to gain by setting LockXrefs=No, because all you save in Word is a single click to unlock a reference for updating.

Table 6-5 summarizes the effects of these settings.

Table 6-5 Effects of cross-reference settings in Word

Configuration settings			Cross references in Word
Xrefs=	XrefHyper=	LockXrefs=	Updatable?	Active link?	Page #s OK?
Standard	Yes	Yes	Unlock first	Yes	Yes
		No	Yes	Yes	No
	No	Yes	Unlock first	No	Yes
		No	Yes	No	No
None	Yes	Yes	No	Yes	Yes
		No	No	Yes	No
	No	Yes	No	No	Yes
		No	No	No	No

Note:  The former FieldHyper setting is deprecated (and is replaced by XrefHyper), but still works; the former Xrefs=Fields is replaced by Xrefs=Standard.

 

References between files

If you are converting more than one FrameMaker file (typically a FrameMaker book), and there are cross references between files, to make those cross references work as expected you might need additional settings; see §6.11.5 Enabling interfile cross references and hypertext links.

Referencing page numbers in different files

Word does not support page references for cross-reference destinations in a different file, so Mif2Go produces a workaround in Word output. If you display hidden text in Word after converting cross references, immediately following each heading you will see a (hidden) page number; this is a Word PAGEREF field that points to the main bookmark for the heading. The PAGEREF field is bookmarked also. This way, references to the heading from other files can include dynamically updated page numbers.

---

> 6 Converting to print RTF > 6.11 Converting cross references and hypertext links > 6.11.2 Converting cross references to Word > 6.11.2.2 Making cross references active and updatable