Adding HTML Content Files

General Remark

JavaHelp content files must be written in HTML 3.2. JHelpDev does not provide editing capabilities for HTML files. You have to use another tool, in the simplest case a text editor, to create your content. JHelpDev then inspects a given directory and allows you to create the necessary XML files to make it a helpset.

Where to put HTML Files

When you create a new project you indicate a directory, where the project files are created. Just put your HTML files in that directory or in any subdirectories, except JavaHelpSearch, which is reserved for the search index.

Recognizing new Files

When you click on Create Map the program searches the given directory and all subdirectories for files which end with .htm or .html. It also recognizes .gif images that are not bigger than 32x32 for the TOC. It then creates a file called Map.jhm in the project directory, which maps so called targetIDs to the relative locations of the files.

It also recognizes targets in the HTML content files. A target has to be marked with
<a name="xxx"></a>. If you use such a target in the index or TOC, then the viewer goes directly to the location in the HTML content file that is marked with the target.

Renaming or Deleting Files

Whenever you rename or delete a content file you can run Create Map to update the Map.jhm file. Invalid entries in the Index/TOC trees are rendered red. You should edit them to change to a valid target.

See also: Adding Popup and Secondary Windows, Naming Conventions