From d76c336d99988f7699aeeea6f422e2dd9062b638 Mon Sep 17 00:00:00 2001 From: Edd Salkield Date: Tue, 4 Oct 2022 15:26:09 +0100 Subject: [PATCH] docs: Update frontmatter template override documentation --- 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.