ENH: Add a site-wide glossary and index of acronyms

[rossbar]

I'm thinking something along the lines of what sphinx has with the :term: and :abbr: roles, where the former links the term to a glossary entry, and the latter adds a pop-up box that shows the full name associated with an acronym when a user hovers over the link with their cursor.

I haven't looked closely, so it's possible the mainroad theme already supports some or all of this. If not, maybe this functionality could be added via shortcodes.

Not a critical feature by any means, I just thought it'd be a nice improvement given the number of new terms and acronyms that are on the site.

[stefanv]

Would this automatically be added to each page, or would you manually have to add it for each keyword? The prior would make sense to me, but may be a tad trickier to implement. Probably not too hard to do if we pre-process the text, or add a filter to Hugo in our template.

[rossbar]

or would you manually have to add it for each keyword? The prior would make sense to me, but may be a tad trickier to implement.

Good point - I was locked into the role-markup mindset, but automatically cross-linking glossary terms and abbreviations would certainly be nice. 👍 to this idea!

[stefanv]

Hugo has the following glossary support: https://gohugo.io/contribute/documentation/#glossary-term

We are also aiming to switch to myst, which already has that feature, but the switch is going to take a while.