Glossary articles provide definitions and expansions for words and phrases used in a subsite.
Glossaries provide a centralised way to list the terms and abbreviations that a few readers may need to know in order to fully comprehend some articles, but which most may be familiar with. By making the words that need clarification into links to particular glossary entries, an article is left streamlined. Note that footnotes can also provide that ability, but only for one article. If an explanation is needed for multiple articles, glossary entries are the most suitable means.
The glossary page is a simple list with each entry having a heading and a one paragraph description. The description can be formatted and contain links which can go to articles or external sites that more fully cover the topic that the glossary entry touches upon. An entry can include an aside or card image which will be shown at the side of the entry. It can be tabbed to or clicked on to make it expand so that its details can be seen more clearly. A glossary entry's term is a link, going to the first entry if not already the first, otherwise to the page top.
There can be only one glossary per subsite, and a subsite can default to using the main subsite's glossary if having only one for the whole site is more convenient. There can be up to 99 entries, so using a single glossary for a site is feasible. However, if a subsite's theme is significantly different from the main's, separate ones might be more aesthetically pleasing.
Sometimes clicking away to a glossary entry can be disruptive to reading, so pop-ins are provided to insert the contents of the target entry after the link to it.
If a link to a glossary entry is hovered over or tabbed to for almost a second, the contents of the glossary entry is inserted after the link, such as will happen if you hover over this link to Glossary page. This is called a pop-in. The pop-in will hide when focus is moved away from it, but is available when hovered over again. If the glossary entry has an image, that is also shown and is larger than when viewed on the glossary page itself, but cannot be clicked on to temporarily make it larger.
Note that pop-ins:
- a.Will not be activated if there is not enough room for them to display properly, such as in narrow table cells.
- b.Work for a link to any article or a category, where the headline/heading and introduction/description is inserted, along with its image if any.
- c.Only work one level deep, so any links in a pop-in will not trigger more pop-ins.
- d.Clicking anywhere in the pop-in makes it go away, so a link in it can only be followed by opening the pop-in target article and clicking the same link in it instead.
Pop-ins were inspired by Wikipedia where hovering over a link produces a popup that has a summary and an image from the target article. Unfortunately that facility has a couple of downsides, being that they cover other content and might only be partly visible if not fully within the page boundary. The arrangement within Smallsite Design mitigates both of these issues.