Problem | Possible Cause | Fixes |
You enter a NetHelp URL into the browser Location field and press Enter, but no help topic loads or you get the error message "Unable to load requested topic." | The topic is not defined appropriately in the topic file. | Look in the topic file to make sure that the topic is anchored appropriately. Then look in the project file and make sure the topic ID was generated appropriately. |
Graphics don't appear. | Graphic is not a recognizable format or is not in the appropriate location. | View
the graphic's properties and make sure that...
...the graphic's reference uses legal HTML syntax ...the image is a .GIF or .JPG file ...the graphic is located in the referenced location |
Horizontal scrollbar appears. | Graphic or nonwrapping text does not fit into default window size. | Scale graphics or reduce font size until content fits into window with no scroll bar. |
Long sections of text are not formatted properly. | Formatting
tags have not been properly terminated.
Style sheets are not working correctly. |
In
the topic file, look at each formatting tag such as <H1>, <H2>,
<FONT>, and so on. Make sure each formatting tag has a corresponding
end-formatting tag.
Inspect style sheets (if you're using them) to make sure you're using legal HTML. |
Clicking on a link displays the error message "Unable to load requested topic." | Link
uses illegal HREF.
Topic ID is not properly defined. |
View
the HREF source and make sure it uses legal HTML and points to
the appropriate location.
Look in the project file to make sure that the topic has a legal topic ID and uses the NetHelp URL. |
Clicking on a link in a topic displays the wrong topic. | HREF points to the wrong location. | View the HREF source and make sure it uses legal HTML and points to the appropriate location. |
Clicking on a Table of Contents entry displays the error message: Failed Assertion. | There is a problem with the automatically generated TOC data file. | Look in CntData.js for inappropriately generated data. Make sure that data is generated only once, and that code for beginning and ending TOC sections is the same as that in the sample CntData.js file. |
Clicking on a Table of Contents entry displays the wrong topic. | Wrong anchor name specified in topic heading. | View the source for the topic file, and make sure the anchor name is the same one defined in the project file. You may have forgotten to re-run the Builder after changing or adding new TOC anchors. |
Clicking on an index keyword displays the error message "Failed Assertion." | There is a problem with the automatically generated Index data file. | Look
in IdxData.js for inappropriately generated data. Make sure that
data is generated only once, and that code for beginning and ending sections
is the same as that in the sample IdxData.js file.
Problems of this nature can be caused by improperly terminated tags in the topic file, or by duplicate anchor names in the same file. Resolve the tags and anchor names, and then re-generate your index. |