##### 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:

- extension .rtf (see §15.1.1 Specifying output file extension)
- the same base names as the corresponding DITA input files.

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

- You specified an extension other than .rtf for output files (see §15.1.1 Specifying output file extension).
- You specified names for output files that differ from names of the corresponding input files (see §45.4 Specifying output file paths and names).
- After conversion, the file names or extension will change in a post-processing step; for example, someone will load the output files in Word and then save them for further use with an extension other than .rtf.

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 Contents • Index