AtlatestRenderedmarkdown
Readme

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 chapter

Publication 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.