DocFrame errata

DocFrame links:

Home

White paper (PDF)
(1 MB)

Training and customization

Support

Buy now

Errata and release notes for Version 2.0

Index entries in JavaHelp

JavaHelp does not support multiple index entries with the same text. For example, a multiple index entry in FrameMaker looks like:

index entry 4, 7

When DocFrame 2.0 creates the index entry in the JavaHelp, the link is to the information for the first entry. Subsequent entries are deleted.

Also, a primary index entry cannot contain two page number references when that entry is followed by secondary entries. For example, in FrameMaker, such entries look like this:

primary entry 5, 6
secondary entry 7
secondary entry 9

The preceding group of entries will create invalid code in the JavaHelp contents file; therefore, the JavaHelp viewer will not display the helpset. Instead, make the primary entries into secondary entries:

primary entry
    new secondary entry 5
    new secondary entry 6
    secondary entry 7
    secondary entry 9

Indenting nested tables in JavaHelp

Because JavaHelp requires stricter adherence to HTML nesting specifications, the DocFrame 2.0 templates for lists need to be modified so that Table elements in lists will indent.

Download the code (zip file) for changing List templates.

This code changes the List templates (bulleted, checkmarked, and numbered) so that they group ListItem and non-ListItem elements within <li> HTML tags. This code also includes the updated ListItem template.

Suppressing messages during transformation to online formats

When you run the html.xsl, htmlhelp.xsl, and javahelp.xsl transformation files on XML files that do not have cross-book links, Saxon generates the following message:

Failure reading file:/.xml: no more input

This message is informational; it does not indicate a problem with the transformation process, which will create the online output.

To suppress this message, you can add -w0 (the number zero, not the letter o) to the transformation command as follows:

c:/saxon/Saxon -w0 temp.xml html.xsl

Note: It is not necessary to add -w0 when running process_conditions.xsl.