Overview
Most commonly this section/yield approach is used to create a global area in your layout that can be changed by your templates. This eliminates the need for any brittle and messy logic.
Cheatsheet:
-
No thank you:
{{ if template == "news" }} hardcode something {{ /if }} -
Yes please:
{{ section:something }}+{{ yield:something }}
Example
In the example below, everything within the section:sidebar tag will not be rendered in the template, but rather in the layout.
// The Template
<h1>{{ title }}</h1>
{{ content }}
{{ section:sidebar }}
<h2>About the Author</h2>
<div>
{{ author:name }}
</div>
{{ author:bio }}
{{ /section:sidebar }}
// The Layout
<html>
<head>
<title>{{ title }} | {{ site_name }}</title>
</head>
<body>
<article>
{{ template_content }}
</article>
<aside>
{{ yield:sidebar }}
</aside>
</body>
</html>
Related Reading
If you haven’t read up on templates and layouts, you should. It’s relevant.