docs: Update frontmatter template override documentation v1 APPLIED

Edd Salkield: 1
 docs: Update frontmatter template override documentation

 1 files changed, 6 insertions(+), 1 deletions(-)

[PATCH] docs: Update frontmatter template override documentation Export this patch

---
 docs/kiln.1.scd | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/kiln.1.scd b/docs/kiln.1.scd
index 42c0658..4c5dca9 100644
--- a/docs/kiln.1.scd
+++ b/docs/kiln.1.scd
@@ -135,7 +135,7 @@ The following keys are supported:
 *template*
 	Optionally specifies the name of the template to use when building this
 	page. If unspecified, defaults to "page" for regular pages and "index" for
-	index pages.
+	index pages. The template is then found according to *TEMPLATE RESOLUTION*.
 
 	Example:
 
@@ -244,6 +244,9 @@ Fallback templates can be specified in the templates/\_default/ directory. These
 templates will apply only when the required kind of template is not found in the
 template directory.
 
+The template for a specific page can be overridden by setting the *template* key
+in the page's frontmatter. See *FRONTMATTER* for more details.
+
 For example, the page file content/blog/my_first_post.gmi will be rendered with
 the template templates/blog/page.ext. If that template is not found, it falls
 back to templates/\_default/page.ext. If that template is also not found, then
@@ -253,6 +256,8 @@ Base templates also follow the same rules. For example, the index template
 templates/blog/index.ext inherits firstly from templates/blog/base.ext, and
 then falls back to templates/\_default/base.ext if present.
 
+There is no override mechanism for base templates.
+
 ## PARTIAL TEMPLATES
 
 Partial templates can be placed in the templates/\_partials directory.
-- 
2.38.0

Adnan Maolood <me@adnano.co>

1 year, 11 months ago

Thanks!

To git@git.sr.ht:~adnano/kiln
   74527d0..d76c336  master -> master