Pressbooks Glossary


#1

I was playing with the new Glossary features in the Pressbooks update. I was looking for the documentation for it, but I couldn’t find it yet. A couple questions come up as I first started playing with it.

Is there a shortcode that would allow a glossary to be included in chapter?

I think I understand the way that glossary nesting works, that one glossary can be included in another by child/parent relationship…

So if I was designing a book, could I make a separate glossary for every chapter, that are all children of a master glossary? That way my vocab terms are included at the beginning or end of my chapter, but also included in the backmatter? Is that how this works?

And is there a way at the book or theme level to make vocab words look different than external links?


#2

Hi @beckej, we just published documentation on the glossary feature: https://guide.pressbooks.com/chapter/glossaries/

Right now you can’t insert glossary lists in each chapter. The way the initial implementation works, there is no way to display a list of a subset of terms, so the shortcode that displays glossary lists would output the list of all terms in the book everywhere it was used. We intend to follow up with enhancements to this feature in the first release of 2019. Similarly, we’re looking into some improvements to the tooltips/vocab words, including distinctive formatting, support for basic rich text (bold/italics/links), and display on hover and focus instead of just click. See also: https://github.com/pressbooks/ideas/issues/152


#3

Quotations at the beginning of a glossary description does not seem to work.


#4

I’m not sure what this means. Can you give me clear steps to reproduce?


#5

Example Works:

An open source book publishing tool built on a WordPress multisite platform. PressBooks outputs books in multiple formats, including PDF EPUB/MOBI, web, and a variety of XML flavours, using a theming/templating system, driven by CSS (Chartrand, 2013/2013).

Example Fails:

“An open source book publishing tool built on a WordPress multisite platform. PressBooks outputs books in multiple formats, including PDF EPUB/MOBI, web, and a variety of XML flavours, using a theming/templating system, driven by CSS” (Chartrand, 2013/2013).


#6

Works for me!


#7

When using " " I get a

       javascript:void(0);

Pressbooks Configuration

Version: 5.6.0
Book Theme: Open Textbooks
Book Theme Version: 2.1.5
Root Theme: Aldine
Root Theme Version: 1.5.0


#8

Aha, the issue is with straight quotes… thanks. Will investigate further.


#9

Fixed in Pressbooks 5.6.2.