Skip to main content

Smallsite Design

Online site usage help

Glossary page

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 item touches upon. An entry can include an aside or card image which will be shown at the side of the item. It can be hovered over or clicked on to make it expand so that its details can be seen more clearly.

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 100 items, 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.

Pop-ins

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 item is hovered over or tabbed to for half a second, the glossary item is inserted after the link, such as will happen if you hover over this link to Glossary article. 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 item has an image, that is also shown and is larger than when viewed on the glossary page itself, but cannot be hovered over to temporarily make it larger.

Note that pop-ins:

  1. a.Will not be activated if there is not enough room for them to display properly, such as in narrow table cells.
  2. b.Only work one level deep, so any links in a pop-in will not trigger more pop-ins.
  3. c.Also work for a link to a non-glossary article or category, where the headline and introduction is inserted, along with the image from its basic aside it it has one, but not if the link includes a fragment.
  4. d.Require Javascript to be enabled, which is the default in most browsers.

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 will sometimes be only partly visible because they are not fully within the page boundary. The arrangement within Smallsite Design mitigates both of these issues.


Manage         Help   Powered by: Smallsite Design©Patanjali Sokaris         art-a  3  0  2021-10-24-12-51-19