Create, save, and open topics

Create a topic

  1. In the Project Manager pod, open the XHTML Files (Topics) folder.

  2. To store the topic in a specific custom folder, select the folder.

  3. Do either of the following:

    • Click the New Topic icon .

    • To create the topic with a different HTML editor, right-click and select New > Topic With. Then select the editor.
      Note: You can also right-click in the Topic List and select New Topic With > [editor].
  4. Specify a topic title.

  5. Select a UDV from the Variables list to insert in the topic title and click Insert. Click OK. For example, instead of embedding a product name in the title, use a UDV for the product name. UDVs help you manage changes and ensure consistency.

  6. If required, modify the filename that RoboHelp creates from the topic title.

    For best results, use underscores instead of spaces in filenames, and follow the HTML file naming protocol. Avoid using these characters in filenames: \ / : * ? < > | # ", $, &, [ ]

    (Apply these same conventions to folder names.)

  7. (Optional) Select a master page.

  8. Specify a language for the new topic.

    Note: If you do not specify a language for the topic you are creating, RoboHelp uses the language setting for the project. RoboHelp uses the language setting for a topic for the spelling checker, the thesaurus, smart indexing, and full-text search indexing. The output UI is controlled by the project language setting. For more information about language support, see Authoring content in multiple languages
  9. Add keywords to help users find the contents of this topic. To separate the keywords, you can use commonly used characters, such as comma, semicolon, and space. Space works in most languages.

    Note: The keywords you specify are added to the index. For more information, see Topic keywords.
  10. Select Exclude This Topic From Search only if you do not want to display this topic in the search results.

    Note: Exclude From Search is not available for Microsoft HTML Help (CHM) search.
To open a topic in a third-party editor, right-click the topic in the Project Manager or the Topic List and select Edit With. The topic opens in the editor you specified (the Editor box still displays the editor set for the project).

Watch this video to find out how to add a topic TOC to a topic

Adding a topic TOC to a topic (6:20)

David Rivers
Do you want to help users navigate through longer topics? Learn how to add a topic TOC to a topic by watching this video.

Have a tutorial you would like to share?

Save topics

Save a topic

  • Press Ctrl+S.

  • In the toolbar, click Save.

Enable or disable Save

If you deselect Save Without Prompt, you are prompted to save topics.

  1. Select Tools > Options.

  2. Click the General tab.

  3. Under Options, select or deselect Save Without Prompt.

  4. Click OK.

Rename topic files

Note: Avoid using Windows Explorer or your version control application to rename files. The Project Manager cannot update file references.
  1. Do either of the following:

    • In the Project Manager pod, expand the appropriate folder. Select View > By File Name. Right-click the file, and select Rename.

    • In the Topic List pod, right-click the file. Select Properties.

  2. Type the new name.

    For best results, use underscores instead of spaces, and follow the HTML filenaming protocol. Avoid using these characters in filenames: \ / : * ? < > | # ", $, &, [ ]

    If the filename has multiple words, use underscores instead of spaces.

Open topics

You can open topics in Design Editor or another editor while still using RoboHelp to add online Help features.

 In the Project Manager or Topic List pod, do one of the following:
  • To open the topic in Design Editor (or a third-party editor you’ve set as the default editor), double-click the topic.

  • To open the topic in an editor, right-click the topic and select Edit With > [editor].

    If you are prompted whether to continue with possible HTML code changes, click Yes. However, to avoid code changes from one editor to the next, edit topics in the same editor and click No.

Support for multiple document interfaces

You can open multiple topics in Design Editor. You can edit topics simultaneously, compare topics, and copy content from one topic to another.

Each open topic has a corresponding tab in the Design Editor pod. Click a tab to make its topic window active. Click the scroll arrows to scroll through tabs and reveal hidden tabs. Drag the tabs to position topic windows horizontally or vertically within Design Editor.