KB User's Guide - Documents Tab - Glossary and Glossary Items

Glossaries are useful to understand the meaning of terms relevant to the contents of of your KB site. The KB glossary is easy to use and there are a few ways to access it and display terms your KB pages.

    Create a New Glossary Item

    Creating via "New Glossary Item" link (Recommended)

    From the KB Admin Tools, navigate to the Documents tab > New Glossary Item link.

    New Glossary Item link in the left nav bar of the Documents tab

    This will lead to the Creating a New Glossary Item screen. The image below shows part of the Creating a New Glossary Item screen. Toward the bottom of the image is the Type dropdown menu circled in red. In this screen, this field defaults to the Glossary option.

    New glossary item screen highlighting the type dropdown set to glossary

    There are only two required fields, the Term and the Body. After selecting whether you want this item to be found in the Internal/ or External KB sites, complete all other applicable fields and select Submit to save your work.

    Create a Glossary Item via "New Doc" link

    You *may* create a Glossary item from the New Doc link. Navigate to KB Admin Tools > Documents tab > Creating a New Document link; fill in the appropriate fields and select the Glossary type from the dropdown menu. Please be mindful to complete the four required fields: Title, Keywords, Summary and Body. After selecting whether you want this item to be found in the Internal/ or External KB sites, click the Submit button to save your work.

    new document screen highlighting the type dropdown set to glossary

    The image above shows the Creating a New Document screen with the Type dropdown circled in red. The Type field defaults to Document in this screen. You must select Glossary from the dropdown menu to create a Glossary item. While you can, indeed, create a Glossary item using this screen, we do not recommend it, because you will need to complete a number of  required fields, some of which will not "carry over" when you switch from the defaulted Document type to the Glossary type.

    Searching for Glossary Items

    Search in the Active Documents Queue

    Under the Documents tab, when Glossary Items are listed with other types of documents, the Title column will contain the name of the Glossary Item followed by "[Glossary]" to help distinguish these items from normal KB documents.

    When searching by "Type" and selecting "Glossary" from the drop down menu, you will see only the glossary terms, their definitions, and options to activate all on one screen. You may activate/ inactivate multiple Glossary Items all at once. Glossary review options are the same as those of regular documents.

    Search and display filters for active documents highlighting the type dropdown set to glossary

    Search the Live Site

    Regular KB search results include Glossary items which are set to the status of Active. Glossary items will appear in the search results just like other documents. The image below shows a search on a Live Site for the term "SharePoint". The search yields 6 results. Items 3 and 6 are circled in red are Glossary items found among the documents yielded from the search.

    KB live site search results highlighting two glossary items

    Clicking on the Glossary Item link in the search table will yield a window with the Glossary Item and Definition, Glossary Search Bar and Glossary Search Bar: Select Topic, along with Indexed Glossary Browsing. The image below displays a Glossary Item link clicked from a search in the Live Site. The SharePoint Glossary Item and Definition is displayed. From this screen, you may search for other Glossary Items by entering a specific term in the Glossary search box and/or selecting a Topic from the dropdown menu.

    Glossary search displaying the topic select dropdown, alphabetical indexed browsing, and glossary items and definitions

    Display a Glossary Link on your Front Page

    Display as a Side Module

    Groups that have Glossary items may want to place a Glossary link in their KB side modules. Please know that you need Admin permissions to manipulate Side Modules.

      1. Go to the Site Pref tab > Side Module link
      2. Create a new Custom Module where you would like to list your Glossary link. Click on Update to save your changes. Or if you already have a side Module in which you would like to place your Glossary link, skip this step.

    In the example below, we have created a Side Module called "For Your Reference" that will only appear in the internal site.

    Side module creation screen displaying a new custom module called 'for your reference'

      1. Click on the Side Module Links link.
      2. Select the appropriate Module Name from the dropdown. (In the example above, we would choose the "For your Reference" Module Name).
      3. Enter the link name (e.g. Glossary)
      4. Enter glossary.php in the Link URL field.
      5. Click in the KB site check box(es) in which you would like your Glossary to appear.
      6. Enter a number in the Order field to denote where, in the Side Module sequence, you would like your Glossary to appear.
      7. Click Update to save your changes.

    Access Glossary via Direct URL

      1. The Glossary search and indexed browsing can be accessed directly via glossary.php (e.g. kb.wisc.edu/yourgroupsite/glossary.php). The image below shows the Help Desk live site. The url used to access it is circled in red.

    KB live site displaying the glossary page and highlighting the url with the /glossary.php extension

    Tool-tip Popup for Glossary via the Includedoc

    In any document, you can use the IncludeDoc tag on a glossary item. The term will appear in the document (which we will refer to here as the container document, the document which contains the embedded Glossary term) with a dashed underline. Hovering over it will reveal the definition in a tooltip. The cursor will appear as question mark icon upon mouse-over.

    mouse hovering over a glossary item displaying a tooltip popup with the glossary definition

    How to place a Glossary Tool Tip in your Document

      1. Have the document ID of the Glossary Item you wish to embed in your document..have it handy when editing your document. (Example: The Star Anise document ID number is 44294).

      1. When in the text editor of your KB document, enter the document ID number of the glossary item in the body of the document. (Example text: "You may use whole 44294, or ground.")

      1. Highlight the document ID number.

      1. Click on the IncludeDoc button: include doc button from the HTML editor in the HTML editor or click on the icon circled in red  WYSIWYG editor buttons highlighting the include doc button, a gear and paper icon in the WYSIWYG design editor.

    1. You may click on the Preview button to check your work. The image below shows what is seen in the Preview when you hover your cursor over the Glossary Item term:

      preview of a glossary item showing the cursor hovering over the word and a tooltip displaying the definition

    2. Click on the Save Change or Submit button to save your work.

    Best Practices

    When embedding a glossary term in a document (e.g. the container document, as it contains the IncludeDoc glossary term), please include the glossary term, itself, in the Keywords field of the container document.

    The reason for this is: when a search is performed on the KB, it looks for text in the keywords field/ or body of the document. Only the document ID of the glossary term will be found in the body of the container document, not the actual glossary term itself.

    Keywords:index dictionary terms acronyms side module includedoc tool tip question mark embed   Doc ID:15709
    Owner:Leah S.Group:KB User's Guide
    Created:2010-11-22 18:00 CSTUpdated:2022-06-08 13:27 CST
    Sites:KB Demo, KB User's Guide
    Feedback:  1   1