Omni Systems, Inc.

  

Mif2Go User's Guide, Version 55

  

Valid HTML 4.01!

 

Made with Mif2Go

8 Generating WinHelp > 8.7 Converting generated files for WinHelp > 8.7.2 Converting indexes and lists of marker references


8.7.2 Converting indexes and lists of marker references

A list of references to markers can include links to multiple markers for each entry, so you cannot use the [HelpStyles]ParaLink property (see §8.9.3 Creating hotspots for jumps and pop-ups in WinHelp) to make the text of the entry the link. Instead you can either use the original page numbers, or substitute a symbol or graphic.

To substitute something else for page numbers, you must apply a character format to <$pagenum> on the FrameMaker Reference page for the marker list, and assign to that format the [HelpStyles]Replace property; see §8.3.5 Replacing paragraph or character content.

For example:

[HelpStyles]

IOMpgnum=Replace

You specify RTF code for whatever you want instead of a page number. For example:

[HelpReplacements]

IOMpgnum=\.{bm c document.bmp\.}

In the WinHelp version of the Mif2Go User's Guide this setting is used to replace the page numbers in indexes with small page icons taken from the built-in bitmap set in Help Workshop. For other options, in Help Workshop choose Help > Help Topics > Find, type in bull, and go to the first topic offered: “Bitmaps supplied by Help Workshop”.

For lists of references to markers, the extra ObjectIDs you must supply for lists of paragraphs are not needed; and in fact, they interfere with the marker links. If you are converting both paragraph lists and marker lists, you must prepare a special file-specific configuration file for each of the marker lists, with this setting:

[HelpOptions]

ObjectIDs=Referenced

If your document includes more than one marker list, the Help compiler might warn you about duplicate links. This is because the newlinks generated automatically by FrameMaker can be identical for multiple marker lists. To differentiate links, you must specify a prefix to use for each marker list. These settings must be placed in a special file-specific configuration file for each marker list.

For example:

[HelpOptions]

;IXnewlinkPrefix = prefix to use on newlinks, only in specific .inis

; to differentiate autogenerated newlinks in different Index files

IXnewlinkPrefix=IKH_

See §33.1 Using a different configuration for selected files for information about creating individual configuration files.



8 Generating WinHelp > 8.7 Converting generated files for WinHelp > 8.7.2 Converting indexes and lists of marker references