Skip to main content

"See Also" Glossary Reference

For some glossary terms, you may want to include a "see also" reference as well as the definition of the glossary term. For example, if you have a glossary term for "coolant" you could have a definition and a "see also" reference to another related term, such as "see also refrigeration".

glossary-seealso-output.jpg

Tip

You can also use "See" Glossary Reference.

To use a "see also" reference:

  1. Open your glossary topic or Create a Glossary Topic.

  2. Click inside the glossary element.

  3. Press Alt + Enter ⏎ (Windows) or Command ⌘ + Enter ⏎ (Mac) to display the Element Context Menu.

    Element context menu shows a search field and a list of elements that are valid at the current position.

  4. Enter glossentry and select it from the menu.

    Paligo adds a glossentry element and it contains a glossterm, acronym, glossdef, and para element (the para is in the glossdef).

    glossterm-acronym-definition.jpg

  5. Click below the glossdef "Definition".

    The glossseealso element has to be inside the glossdef, but after the para that is inside the glossdef.

    seealso-definition-position.jpg

  6. Use the Element Context Menu to add the glosseealso element.

    profiling-def-seealso-3.jpg

  7. In your glossary definitions, locate the glossary term that you want to reference.

    For example, if you want to have a "See also Refrigeration" reference, find the glossary definition for "Refrigeration".

  8. Select the glossentry element for the term that you want to reference.

  9. In the Element Attributes Panel, copy the xml:id attribute for the glossentry.

    glossentry-id-copy.jpg

    Note

    If the glossentry does not have an xml:id, select the glossentry element in the element structure menu, and then select Generate ID. Paligo will create an xml:id for the glossentry element.

  10. Select the glosseealso or glossee element that you added earlier.

  11. In the Element Attributes Panel, add the Otherterm attribute and paste in the copied xml:id as the value.

    The Otherterm attribute links the glosseealso or glossee element with the other glossary term that you are referencing. The xml:id is what Paligo needs to identify the other glossary term.

    glossee-otherterm.jpg

  12. Select Save. Save icon.

When you publish your content (including your glossary), you will get a "See also" reference to the glossary term you chose in step 8.

Example 1. "See Also" reference in a glossary

For this example, imagine you want a glossary term for "Profiling" and you need it to provide a definition and also to guide readers to also see the term "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".

glossary entry, with the term set to Profiling, and a blank acronym element and a blank definition.

You delete its acronym element as that is not needed in this case.

You enter a definition for "Profiling".

profiling-def-seealso.jpg

You add the glossseealso element.

profiling-def-seealso-2.jpg

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 glosseealso 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.

profiling-def-seealso-3.jpg

You save the glossary and publish it as part of a publication. In the output, the entry for Profiling shows the definition for profiling and it has a "See also Filtering" reference.

glossary-seealso-output.jpg