15.5.4.2 Mapping file names, extension, or location

In most situations, interfile cross references and hypertext links function as active, updatable links in Word with just the default settings for cross references and hypertext links, provided your RTF output file names have both of the following characteristics:

However, in the following situations you must specify additional settings to make interfile references work:

For interfile cross references and hypertext links you can specify the following:

Different file extension

Different file names

Default file location

Different file extension

To specify the file extension to use in cross references and hypertext links:

[WordOptions]
; XrefFileSuffix = suffix to use to convert [WordXrefFiles] xrefs
XrefFileSuffix=ext

This setting specifies the extension to use in Word INCLUDE fields and HYPERLINK fields when these fields reference a file other than the current file.

If you change the output file extension in a post-DITA2Go step, for example by saving the files as .doc from within Word, specify the final extension you expect the files to have at the time the cross references and hypertext links are used.

Different file names

To map input-file base names to corresponding output-file base names:

[WordXrefFiles]
; file name in xref = file name for Word interfile xref
fchap1=wchap1

List mappings in the form oldfile=newfile, without file extension.

Default file location

For some versions of Word, you might have to specify the default document location to be the path to the directory where your converted files are located. From the top menu bar in Word, go to: Tools > Options... > File Locations > Documents.

Previous Topic:  15.5.4.1 Making page numbers in interfile links updatable

Next Topic:  15.6 Converting tables to print RTF

Parent Topic:  15.5.4 Enabling interfile cross references and hypertext links

Sibling Topics:

15.5.4.1 Making page numbers in interfile links updatable

Table of ContentsIndex