Adding Topics / Headings
Previous Topic  Next Topic 

When you click the "Add Topic / Heading" button, , which is the first button in the Contents toolbar, the following screen will appear.


In the top left of the screen, you can choose between a Heading or a Topic. A Heading is a container for other topics or headings. Please note that a Heading can be a parent for other Topics and Headings, but in WinHelp and Website Help, a Topic cannot contain other Topics or Headings. So it is best to always group your Topics below Headings.


Horizontal Position

Checking the "On the far Left" option will place your page in the root of the contents tree - which means on the far left. You would normally use this option when adding a new main Heading that will be shown in the root of your contents.


Checking the "Indexed to the right" option will make your new page a child of the currently selected page. The concept of child and parent is a good analogy for hierarchical contents where topics are usually child pages of a heading. You would normally use this option when adding a new topic below a heading.


Checking the "On the current level" option will add your new page on the same level as the currently selected page. You would normally use this option when adding anther topic on the same level.


Vertical Position

There are four possible positions. Some are enabled based upon the Vertical Position chosen. For example, you can only use the "Top of Contents" or "Bottom of Contents" positions if you have checked the "On the far Left" option. These options will do as their name suggests, i.e. place your new page at the top or bottom of the contents tree.


The "Above.." and "Below.." options will place your page above or below the currently selected page.


Title
This is the title of your new page and can be up to 255 characters long. This title will be added to the Non-Scroll region, which is the section at the top of your page. It will also be used as a keyword for your page when your users search your help file.

Context String
Every page requires a unique identifier that will also act as its file name in HtmlHelp and Website help. We call this unique identifier the Context String and it can only contain letters and numbers. Fast-Help tries to automatically create this string for you, but you can overwrite it, if you wish. You can also change it later from the Properties tab.


Show Templates

If you click the Show Templates button at the bottom of the screen, you will see a screen like this:



A Template is a re-usable Topic that gives a consistent look to your Topics. You can save any page as a Template by right-clicking and selecting "Save as | Fast-Help Template". If the Nonscroll region has the word "[Title]" in it, then this will be replaced by the Title you typed in here. Select a template to use it. You can edit Templates using the "Tools | Templates" menu. Click [Hide Templates] to hide this part of the screen.