mirror of
https://github.com/gohugoio/hugo.git
synced 2025-08-13 08:09:02 -04:00
1.5 KiB
1.5 KiB
title | description | categories | keywords | params | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
define | Defines a template. |
|
Use with the block
statement:
{{ block "main" . }}
{{ print "default value if 'main' template is empty" }}
{{ end }}
{{ define "main" }}
<h1>{{ .Title }}</h1>
{{ .Content }}
{{ end }}
Use with the partial
function:
{{ partial "inline/foo.html" (dict "answer" 42) }}
{{ define "_partials/inline/foo.html" }}
{{ printf "The answer is %v." .answer }}
{{ end }}
Use with the template
function:
{{ template "foo" (dict "answer" 42) }}
{{ define "foo" }}
{{ printf "The answer is %v." .answer }}
{{ end }}
Warning
Only template comments are allowed outside of the
define
andend
statements. Avoid placing any other text, including HTML comments, outside of these boundaries. Doing so will cause rendering issues, potentially resulting in a blank page. See the example below.
<div>This div element broke your template.</div>
{{ define "main" }}
<h2>{{ .Title }}</h2>
{{ .Content }}
{{ end }}
<!-- An HTML comment will break your template too. -->
{{% include "/_common/functions/go-template/text-template.md" %}}