Glossaries
Glossary Features and Displays
You can create both individual glossary terms or a full glossary list for your book.
Glossary terms are underlined in your Pressbooks webbook, and display the term definition in a tooltip when clicked.
Users can click the term again or press the esc (escape) key on their keyboard to close the tooltip. The tooltip will also close if the user clicks another glossary term on the page.
The glossary list displays in all supported formats: webbook, PDF, digital PDF, EPUB, and MOBI. The glossary list is a consolidated, alphabetized list of all glossary terms which have been selected to show in the glossary list. The design of the glossary list is dependent on the theme and the book format. Glossary definitions can also be styled with links, bold, or italics with the Glossary Term visual editor toolbar. These styles will display in both the glossary list and the tooltip.
Create a Glossary Term
There are two methods to creating a glossary term. You can either create your terms on the Glossary Terms page before you place them in your book, or you can create the terms directly from inside the content editor of your chapter, front matter, or back matter.
From the Content Editor
To create a term:
- Highlight a word that you want to add a glossary term for, or place your cursor where you want the glossary term you have not yet entered to appear
- Click the glossary option on the Visual Editor toolbar. The Glossary Terms interface will appear
- On the Create and Insert Term tab, enter your term (NOTE: If you’ve highlighted a word, that word will automatically populate the Term field)
- Add the description for the term
- Click Insert
A shortcode will be inserted for your glossary term. If you’ve highlighted an existing term to give it a definition, the shortcode will wrap around the term. If you’ve created a new word while adding the glossary term, that word will appear wrapped in the glossary term shortcode.
The shortcode is visible in the visual editor, but is displayed as a functional tooltip in your webbook.
1. Go to Organize > Glossary Terms
2. Select the term to access the “Edit Glossary Term” page
3. In the “Status & Visibility” menu, select Move to Trash
4. Save your changes
Create a Glossary List
A Glossary List will contain all listed glossary terms you’ve created for your book. By default, all terms will be listed. You can choose whether or not a term is listed when creating a new glossary term through the Glossary Terms page, or when editing any existing glossary term. To exclude a glossary term in your glossary list, uncheck Show in Glossary List in the Status & Visibility menu on the glossary term editor page, then save your changes. To include a term in the glossary list, leave this box checked.
You can see a list of all terms and their listed or unlisted status by going to Organize > Glossary Terms from the left sidebar menu of your Pressbooks dashboard.
To generate the glossary list, follow these steps:
- Go to Organize
- Add a Back Matter chapter to your book
- In the Back Matter Type menu, select Glossary
- You should see the following message appear at the top of your screen: “To display a list of glossary terms, leave this back matter’s content blank.”
- Click Create
The glossary list will be generated and displayed in your webbook and all supported export formats.
Glossary Types
On the “Edit Glossary Term” menu, you’ll notice a menu named “Glossary Type.”
Pressbooks does not support different Glossary Types at this time, and we recommend leaving this menu set to “No glossary type” or miscellaneous. However, this functionality may be expanded in future versions of the Glossary tool.
an alphabetical list of terms or words found in or relating to a specific subject or text with explanations
often used to specify extra information about something when the user moves the mouse pointer over an element
a created subset of glossary terms for the creation of a webbook glossary
small blocks of square-bracketed code which Pressbooks recognizes and handles in special ways in the webbook and export files. Shortcodes can be used both in the Visual Editor and in the Text editor.
Feedback/Errata