diff options
Diffstat (limited to 'internal/liturgy/section.go')
| -rw-r--r-- | internal/liturgy/section.go | 39 |
1 files changed, 22 insertions, 17 deletions
diff --git a/internal/liturgy/section.go b/internal/liturgy/section.go index cacefb0..dcca7b5 100644 --- a/internal/liturgy/section.go +++ b/internal/liturgy/section.go @@ -2,28 +2,33 @@ // structured sections (1st reading, psalm, acclamation, gospel). package liturgy -// Section is one reading section of the liturgy page (e.g. "1. czytanie", -// "Psalm", "Aklamacja", "Ewangelia"): its heading, optional subtitle, the -// citation extracted from the heading, a stable identifier for which liturgical -// part it is, and its body split into paragraphs of text lines. +// Section is one reading section of the liturgy (e.g. "1. czytanie", "Psalm", +// "Aklamacja", "Ewangelia"): its heading, optional subtitle, the citation shown +// to the reader, an English-canonical lookup reference, a stable identifier for +// which liturgical part it is, and its body split into paragraphs of text lines. +// +// Citation is the display form (the reader's configured sigla dialect); Ref is +// the English-canonical reference the render resolves against a corpus. Keeping +// them apart lets the header read "Ps 27" in Polish sigla while the lookup uses +// "Psalms 27" (renumbered per Psalter). Ref is empty for sources that only +// carry a display citation; the render then falls back to Citation. type Section struct { - Heading, Subtitle, Citation, PartID string - Paragraphs [][]string + Heading, Subtitle, Citation, Ref, PartID string + Paragraphs [][]string } -// DayInfo is the day's liturgical identity, source-language (Polish for the -// modern niedziela.pl lectionary, English/Latin for the traditional -// missalemeum) -- never translated, like Section's own Heading/Citation. -// A source that carries no such data (or an unrecognised page/response -// shape) yields a zero DayInfo; callers must treat that as "omit the -// header", never as an error. +// DayInfo is the day's liturgical identity from the offline calendar engine. +// Name follows the UI language where the calendar data has a localized name +// (else English); Colour is normalized. A day that carries no celebration name +// yields a zero DayInfo; callers must treat that as "omit the header", never as +// an error. type DayInfo struct { - // Name is the celebration, e.g. "Święto św. Marii Magdaleny" (modern) or - // "St. Mary Magdalene" (traditional). + // Name is the celebration, e.g. "św. Marii Magdaleny" (pl UI, where the + // calendar data has a Polish name) or "Saint Mary Magdalene" (en). Name string - // Season is the temporal context, e.g. "Feria IV after VIII Sunday - // after Pentecost" (traditional); always "" for the modern lectionary, - // whose temporal is folded into Name on temporal days. + // Season is the temporal context; currently left empty by the offline + // loader, since the celebration name already carries the temporal identity + // on temporal days. Season string // Colour is the normalized liturgical colour: "white", "green", // "violet", "red", "rose", or "" when unknown/unmapped. |