Creates a new topic file in the Table of Contents (TOC) or the Project Files section. See Creating new topics.for more details.
Insert New Topic or Chapter dialog:
This dialog is displayed when you select one of Add Topic options. It creates a new topic, a new chapter or a TOC item linked to web page or another help file.
Creates a new topic with a TOC entry (in the TOC) or a new topic file without a TOC entry (in Project Files). The topic automatically becomes a "chapter" as soon as it has sub-topics.
When you select the function in the Project Files section you can only add topic files, no other options are available.
|
|
Position of the new topic in the TOC relative to the current topic.
|
|
|
The title of the topic in the TOC. This text is also entered as the topic header (in the box above the editor).
|
|
|
This is the "address" of the topic. It is never seen by the user and must be unique. Use only English ASCII characters and numbers. Foreign characters, spaces and special characters will cause problems in some output formats.
|
|
|
The HTML page template to be linked to the topic. This will usually be Default unless you have created additional templates.
|
|
|
Whether the topic is a normal topic or a popup topic. You can only select the Popup class in the Topic Files section of the Project Explorer. You cannot create popup topics in the Table of Contents section.
|
|
|
The folder in the Project Files section where you want to store the new topic file.
|
|
|
Normally new topics are empty. If you wish, you can specify a template file here containing standard text, tables, images and any other content. You must create template files first, otherwise nothing will be displayed here.
|
|
|
Select the icon for the topic in the TOC. In WebHelp the custom Help & Manual icons will be used. Microsoft HTML Help CHM files can only use the standard Microsoft CHM icon set, which Help & Manual matches to the most similar custom icons.
|
|
This creates a "chapter" node in the TOC only. There is no topic file and when the user clicks on it nothing is displayed.
|
|
Position of the chapter node in the TOC relative to the current topic.
|
|
|
The title of the chapter in the TOC.
|
|
Allows you to enter multiple topics at the same time, for example by pasting a list of topic titles that you want to use as captions. Each line of text entered in the Item Captions: field will create a new topic with that text as the caption in the TOC. The topic IDs are generated automatically from the caption texts.
|
|
Position of the first new topic in the TOC relative to the current topic.
|
|
|
Each line of text you enter here creates a new topic.
Press to create a new topic line.
Press or use the indent buttons on the right to create sub-topics.
|
|
|
The folder in the Project Files section where you want to store the new topic file.
|
|
|
Normally new topics are empty. If you wish, you can specify a template file here containing standard text, tables, images and any other content.
|
|
Instead of creating a new topic file this creates a TOC item that is a link to a topic in another help file. When the user clicks on the TOC entry the topic from the other help file is displayed.
This only works in HTML Help!
The target topic must be the same format as the main help file – you can't link between help files of different formats.
|
|
Position of the chapter node in the TOC relative to the current topic.
|
|
|
The title of the item in the TOC.
|
|
|
The Help & Manual project file (.hmxp, .hmxz) or the help file (.chm) containing the topic you want to link to.
|
|
|
The topic you want to link to.
|
|
Creates a topic that references a web page on the Internet:
•In eBooks selecting the topic in the TOC opens the referenced web page in an external browser window. •In HTML Help and WebHelp selecting the topic the page can be opened inside the help viewer, as part of the help, or in an external window. •In PDF and Word RTF the topic is ignored and is not included in the output.
|
|
Position of the item in the TOC relative to the current topic.
|
|
|
The title of the item in the TOC.
|
|
|
The URL of the HTML page you want to link to. If this is not a local file you must enter the fully-qualified URL, including the http:// prefix.
|
|
Inserts a placeholder for another Help & Manual project, turning the current project into a master/parent project. When you publish the master project the TOC of the child project will be added to that of the master project.
|
|
Position of the first topic of the external project in the TOC relative to the current topic.
|
|
|
The the .hmxp or .hmxz project file that you want to include
|
|
|
These settings are only relevant for HTML Help (CHM). All other formats are always merged when they are published.
For more details see Working with Modular Help Systems.
Merge content on publishing:
This merges the selected project with the project you are inserting it. The result is integrated help that is the same as help produced from a single project. You do not have to publish your child projects separately when you use this method. However, you must take steps to ensure that you do not have duplicate topic IDs and help context numbers in your projects, otherwise you will experience unexpected errors in your help.
Merge content at runtime:
Supported in HTML Help (CHM) only. This merges the child help file modules into the TOC of the master when the help is opened on the user's computer. The child help files must be published separately. If these help file modules (CHM) are present in the same folder as the master help file their TOCs will be merged with the master TOC and the effect is the same as one help file containing all modules. If the modules are not present on the user's computer they will not be included in the TOC.
|
|
See also:
Creating new topics
Content templates for topics
