#### 17.4.2 Specifying cross-reference destination files

If all your cross references are to sources within the same .hlp file, DITA2Go can process them without further information from you. If you have cross references to other files, you must specify into which .hlp files the original source files will be placed.

Single file

When all source files are going into the same .hlp file, you can use a one-step setting:

    [HelpOptions]
    XrefFileDefault=helpfilename

Multiple files

When you create multiple interlinked .hlp files, you must specify a mapping for each external file name that is specified in the helpset (but not in the current .hlp file) to the name of the .hlp file that contains the corresponding topic. You must insert this information in the configuration file for each helpset in the interlinked group of helpsets. Do not include paths or file extensions. For example:

    [HelpXrefFiles]
    ; file name in xref = file name for .hlp
    intro=help1
    chap1=help1
    chap2=help2

Default file

DITA2Go checks [HelpXrefFiles] for each cross reference to another file; if the file name is not listed, DITA2Go retains the original file name. Therefore, it is important to list the names of all source files included in each .hlp file.

Links to file names

What this does is cause the .hlp file name to be added to any links that reference the other files named. You do not need the mappings for the files going into the .hlp file you are constructing, because those do not require the extra information. You do need the mapping for files outside the .hlp file you are currently constructing. However, having the entire set present for all files is harmless.

Links from contents

If you are merging multiple help files into a set, also consider contents entries; see §17.12.2.5 Referencing multiple help files from contents.

Previous Topic: 17.4.1 Creating help context markers

Next Topic: 17.4.3 Specifying cross-reference jump destinations

Parent Topic: 17.4 Converting cross references

Sibling Topics:

17.4.1 Creating help context markers

17.4.3 Specifying cross-reference jump destinations

17.4.4 Specifying WinHelp options for cross-reference formats

17.4.5 Limiting cross-reference text