Correcting, adding or updating Glossary Terms

Jen Booth

Correcting, adding or updating Glossary Terms

Why do we need to correct, add or update glossary terms?

Content imported from other OER formats may have lost clickable glossary terms
Provides enhanced info to students while they are reading
Corrects broken links (from imported content)
Cleans up lengthy pages in your OER by locating the terms within the text (clickable)

Video Demonstration

Watch Glossary Terms: Pressbooks on Screencast-o-matic (8 mins)

Video source: “Glossary Terms: Pressbooks” by Jen Booth is licensed under CC BY-NC 4.0, except where otherwise noted.

Process to add Glossary Terms in Pressbooks

Steps, timestamp in video explanation, Pressbooks editor required and related code snippet/sample
Step	Description	Time stamp	Editor	Code snippet/Sample Text
1	Identify if your page has broken glossary terms	0:21	Visual Browser	in visual editor terms that look like links but don’t do anything (preview page) example of bolded items in the text that aren’t explained (end of chapter) visible list of terms at end of section/chapter
2	Identify the source of the definitions for terms (this should be relatively consistent across the whole page for content imported from one source). already at bottom of page? end of chapter? check original OER if not visible? ( already exist in Glossary?	2:04, 2:42, 3:42, 4:39	Visual Browser Glossary	Example of glossary terms at end of chapter in source text
2	Add the required terms into glossary tool if/as needed	3:44, 5:00	Glossary
3	Remove or update broken glossary term linking & replace with new short codes	3:20	Visual
4	Add new short codes to text where indicated (eg: glossary was at bottom of page, not embedded)	5:38	Visual
5	Save, preview in browser, and test glossary terms by clicking to see definition popup.	7:03	Browser
6	Optional – check with your team – Remove any extra info from bottom of page once all glossary terms are imported, if needed.	7:29	Visual

Other considerations..

Discuss the use of glossary terms with your OER team/faculty. Would they like to see:

Every instance of a glossary term linked, throughout a page, chapter or the book? (we may need to use find/replace to do this)
Only the first instance of a glossary term linked?
Only the instances of the term that were originally bold/indicated in the source text?
Turn on the Glossary list in Pressbooks (see bottom of page) – needed for the PDF export

The Finished Product – Web version

When reading a Pressbook online, users can click on Glossary Terms while reading.

Troubleshooting

Watch Glossary Terms not working on Screencast-o-Matic (1 min)

This video does not contain an audio track. The video demonstrates clickable glossary terms – one that opens when a user clicks on it, and closes when a user clicks elsewhere. The second glossary term does not stay open when clicked, it quickly flashes and closes.
Video source: “Glossary Terms not working” by Jen Booth is licensed under CC BY-NC 4.0, except where otherwise noted. OER featured is Enhanced Introductory College Chemistry.

Glossary terms that don’t stay open on-click – check HTML code/Text version and remove any tagging within – eg: <strong>

Resources

Create and Display glossary terms – Pressbooks User Guide

Attribution & References

Except where otherwise noted, “Glossary Terms: Pressbooks” by Jen Booth is licensed under CC BY-NC 4.0.

Media Attributions

License

Icon for the Creative Commons Attribution-NonCommercial 4.0 International License

GC Library OER Design Studio - Training - Work-in-Progress Copyright © by Jen Booth is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License, except where otherwise noted.