"See" Glossary Reference
If you want a glossary term to refer to another glossary term, you can use a "see" reference. For example, if you have a glossary term for "Coolant" you could use a "see" reference to guide the reader towards a related term, such as "See refrigeration".
Tip
You can also use "See Also" Glossary Reference.
To use a "see" reference:
-
Open your glossary topic or Create a Glossary Topic.
-
Click inside the
glossary
element. -
Press Alt + Enter ⏎ (Windows) or Command ⌘ + Enter ⏎ (Mac) to display the Element Context Menu.
-
Enter
glossentry
and select it from the menu.Paligo adds a
glossentry
element and it contains aglossterm
,acronym
,glossdef
, andpara
element (thepara
is in theglossdef
). -
Click after the
glossterm
element, but before the acronym element.This selects the
glossentry
element, which you can see in the Element Structure Menu and in the Element Attributes Panel. -
Use the Element Context Menu to add the
glossee
element. -
Delete the
acronym
,glossdef
, andpara
elements for the glossary entry. You should now be left with theglossentry
andglosssee
elements.Note
You can have either a
glossee
element or aglossdef
element in aglossentry
, but not both. -
In your glossary definitions, locate the glossary term that you want to reference.
For example, if you want to have a "See Refrigeration" reference, find the glossary definition for "Refrigeration".
-
Select the
glossentry
element for the term that you want to reference. -
In the Element Attributes Panel, copy the
xml:id
attribute for theglossentry
.Note
If the
glossentry
does not have anxml:id
, select theglossentry
element in the element structure menu, and then select Generate ID. Paligo will create anxml:id
for theglossentry
element. -
Select the
glosseealso
orglossee
element that you added earlier. -
In the Element Attributes Panel, add the
Otherterm
attribute and paste in the copiedxml:id
as the value.The
Otherterm
attribute links theglosseealso
orglossee
element with the other glossary term that you are referencing. Thexml:id
is what Paligo needs to identify the other glossary term. -
Select Save.
When you publish your content (including your glossary), you will get a "See" reference to the glossary term you chose in step 8.
For this example, imagine you have a glossary term for "Profiling" and instead of a description, you want a reference to show "See Filters".
In your glossary topic, you already have a "Filters" glossary entry that has this structure:
<glossentry xml:id="N5fa17485ec783"> <glossterm xinfo:text="14442">Filters</glossterm> <glossdef> <para>Filters are also known as profiles or conditional text. You can use them to markup your topics so that when you publish, you can choose whether to include of exclude parts of your content.</para> </glossdef> </glossentry>
The first step is to create a new glossary entry, so you add a new glossentry
element and name the entry "Profiling".
You delete its acronymn
and glossdef
elements as there is no need for an acronym and you cannot have a definition and a "see" reference in the same glossary term.
You add the glossee
element.
You select the glossentry
element for the glossary term you want to reference, in this case, "Filters". Then you copy its xml:id value from the Element attributes section.
You select the glossee element for the "Profiling" glossary entry, and then add the Otherterm attribute in the Element attributes section.
You copy the xml:id of the "Filters" glossary entry into the value field for the Otherterm attribute.
You save the glossary and publish it as part of a publication. In the output, the entry for Profiling shows "See Filtering".