docs/glossaries.md
Semantic glossaries
Define a term in the lesson where its meaning is introduced:
@term["binding" id: "binding" aliases: '("bindings")]
@p {
An entry in an @term-ref["environment"]{environment} that links a symbol
to a location.
}
@end term
@p {
A @term-ref["binding"]{binding} gives a name to that location.
}@term is declarative and does not render at its declaration site. @term-ref renders its label and resolves to the publication's generated glossary entry. Definitions and references may occur in any order across publication documents.
One document supplies the publication-wide insertion point:
#lang sigil/doc
@chapter["Glossary of Terms"]
@(glossary)
@end chapterPublication assembly requires exactly one glossary marker whenever terms exist. It rejects duplicate term IDs, missing term definitions, target collisions, and multiple glossary insertion points before a renderer writes output. HTML and print backends sort entries case-insensitively and emit only populated letter groups. Definitions remain close to their teaching context while the reader sees a conventional glossary.