Omni Systems, Inc.

  

Mif2Go User's Guide, Version 55

  

Valid HTML 4.01!

 

Made with Mif2Go

8 Generating WinHelp > 8.4 Converting cross references > 8.4.2 Specifying cross-reference destination files


8.4.2 Specifying cross-reference destination files

If all your cross references are to sources within the same .hlp file, Mif2Go 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

Mif2Go checks [HelpXrefFiles] for each cross reference to another file; if the file name is not listed, Mif2Go 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 §8.13.2.5 Referencing multiple help files from contents.



8 Generating WinHelp > 8.4 Converting cross references > 8.4.2 Specifying cross-reference destination files