Added pragmas, template inheritance docs

2021-03-25 09:43:01 +00:00
parent b331d4c440
commit 87068659b3
3 changed files with 45 additions and 1 deletions
--- a/documentation/Template
+++ b/documentation/Template
@@ -0,0 +1,33 @@
+#  Template Inheritance
+
+Template inheritance is not part of the Mustache spec yet but it is a commonly implemented feature. Template inheritance allows you to override elements of an included partial. It allows you to create a base page template and override elements of it with your page content. A partial that includes overriding elements is indicated with a `{{<partial}}`. Note this is different from the normal partial reference which uses `>`. This is a section tag so needs a ending tag as well. Inside the section the tagged sections to override are added using the syntax `{{$tag}}contents{{/tag}}`. If your template and partial were as follows
+```
+{{! mypage.mustache }}
+{{<base}}
+{{$head}}<title>My page title</title>{{/head}}
+{{$body}}Hello world{{/body}}
+{{/base}}
+```
+```
+{{! base.mustache }}
+<html>
+<head>
+{{$head}}{{/head}}
+</head>
+<body>
+{{$body}}Default text{{/body}}
+</body>
+</html>
+```
+You would get the following output when rendering `mypage.mustache`.
+```
+<html>
+<head>
+<title>My page title</title>
+</head>
+<body>
+Hello world
+</body>
+```
+Note the `{{$head}}` section in `base.mustache` is replaced with the `{{$head}}` section included inside the `{{<base}}` partial reference from `mypage.mustache`. The same occurs with the `{{$body}}` section. In that case though a default value is supplied for the situation where a `{{$body}}` section is not supplied. 
+