Converting Indexes with WebWorks Publisher
Page RangesPage ranges represent a significant issue. In print indexes, the page range gives a rough indication of whether there’s a little or a lot of material. Unfortunately, WWP mindlessly converts the ending page references to hyperlinks because WWP lacks any means for identifying a page range. To deal with this problem, you can either
Index HyperlinksIn print and PDF indexes, you want the index markers to be in the exact place on the page where the index topic begins (or ends). But in online help, it’s preferable that the index hyperlink goes to the top of the help topic rather than to somewhere in the middle. If you link directly to the middle of a help topic, the user can easily become disoriented. WWP always links to where the original index marker was placed in the FrameMaker document—not necessarily to the top of the help topic. This issue can be addressed in Simple HTML, Dynamic HTML and HTML Help using another workaround.
This workaround removes the portion of the hyperlink that points to the specific target within an HTML file, leaving the hyperlink to point to the top of the HTML file. Using FrameMaker, open the compiled index file in the Output folder. Replace html#wp* with html for All using Wildcards. Save as a text file. The index hyperlinks will now point to the tops of the HTML topic files. Unfortunately, this approach won’t also work for Java Help.
“See” and “See also” references“See” and “See also” references can fail to compile in Simple HTML and Dynamic HTML. This problem occurs because WWP needs to be told explicitly how to identify “See” and “See also” references. You need to enter the following macro code:
that indicate see/see also index entries.);\
To enter this macro code, choose Designer from the Style menu. Click on the User Macros tab. Click the New button and name the new macro, UMSeeAlsoFilter. Set the macro to the above code, adjusting the “See |See also ” text as necessary. Click Apply.
Click on the Building Blocks tab. Then locate the macro named BP70ParaMacroContent_Data. Locate the following line:
Replace this line with
Click OK. Choose Save from the File menu and save your project.
You can choose to use symbols or page titles for the index hyperlinks instead of the default sequence numbers by making changes to the UMLevelIXFormat macro. In Dynamic HTML, ensure that the document.css file formats the index correctly—in both Internet Explorer and Netscape Navigator.
WWP Customer SupportWhen evaluating WWP, Customer Support was an invaluable resource in getting my index to convert into Simple HTML, Dynamic HTML, HTML Help and Java Help (all the formats that I tested). WWP online help was useful, but not always fully up-to-date.
With some nudging, WWP can do a
job converting your FrameMaker indexes to a variety of online formats.