Skip to main content

Section 4.7 Specialized Divisions

There are six divisions that have specialized functions, and therefore have less generic names than ones like <chapter> or <section>. They are <exercises>, <reading-questions>, <solutions>, <references>, <glossary>, and <worksheet>. They have some features in common, such as having a <title>, but each is different from the other in substantial ways.

Generally, a specialized division may be placed within any other division (Section 4.6), and it will behave like a subdivision of that division. Some may be placed in the back matter and may behave as a version relevant to the entire document. This section describes the specifics for each type of specialized division.

Subsection 4.7.1 (*) References (Lists of Works Cited)

Subsection 4.7.2 Glossary

A <glossary> division may be placed in any main matter division, and once in the <backmatter>.

After a <title>, index entries, and other metadata, a <glossary> division may begin with an optional <headnote>, which can use paragraphs to explain anything unusual about a particular glossary.

The remainder of a glossary is a sequence of items to explain. Typically these are words, phrases, initialisms, or acronyms. Each item is a “glossary item”, enclosed in a shorthand <gi> element. The element must lead with a <title>, which is the term being explained. The explanation itself follows, typically in a sequence of paragraphs, but unnumbered items, such as an <image> may also be used. It is the author's responsibility to create the list in the desired order. Automatic divisions (by initial letter) could be reasonable feature request, perhaps especially for a final, overall, back matter glossary, much like an index.

For an example, see the glossary in the back matter of this Guide.

Subsection 4.7.3 (*) Worksheets