User Guide Cancel

Create and manage an index

  1. RoboHelp User Guide
  2. Introduction
    1. Get to know RoboHelp workspace
    2. What's new in RoboHelp 2022 release
      1. What's new in Update 5
      2. What's new in Update 4
      3. What's new in Update 3
      4. What's new in Update 2
      5. What's new in Update 1
    3. Fixed Issues in RoboHelp
    4. RoboHelp System Requirements
    5. Download RoboHelp on Windows and macOS
    6. Download and install Adobe app
    7. RoboHelp FAQs
    8. What's new in RoboHelp 2020 release
      1. What's new in Update 8
      2. What's new in Update 7
      3. What's new in Update 6
      4. What's new in Update 5
      5. What's new in Update 4
      6. What's new in Update 3
      7. What's new in Update 2
      8. What's new in Update 1
  3. Projects
    1. Plan your RoboHelp project
    2. Create a project
    3. Manage projects
    4. Work with topics and folders
    5. Generate reports
    6. Work with context-sensitive help
    7. Manage References
    8. Set preferences in RoboHelp
  4. Collaborate with authors
    1. Collaborate using Git
    2. Collaborate using SharePoint Online
    3. Collaborate using Azure DevOps (Team Foundation Server)
  5. PDF Layout
    1. PDF templates
    2. Design a page layout
    3. Publish PDF output
    4. Work with the common content styles
    5. Components of a PDF template
    6. Support for language variables
    7. Customize PDFs
  6. Editing and formatting
    1. Format your content
    2. Create and manage cross-references
    3. Create and manage links
    4. Single-source with snippets
    5. Work with images and multimedia
    6. Create and use variables for easy updates
    7. Work with Variable Sets
    8. Use Find and Replace
    9. Auto save your content
    10. Side-by-side editing in Split View
    11. Use the Spell Check feature
    12. Create and Edit Bookmarks
    13. Insert and update fields
    14. Switch between multiple views
    15. Autonumbering in CSS
  7. Import and linking
    1. Import Markdown files into a project
    2. Import Word documents into a project
    3. Import FrameMaker documents into a project
  8. TOCs, indexes, glossaries, and citations
    1. Create and manage a Table of Contents
    2. Create and manage an index
    3. Create and manage a glossary
    4. Create and manage citations
    5. Create and manage browse sequences
    6. Work with See Also and Related Topics
  9. Conditional content
    1. What is conditional content
    2. Create and apply condition tags
    3. Configure output presets for conditional content
    4. Optimize and manage conditional content
  10. Microcontent
    1. Microcontent
  11. Review and Collaboration
    1. Review and Collaboration
  12. Translation
    1. Translating content to multiple languages
    2. Configure a translation framework for a service provider
  13. Generating output
    1. Generate output
    2. Generate Frameless output
    3. Generate Knowledge Base output
    4. Generate PDF output
    5. Generate Responsive HTML5 output
    6. Generate Word Document output
    7. Generate Content Only output
    8. Generate eBook output
    9. Generate Microsoft HTML Help output
    10. Generate Mobile App output
  14. Publish output
    1. Publish to a RoboHelp Server
    2. Publish to an FTP server, a Secure FTP server, or a File System
    3. Publish to SharePoint Online
    4. Publish to Zendesk Help Center
    5. Publish to Salesforce Knowledge Base
    6. Publish to ServiceNow Knowledge Base
    7. Publish to Zoho Knowledge Base
    8. Publish to Adobe Experience Manager
    9. Publish to Atlassian Confluence Knowledge Base
  15. Appendix
    1. Adobe RoboHelp Scripting Reference
    2. RoboHelp keyboard shortcuts

Learn how to work with an index in RoboHelp.

What is an index

An index is an alphabetically sorted list of keywords and bookmarks used in your project. Keywords can include multiple levels of subkeywords. You can associate keywords and subkeywords with topics that contain them and add cross-references to other keywords. You can also use project variables while adding keywords or subkeywords. You can add condition tags to index keywords to choose which keywords to publish in a specific output. You can also publish keywords so that your end users can use the keywords to search for and access specific topics in the output.

You can work with keywords and subkeywords through the Index panel of RoboHelp.

Add keywords to create an index

You can add index keywords/subkeywords in two ways–from Topic properties and from the Index panel. 

From Topic properties

  1. In an open topic, navigate to index in topic properties by clicking Properties panel > Topic tab > Index drop-down section.

  2. In the Index Keywords field, specify a keyword and press Enter. To specify a subkeyword, use a colon : between keywords. You can use variables while specifying keywords and subkeywords. 

    As you type in the index keyword field, you get all the keywords and subkeywords already used in the project as the dropdown. The list gets further filtered as you type. You can now select the relevant keyword from the list.

From Index panel

  1. In an open project, select Index in the Author toolbar.

  2. In the Index panel, do one of the following:

    • Click  at the upper-right corner of the panel. 
    • Against an existing keyword, choose Options () > New Keyword
    • Right-click a keyword and select New Keyword.

    An empty field appears in the Index panel.

  3. In the empty field, specify a keyword and press Enter. The keyword is added to the Index panel and placed according to alphabetical order of keywords.

    You can add multiple keywords to create an index.

    The keywords are also visible in Properties panel > Topic tab > Index drop-down section.

Add subkeywords to keywords

To add a subkeyword to a keyword, follow these steps:

  1. In an open project, select Index in the Author toolbar.

  2. In the Index panel, against a keyword, choose Options () > New Subkeyword. Alternatively, right-click a keyword and select New Subkeyword.

    An empty field appears below the keyword.

  3. In the empty field, specify a subkeyword and press Enter. The subkeyword is added below the keyword.

    You can add multiple subkeywords to a keyword.

Link keywords and subkeywords to specific topics

Once you've added keywords and subkeywords to an index, you can link them to specific topics. To do this, follow these steps:

  1. In an open project, select Index in the Author toolbar. 

  2. In the Index panel, against a keyword/subkeyword, choose Options  > Add Topic. Alternatively, right-click a keyword/subkeyword and select Add Topic.

  3. In the Add Topic dialog box, use the Search bar, Recently Used panel, or Contents panel to select a topic in your project.

  4. Click Link. The topic is added below the keyword/subkeyword.

    Note:

    To remove or edit a linked topic, click  next to the topic or right-click the topic and select Remove or Edit, respectively.

    If the linked topic is open, the Properties panel > Topic tab > Index drop-down section displays the associated keywords and subkeywords. For more information, see Index.

Link keywords and subkeywords to other keywords

Once you've added keywords and subkeywords to an index, you can link them to other keywords in the index. To do this, follow these steps:

  1. In an open project, select Index in the Author toolbar. 

  2. In the Index panel, against a keyword/subkeyword, choose Options  > Add Cross Reference. Alternatively, right-click a keyword/subkeyword and select Add Cross Reference.

  3. In the Insert Cross Reference dialog box, you can filter keywords by typing the first few alphabets. Press the upward and downward arrow keys to navigate through the list of keywords. Press Enter to insert a keyword. 

    The keyword is added as a cross-reference below the main keyword.

    Note:

    To remove or edit a cross-reference, click  next to the cross-reference or right-click the cross-reference and select Remove Cross Reference or Edit Cross Reference, respectively.

Apply condition tags to a keyword or subkeyword

You can use a single index file in all outputs and apply condition tags to specific keywords/subkeywords to publish those in specific outputs. You can apply multiple condition tags to keywords and subkeywords in an index. To do this, follow these steps:

  1. In an open project, select Index in the Author toolbar. 

  2. In the Index panel, against a keyword/subkeyword, choose Options  > Apply Condition Tags. Alternatively, right-click a keyword/subkeyword and select Apply Condition Tags.

  3. In the Apply Condition Tags dialog box, click a condition tag in the left panel.

    The tag appears in the right panel. To remove the tag, click  against it.

  4. Click Apply.

    In the Index panel, against the keyword/subkeyword, a colored circle indicates that conditional tags are applied.

Rename a keyword or a subkeyword

To rename a keyword/subkeyword in the Index panel, follow these steps:

  1. In an open project, select Index in the Author toolbar. 

  2. In the Index panel, against the keyword/subkeyword, choose  > Rename. Alternatively, right-click the keyword/subkeyword and select Rename.

  3. Edit the keyword/subkeyword inside the editable box and press Enter.

    The edited keyword/subkeyword is reflected in the Index panel and the Index drop-down section in a topic's properties. All the topics in which this keyword/subkeyword is used are updated as well. 

Delete a keyword or a subkeyword

To delete a keyword/subkeyword in the Index panel, follow these steps:

  1. In an open project, select Index in the Author toolbar. 

  2. In the Index panel, against the keyword/subkeyword, choose  > Delete. Alternatively, right-click the keyword/subkeyword and select Delete.

  3. Click Yes in the Confirm dialog box to confirm deletion.

    The deleted keyword/subkeyword is removed from the Index panel and the Index drop-down section in a topic's properties. It is also removed from all the topics in which it was used.

Link bookmarks to an index

To link an index term to a bookmark from the Properties dialog, follow these steps:

  1. In an open project, select Index in the Author toolbar. 

  2. In the Index panel, against a keyword/subkeyword, choose Options  > Add Topic. Alternatively, right-click a keyword/subkeyword and select Add Topic.

  3. In the Add Topic dialog box, use the Search bar, Contents panel, or Recently Used panel to select a topic in your project. The selected topic drop-down section displays the associated bookmarks. 

  4. Click Link. The selected bookmark is added below the keyword/subkeyword.

Rename bookmarks linked to an index

To rename a bookmark in the Index panel, follow these steps:

  1. In an open project, select Index in the Author toolbar. 

  2. In the Index panel, against the bookmark, choose  > Properties. 

  3. Edit the title inside the editable box and press Save.

  4. Alternatively, you can also drag-and-drop an index term and edit the title under the General settings in the Properties panel.

The edited title is reflected in the Index panel and the Index drop-down section in a topic's properties. 

Note:

The updated title goes to all the outputs except the CHM output.

Publish an index

By default, an index is published in the output. You can change this setting in RoboHelp while configuring an output preset that you want to use to generate output. To do so, follow these steps:

  1. Click the Output tab at the left side of the standard toolbar.

  2. In the Output toolbar, click Output Presets.

  3. From the Output Presets panel, double-click the output preset that you want to edit.

  4. Click the Content tab.

    The Include Index field is selected by default, so index is published by default. You can select or deselect this field depending on whether you want to publish an index.

    Note:

    For Frameless and Responsive HTML5 output types, you can also control whether to show or hide an index from the respective skins. To do so, in the Layout tab of the Skin Components panel, you can enable or disable the Show Index option.

Use an index in the output

An index, if published, appears as a panel in the output. The index panel in the output displays all keywords and serves as an additional navigational channel for your end users. In the index panel, one can filter through keywords and click a keyword to quickly navigate to the associated topic. Your end users can use index keywords to quickly search for and access topics of their choice. Index keywords have the same ranking as search keywords.

 Adobe

Get help faster and easier

New user?

Adobe MAX 2024

Adobe MAX
The Creativity Conference

Oct 14–16 Miami Beach and online

Adobe MAX

The Creativity Conference

Oct 14–16 Miami Beach and online

Adobe MAX 2024

Adobe MAX
The Creativity Conference

Oct 14–16 Miami Beach and online

Adobe MAX

The Creativity Conference

Oct 14–16 Miami Beach and online