aboutsummaryrefslogtreecommitdiff
path: root/lib/naming/config.mli
diff options
context:
space:
mode:
authorLukasz Kasprzak <lukas@labunix.xyz>2026-08-21 12:19:43 +0200
committerLukasz Kasprzak <lukas@labunix.xyz>2026-08-21 12:19:43 +0200
commit055deaedd6bc1acb770bd96b7da8f985ab0f4f0b (patch)
tree6b453cd7a8fcaa7f8e4e257fa46c6a720778e8f4 /lib/naming/config.mli
parentaaf3dc5ba55d46b6b318bb761305013f4c533b26 (diff)
downloadcolitur-055deaedd6bc1acb770bd96b7da8f985ab0f4f0b.tar.gz
colitur-055deaedd6bc1acb770bd96b7da8f985ab0f4f0b.zip
feat(config): flavour is settable, and an INI overlay is diagnosed
The escaping flavour was the one rendering setting with no config key, so a template whose extension says nothing needed the flag every run. Unset still means infer, which config --show reports as (infer) rather than (none). Backfills the 0.8.0 and 0.9.0 changelog entries. Both were tagged by hand rather than through 'make release', which is precisely the guard that would have refused a release with no changelog line.
Diffstat (limited to 'lib/naming/config.mli')
-rw-r--r--lib/naming/config.mli10
1 files changed, 10 insertions, 0 deletions
diff --git a/lib/naming/config.mli b/lib/naming/config.mli
index a5205c4..0dda906 100644
--- a/lib/naming/config.mli
+++ b/lib/naming/config.mli
@@ -29,6 +29,16 @@ val overlays : t -> string list
val template : t -> string option
val format : t -> string option
+(** The template ESCAPING flavour ([latex] | [typst] | [groff] | [html] |
+ [xml] | [ics] | [none]).
+
+ Only consulted when the flavour cannot be inferred from the template's
+ own extension, which is the usual case -- a template named [.tex] needs
+ no setting. It exists for the template whose extension says nothing,
+ and getting it wrong produces output that is malformed rather than
+ merely ugly, so there is deliberately no silent fallback. *)
+val flavour : t -> string option
+
(** Which citation style to render a reference in: a language CODE, looked
up the same way {!lang} is, or a path -- but a DIFFERENT axis from
{!lang}: a language file's own [\[sigla\]] section IS a style