Inserting Index Keywords

Use this method to quickly insert an index keyword that already exists in your project.

• Advantage It is extremely fast.
• Disadvantage The index keyword that you want to insert must already exist in the project. This means you must first insert the index keyword into a topic using one of the other methods.

how to insert an index keyword using the drag-and-drop method

1. Open the content file (e.g., topic, snippet).
2. Do one of the following, depending on the part of the user interface you are using:

   • Ribbon Select the View ribbon. In the Reference section select Index Window.

   • Keyboard Shortcut Press F9.

3. In the bottom (explorer) area of the Index window pane, click the index keyword and drag it to the location in the topic or snippet where you want to insert it. As you drag the keyword into the topic or snippet, a vertical red bar acts as a guide to help you place the keyword.

   The index keyword is displayed within a marker in front of the word where you added it (as long as markers are turned on).

4. Click to save your work.

   When you build your final output, the keyword is included in the index that end users see. If an end user selects the keyword in the index, he or she is pointed to any topic(s) where that keyword was inserted.

Use this method to quickly insert the first word located after your cursor as an index keyword.

• Advantage It is extremely fast.
• Disadvantage It is not the method to use if you want to customize your phrase or add a second-level keyword. The word located immediately after the cursor is exactly what will be displayed in the index.

how to insert an index keyword using the quick term method

1. Open the content file (e.g., topic, snippet).
2. Click before or on the word that you want to insert as an index keyword.
3. Do one of the following, depending on the part of the user interface you are using:
   • Ribbon Select the Insert ribbon. In the Links section select Keyword.
   • Keyboard Shortcut Press F10 on your keyboard.

   The index keyword is displayed within a marker in front of the word where you added it (as long as markers are turned on).

4. Click to save your work.

Use this method to enter a keyword in the Index window pane.

• Advantage It lets you customize the wording of the phrase in the index. It also lets you add a second-level index keyword.
• Disadvantage It is not quite as fast as the other methods.

how to insert an index keyword using the index window pane method

1. Open the content file (e.g., topic, snippet).
2. Click at the location in the topic or snippet where want to insert an index keyword.
3. Click in an empty field in the Terms column.
4. Type the index keyword as you want it to appear in the index.

   If you want to add a second level to the keyword, type a colon after the first term, and then type the second term.

   example

   If you type Software:MadCap Analyzer, the term "Software" appears at the first level of the index, and the term "MadCap Analyzer" appears as a subentry under "Software."

   Note: As you type in the Index window pane, notice that the cursor does not lose focus in the XML Editor. It merely turns gray so that you know for certain where you are adding the index keyword. When you return to the XML Editor, the cursor returns to its previous state.

   Note: If you want to add a keyword that begins with a colon, you need to type a backwards slash \ first, followed by the colon and then the term (e.g., \:My keyword). If you want to add a subkeyword that starts with a colon, you can do the same, although you still need to include the original colon that indicates it is a subkeyword (e.g., My keyword:\:mysubkeyword).

5. Press Enter.

   The index keyword is displayed within a marker in front of the word where you added it (as long as markers are turned on).

6. Click to save your work.

Use this method to accomplish the same thing as the Index window pane method. The difference is that, with this method, you do not need to move your cursor from the topic or snippet to the Index window pane. You simply click at the spot in the text where you want to insert the keyword and start typing. The words you type are added directly into the Index window pane. This is a good method to use if you plan to do a lot of indexing all at once, without performing any other tasks in the topic or snippet.

• Advantage It is extremely fast and allows you to customize phrasing and add second-level keywords.
• Disadvantage It is not the best method to use if you want to perform indexing while also adding other content and formatting to topics or snippets.

how to insert an index keyword using the index entry mode method

1. Open the content file (e.g., topic, snippet).

2. In the local toolbar of the XML Editor click . The cursor changes, displaying a small boxed "i" next to it.

3. Click at the place in your topic where you want to add an index keyword.

4. Type the phrase that you want to add as the index keyword.

   As you start typing, the Index window pane opens (if it was not previously opened), and the phrase is added to the first empty field under the Terms column.

   If you want to add a second level to the keyword, type a colon after the first term, and then type the second term.

   example

   If you type Software:MadCap Analyzer, the term "Software" appears at the first level of the index, and the term "MadCap Analyzer" appears as a subentry under "Software."

   Note: If you want to add a keyword that begins with a colon, you need to type a backwards slash \ first, followed by the colon and then the term (e.g., \:My keyword). If you want to add a subkeyword that starts with a colon, you can do the same, although you still need to include the original colon that indicates it is a subkeyword (e.g., My keyword:\:mysubkeyword).

   Note: As you type in the Index window pane, notice that the cursor does not lose focus in the XML Editor. It merely turns gray so that you know for certain where you are adding the index keyword. When you return to the XML Editor, the cursor returns to its previous state.

5. Press Enter. The index keyword is displayed within a marker in front of the word where you added it (as long as markers are turned on).

6. If you want to add more index keywords in the topic, repeat Steps 3-5.

7. Click to save your work.