Merge commit '35dec7c96f7ee3eb17dd444f7067f0c776fb56ae'

2025-08-21 21:35:28 +02:00 · 2023-12-04 15:24:01 +01:00
parent 9f978d387f 35dec7c96f
commit d19ed4d4e6
810 changed files with 24147 additions and 7766 deletions
--- a/docs/content/en/functions/go-template/block.md
+++ b/docs/content/en/functions/go-template/block.md
@@ -0,0 +1,55 @@
+---
+title: block
+description: Defines a template and executes it in place.
+categories: []
+keywords: []
+action:
+  aliases: []
+  related:
+    - functions/go-template/define
+    - functions/go-template/end
+  returnType:
+  signatures: [block NAME CONTEXT]
+---
+
+A block is shorthand for defining a template:
+
+```go-html-template
+{{ define "name" }} T1 {{ end }}
+```
+
+and then executing it in place:
+
+```go-html-template
+{{ template "name" pipeline }}
+```
+The typical use is to define a set of root templates that are then customized by redefining the block templates within.
+
+{{< code file=layouts/_default/baseof.html >}}
+<body>
+  <main>
+    {{ block "main" . }}
+      {{ print "default value if 'main' template is empty" }}
+    {{ end }}
+  </main>
+</body>
+{{< /code >}}
+
+{{< code file=layouts/_default/single.html >}}
+{{ define "main" }}
+  <h1>{{ .Title }}</h1>
+  {{ .Content }}
+{{ end }}
+{{< /code >}}
+
+{{< code file=layouts/_default/list.html >}}
+{{ define "main" }}
+  <h1>{{ .Title }}</h1>
+  {{ .Content }}
+  {{ range .Pages }}
+    <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
+  {{ end }}
+{{ end }}
+{{< /code >}}
+
+{{% include "functions/go-template/_common/text-template.md" %}}