From 768f5a9281cafba2f786955301363c83428fadee Mon Sep 17 00:00:00 2001
From: t <t@tjp.lol>
Date: Sat, 11 Jul 2026 14:06:25 -0600
Subject: template names and directory links

---
 README.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

(limited to 'README.md')

diff --git a/README.md b/README.md
index 910d6f5..f3ef773 100644
--- a/README.md
+++ b/README.md
@@ -19,11 +19,12 @@ All non-underscore `.tmpl` files are loaded into one named template set. Files
 ending in `.html.tmpl` or `.xml.tmpl` also render to the same path without the
 `.tmpl` suffix. Other `.tmpl` files only define reusable templates.
 
-Markdown pages execute one of these required definitions:
-
-- `page` for ordinary paths
-- `weblog` below `weblog/`
-- `note` below `notes/`
+Markdown pages select the first defined template matching their source path,
+walking toward the site root before using the fallback. For example,
+`notes/recipes/cocktails/old_fashioned.md` checks
+`notes/recipes/cocktails/old_fashioned`, `notes/recipes/cocktails`,
+`notes/recipes`, `notes`, then `page`. Set a different fallback with
+`-fallback template`; it defaults to `page`.
 
 Template data exposes the current page fields (`.Title`, `.Meta`, `.Sections`,
 `.OutputPath`, and so on) plus `.Pages`, a map containing each Markdown page at
-- 
cgit v1.3