feat: naming, localisation and the rebuilt printed output

colitur computed the calendar correctly and could not say what it had
computed. A printed ordo read ef-septuagesima-sunday-2 where a reader
expects Dominica in Sexagesima, and the wall calendar showed slugs in
every cell.

  lib/naming    a language table and a config file, both pure and total,
                parsing the INI reader Overlay_ini already had
  lang/         la.ini and en.ini -- 725 names, every one transcribed
                from the 1962 Missal and citing the line it came from
  templates     the ordo rebuilt as an A5 booklet: one week per page, a
                table of contents, framed days, a colour swatch; the wall
                calendar now fills its sheet instead of a quarter of it
  tools         check_citations.py verifies all 400 citations resolve,
                with 33 self-tests of its own

Names resolve through lang -> declared fallback -> the slug, so a partial
translation is usable from its first line and the fully degraded case is
the old output rather than a blank page.

colitur day and colitur readings are BYTE-IDENTICAL to before, verified
against main rather than asserted; --lang, --raw and the lang/config
subcommands are still to come, and man/colitur-templates.5 still
documents the pre-naming view, so writing a custom template needs the
source until that lands.

1 files changed, 16 insertions, 2 deletions

diff --git a/lib/render/view.mli b/lib/render/view.mli
index fb48590..81bfc26 100644
--- a/lib/render/view.mli
+++ b/lib/render/view.mli
@@ -15,10 +15,24 @@
     different colour expression. Exactly one of the six is true on every day. *)
 
 val of_days :
+  lang:Colitur_naming.Lang.t ->
   vocab:('s, 'r) Colitur_kernel.Vocab.t ->
   rite:string ->
   year:int ->
   ('s, 'r) Colitur_kernel.Liturgical_day.t list ->
   Template.value
-(** [of_days ~vocab ~rite ~year days] where [days] is one civil year, 1 January
-    to 31 December, in order. Pure and total. *)
+(** [of_days ~lang ~vocab ~rite ~year days] where [days] is one civil year,
+    1 January to 31 December, in order. Pure and total.
+
+    [lang] resolves every display string -- a day's [name], its localised
+    [weekday]/[rank_name]/[colour_name]/[season_name], each month's [name],
+    and the top-level [term] vocabulary and [weekday_headings]. [name] is a
+    PLAIN STRING, not the old lang-keyed object: a dotted [{{name.la}}]
+    reference that misses falls back WHOLESALE to the enclosing scope (a
+    month's own [name.la]), which is how a printed booklet came to show
+    "Ianuarius" in place of a feast with no Latin name. A plain string has no
+    dotted path to fall back through, so that hazard is unrepresentable.
+    [slug] is untouched by [lang] -- it stays the stable machine key,
+    identical between any two calls that differ only in [lang]. Pass
+    {!Colitur_naming.Lang.raw} for the pre-naming behaviour, under which
+    [name] equals [slug] exactly (this is what CLI [--raw] uses). *)