scientific-python.org icon indicating copy to clipboard operation
scientific-python.org copied to clipboard

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

Open rossbar opened this issue 4 years ago • 2 comments

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.

rossbar avatar Sep 17 '21 20:09 rossbar

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.

stefanv avatar Sep 17 '21 21:09 stefanv

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. :+1: to this idea!

rossbar avatar Sep 17 '21 22:09 rossbar