Adding and editing keywords
Each topic in your project can have its own list of "index keywords", each of which will create an index entry in your output. You can add both simple keywords (master keywords) and keywords with sub-entries (child keywords). Only one level of child keywords is supported (this is a restriction imposed by the output formats, not by Help & Manual).
Index generation is automatic – an index will be generated when you compile as soon as you have added one or more keywords to any topic in your project.
It is best not to use keywords in popup topics and topics without TOC entries. Clicking on Keyword Index entries will display these topics in the main help viewer and this may confuse the user. |
You can quickly add any word or series of words in the topic editor as a keyword:
|
Viewing and the topic at the same time: Working with index keywords is easier if you can see and the topic content at the same time. To do this drag the tab to the right border of the editor. Drag back down to the tab bar to restore it to its original position. See Tips & Tricks in the Project Explorer for more details. Using the Index tool: If you have the Professional version of Help & Manual you can select the Index Tool in Project > Tools so that you can see the finished index while you are writing. |
In the tab, indenting a keyword with the TAB key automatically makes it the sub-keyword of the keyword above it.
You can enter as many child keywords as you like for each master keyword – one per line. You can only enter one level of child keywords. Child keywords cannot have their own child keywords. |
If you have the Professional version of Help & Manual you can also edit the real-time index directly with the Index tool. See Editing the index directly for details. |
You can locate topics that have no keywords with the Report Tool. Select the Report Tool in the Project tab, then choose Missing Keywords Report in the Report Type: field at the top of the dialog. See The Project Report Tool for more details on using the Report Tool. |
See also:
IDs, Context Numbers and Keywords (Reference)