Troubleshooting Indexing Issues

Following are issues that may occur when working with indexes in Flare.

Very long index terms overlap the column break rather than wrapping

Cause

In Adobe PDF output, long index entries will not wrap in multi-column index layouts.

Solution

A CSS edit involving a change on the wrapping behavior of the p.Index styles can fix this issue.

  1. From the Content Explorer, open the stylesheet that you want to modify.
  2. In the local toolbar, make sure the first button displays . If the button displays instead, then click it.

  3. In the Medium field, make sure the medium you are using is selected.
  4. In the upper-left corner of the editor,select .
  5. On the left side of the editor, expand the p group.
  6. Select the p.Index1 style.
  7. From the Show drop-down list on the upper-right side of the editor, select .

  8. (Optional) You can use the toggle button in the local toolbar to show properties below in a group view or an alphabetical view .
  9. If you are using the grouped view, expand the Block group.

  10. Using the drop-down in the right column, change the white-space: nowrap property to white-space: normal.

  11. Repeat steps 7 through 9 for the styles p.Index2 through p.Index9.

Review the generated output after making this change to ensure that there are no other undesired effects.

Index entries are not appearing in generated HTML Help output

Cause

This issue can occur when the binary index option in the skin settings is not selected. Microsoft HTML Help requires that all indexes in merged help systems have a binary index so that they can be properly merged.

Solution

Perform the following steps for each project to ensure that the index is binary.

  1. In Project Organizer, navigate to the Skins folder.
  2. Open your skin and select the HTML Help Setup tab.
  3. Select Index Options.
  4. Check the Binary check box.
  5. Generate your merged HTML Help.

For more information on this process, see Creating a Binary Index.