Omni Systems, Inc. Mif2Go User's Guide, Version 55

<< Prev | Next >>

> 11 Generating JavaHelp or Oracle Help > 11.3 Setting up a JavaHelp or Oracle Help project > 11.3.9 Coping with JavaHelp / Oracle Help viewer limitations

### 11.3.9 Coping with JavaHelp / Oracle Help viewer limitations

JavaHelp viewer limitations and defects are described in the JavaHelp System User’s Guide. Mif2Go provides workarounds for some; others you will have to put up with. The Oracle Help viewer has a different set of limitations. Some known limitations:

Special characters in JavaHelp

Anchor tags in JavaHelp

Image size units in JavaHelp

CSS in JavaHelp or Oracle Help

Index entries.

Special characters in JavaHelp

Some characters with ANSI decimal values in the range 128 through 159 do not display properly. For example, regular bullet characters (ANSI 149) show as small boxes in the JavaHelp viewer, unless you map them to a different value, with a setting such as the following:

[CharConvert]

149 = <b>&#183;</b>

See §13.16.2 Replacing high ASCII characters for W3C validation and §21.5 Assigning properties to text formats.

Anchor tags in JavaHelp

Each anchor tag in HTML, including the <a> tag produced from each marker in your FrameMaker document, is replaced by a space in the JavaHelp viewer. There is no feasible workaround for this defect. Mif2Go usually produces more than one <a name=...>, and <a> tags cannot be nested. Placing all <a> tags before the opening <p> eliminates the spaces, but adds a blank line above, which is even worse.

Image size units in JavaHelp

A px suffix on image width and height attribute values causes the JavaHelp viewer to show the image as a thumbnail; so for JavaHelp, by default Mif2Go omits the suffix. Make sure you do not override this default; see §23.9.5 Specifying px units for graphics sized in pixels.

CSS in JavaHelp or Oracle Help

Support for CSS is limited (in different ways) in the JavaHelp and Oracle Help viewers. You might have to resort to font tags and alignment attributes instead of using a style sheet. See §21.7.4 Including or excluding font tags.

JavaHelp CSS does not respect the list-style rule; therefore, by default, Mif2Go adds the type attribute to list wrappers ol and ul. To omit the type attribute from list wrappers:

[CSS]

; UseListTypeAttribute = Yes (default for JavaHelp, to fix CSS bug)

; or No (default for other formats, go by NoAttribLists value)

UseListTypeAttribute = No

See §21.12.2.7 Including or excluding the type list attribute.

Index entries

Index entries have limitations in both viewers; see §11.4.3 Configuring index entries for JavaHelp or Oracle Help.