Glossaries

Glossaries enable you to define and implement a set of terms to use in your documentation. A glossary may be valuable when you have to create content that uses specific terminology. A glossary provides context to readers when met with unfamiliar terms.

Glossary Term: You use the term element to link to a glossary entry topic. If you hover over the term, a tooltip with the term definition appears.

Figure 1. Glossary Term.
The following example shows the glossary term publish in the HTML5 output.
Glossary Entry Topic: If you click the term element that links to the glossary entry topic, you open the glossary entry topic.

Figure 2. Glossary Entry Topic

Create a Glossary Process

Using glossary terms in your topics requires initial configuration.

Create glossary terms. See Create Glossary Entry Topics.
Create a map and add the glossary entry topics to the map. See Create a Glossary Map.

Tip: We recommend having a global, reusable glossary map that contains all your glossary entry topics, or having glossary maps for major product lines. This makes using the glossary terms in your publications easier because they're all bundled together in a glossary map that can be easily added to publications where the glossary terms are used.
Add the glossary map to the shared map. See Add a Glossary Map to the Shared Map.

Tip:
We recommend having your glossary map in a shared map to help safeguard against unresolved links during publish.
Add the shared map to the deliverable map. See Add the Shared Map to a Deliverable Map.

Insert glossary terms into topics. See Insert a Glossary Term to a Topic.

Create Glossary Entry Topics

Use the glossary entry topic to define individual glossary terms and their definitions.

In the Content Library, navigate to a folder and click Create New.
Select Glossary Entry.
Fill in the Title field.
The title of the glossary entry topic is used as the glossary term.
Note:
The valid characters for file and folder names are:
- lowercase letters (a-z)
- uppercase letters (A-Z)
- numbers (0-9)
- underscore (_), hyphen (-), and period (.)
This applies to creating files and folders and renaming files and folders.
Click Create & Edit.
Define the glossary term and its terminology information by doing the following:
1. In the Definition field, enter a definition for the term.
2. Optional: Enter additional information about the glossary term such as an abbreviation, acronyms, synonyms, etc.
If needed, repeat the procedure for each glossary term.

Create a Glossary Map

Create a map that contains a collection of glossary terms.

Create glossary terms. See Create Glossary Entry Topics.

In the Content Library, navigate to a folder and click Create New.
Select Default Map.
Fill in the Title field.
Enter Glossary Map
Note:
The valid characters for file and folder names are:
- lowercase letters (a-z)
- uppercase letters (A-Z)
- numbers (0-9)
- underscore (_), hyphen (-), and period (.)
This applies to creating files and folders and renaming files and folders.
Click Create & Edit.
Add the glossary entry topics to the glossary map by doing the following:
1. From the Content Library, drag and drop the glossary entry topic into the map.
  
  Figure 3. Dragging and Dropping Topics
2. If needed, from the context menu, select glossref and click Insert.
  
  Figure 4. Context Menu
3. If you don't see a dialog, in the left pane, click the Key icon.
4. In the dialog, enter a key name that is unique and easy to identify with the glossary term. Click Update.
  Enter: glossary_entry_sample_key
  
  Figure 5. Dialog
5. If needed, repeat step 5 for each glossary entry topic.

Add a Glossary Map to the Shared Map

Add your glossary map to a shared warehouse map for easy reuse.

Tip:

We recommend having your glossary map in a shared map to help safeguard against unresolved links during publish.

In the Content Library, double-click on the shared map to open it in the Content Editor.
Click the Open Library button and navigate to the glossary map you want to add to the shared map.
Drag and drop the glossary map into the map tree and click Insert if needed.

Add the Shared Map to a Deliverable Map

Ensure that the shared map is added to a deliverable map.

In the Content Library, navigate to the shared map you want to add to the deliverable map.
Drag and drop the shared map into the deliverable map and click Insert if needed.
Hover over the shared map and click the gear icon.
From the processing-role drop-down menu, select resource-only.

Insert a Glossary Term to a Topic

You add a glossary term to a topic by key-referencing glossary entry topics.

Create a glossary of terms. See Create a Glossary Process.

In the Content Library, double-click a topic.
Place your cursor where you want to insert a glossary term.
Press Shift > Cmd > K (Mac) or Shift > Ctrl > K (Windows).
In the dialog, do the following:

Figure 6. Dialog
1. Optional: Start typing the glossary key name.
  Typing the glossary key name makes the keys list shorter.
2. In the keys list, double-click the relevant glossary key name.

Under maintenance

Heretto Help