2013-08-17 08:34:25 -04:00
|
|
|
|
---
|
2014-05-29 18:42:05 -04:00
|
|
|
|
aliases:
|
|
|
|
|
|
- /layout/chrome/
|
|
|
|
|
|
date: 2013-07-01
|
2014-04-23 03:00:11 -04:00
|
|
|
|
menu:
|
|
|
|
|
|
main:
|
2014-05-29 18:42:05 -04:00
|
|
|
|
parent: layout
|
|
|
|
|
|
next: /templates/rss
|
|
|
|
|
|
prev: /templates/views
|
|
|
|
|
|
title: Partial Templates
|
|
|
|
|
|
weight: 80
|
2013-08-17 08:34:25 -04:00
|
|
|
|
---
|
|
|
|
|
|
|
2014-09-03 00:12:26 -04:00
|
|
|
|
In practice, it's very convenient to split out common template portions into a
|
2014-08-29 23:42:26 -04:00
|
|
|
|
partial template that can be included anywhere. As you create the rest of your
|
2014-09-03 00:12:26 -04:00
|
|
|
|
templates, you will include templates from the /layout/partials directory.
|
2014-06-06 16:15:19 -04:00
|
|
|
|
|
|
|
|
|
|
Partials are especially important for themes as it gives users an opportunity
|
|
|
|
|
|
to overwrite just a small part of your theme, while maintaining future compatibility.
|
|
|
|
|
|
|
2014-09-03 00:12:26 -04:00
|
|
|
|
Theme developers may want to include a few partials with empty HTML
|
2014-06-06 16:15:19 -04:00
|
|
|
|
files in the theme just so end users have an easy place to inject their
|
|
|
|
|
|
customized content.
|
2013-08-17 08:34:25 -04:00
|
|
|
|
|
2014-05-27 18:32:57 -04:00
|
|
|
|
I've found it helpful to include a header and footer template in
|
|
|
|
|
|
partials so I can include those in all the full page layouts. There is
|
|
|
|
|
|
nothing special about header.html and footer.html other than they seem
|
|
|
|
|
|
like good names to use for inclusion in your other templates.
|
2013-08-17 08:34:25 -04:00
|
|
|
|
|
|
|
|
|
|
▾ layouts/
|
2014-05-27 18:32:57 -04:00
|
|
|
|
▾ partials/
|
2013-08-17 08:34:25 -04:00
|
|
|
|
header.html
|
|
|
|
|
|
footer.html
|
|
|
|
|
|
|
2014-05-27 18:32:57 -04:00
|
|
|
|
By ensuring that we only reference [variables](/layout/variables/)
|
2014-09-03 00:12:26 -04:00
|
|
|
|
used for both nodes and pages, we can use the same partials for both.
|
2013-08-17 08:34:25 -04:00
|
|
|
|
|
2014-06-06 16:15:19 -04:00
|
|
|
|
## Partial vs Template
|
|
|
|
|
|
|
2014-09-03 00:12:26 -04:00
|
|
|
|
Version v0.12 of Hugo introduced the `partial` call inside the template system.
|
2014-06-06 16:15:19 -04:00
|
|
|
|
This is a change to the way partials were handled previously inside the
|
2014-09-03 00:12:26 -04:00
|
|
|
|
template system. In earlier versions, Hugo didn’t treat partials specially, and
|
2014-08-29 23:42:26 -04:00
|
|
|
|
you could include a partial template with the `template` call in the standard
|
|
|
|
|
|
template language.
|
2014-06-06 16:15:19 -04:00
|
|
|
|
|
2014-09-03 00:12:26 -04:00
|
|
|
|
With the addition of the theme system in v0.11, it became apparent that a theme
|
2014-06-06 16:15:19 -04:00
|
|
|
|
& override aware partial was needed.
|
|
|
|
|
|
|
2014-09-03 00:12:26 -04:00
|
|
|
|
When using Hugo v0.12 and above, please use the `partial` call (and leave out
|
|
|
|
|
|
the “partial/” path). The old approach would still work, but wouldn’t benefit from
|
2014-06-06 16:15:19 -04:00
|
|
|
|
the ability to have users override the partial theme file with local layouts.
|
|
|
|
|
|
|
2014-09-03 00:12:26 -04:00
|
|
|
|
## Example header.html
|
|
|
|
|
|
This header template is used for [spf13.com](http://spf13.com):
|
2013-08-17 08:34:25 -04:00
|
|
|
|
|
2014-05-15 09:58:55 -04:00
|
|
|
|
<!DOCTYPE html>
|
|
|
|
|
|
<html class="no-js" lang="en-US" prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb#">
|
|
|
|
|
|
<head>
|
|
|
|
|
|
<meta charset="utf-8">
|
2013-08-17 08:34:25 -04:00
|
|
|
|
|
2014-06-06 16:15:19 -04:00
|
|
|
|
{{ partial "meta.html" . }}
|
2013-08-17 08:34:25 -04:00
|
|
|
|
|
2014-05-15 09:58:55 -04:00
|
|
|
|
<base href="{{ .Site.BaseUrl }}">
|
|
|
|
|
|
<title> {{ .Title }} : spf13.com </title>
|
|
|
|
|
|
<link rel="canonical" href="{{ .Permalink }}">
|
|
|
|
|
|
{{ if .RSSlink }}<link href="{{ .RSSlink }}" rel="alternate" type="application/rss+xml" title="{{ .Title }}" />{{ end }}
|
2013-08-17 08:34:25 -04:00
|
|
|
|
|
2014-06-06 16:15:19 -04:00
|
|
|
|
{{ partial "head_includes.html" . }}
|
2014-05-15 09:58:55 -04:00
|
|
|
|
</head>
|
|
|
|
|
|
<body lang="en">
|
2013-08-17 08:34:25 -04:00
|
|
|
|
|
2014-09-03 00:12:26 -04:00
|
|
|
|
## Example footer.html
|
|
|
|
|
|
This footer template is used for [spf13.com](http://spf13.com):
|
2013-08-17 08:34:25 -04:00
|
|
|
|
|
2014-05-15 09:58:55 -04:00
|
|
|
|
<footer>
|
|
|
|
|
|
<div>
|
|
|
|
|
|
<p>
|
2014-09-03 00:12:26 -04:00
|
|
|
|
© 2013-14 Steve Francia.
|
2014-05-15 09:58:55 -04:00
|
|
|
|
<a href="http://creativecommons.org/licenses/by/3.0/" title="Creative Commons Attribution">Some rights reserved</a>;
|
|
|
|
|
|
please attribute properly and link back. Hosted by <a href="http://servergrove.com">ServerGrove</a>.
|
|
|
|
|
|
</p>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
</footer>
|
|
|
|
|
|
<script type="text/javascript">
|
|
|
|
|
|
|
|
|
|
|
|
var _gaq = _gaq || [];
|
|
|
|
|
|
_gaq.push(['_setAccount', 'UA-XYSYXYSY-X']);
|
|
|
|
|
|
_gaq.push(['_trackPageview']);
|
|
|
|
|
|
|
|
|
|
|
|
(function() {
|
|
|
|
|
|
var ga = document.createElement('script');
|
|
|
|
|
|
ga.src = ('https:' == document.location.protocol ? 'https://ssl' :
|
|
|
|
|
|
'http://www') + '.google-analytics.com/ga.js';
|
|
|
|
|
|
ga.setAttribute('async', 'true');
|
|
|
|
|
|
document.documentElement.firstChild.appendChild(ga);
|
|
|
|
|
|
})();
|
|
|
|
|
|
|
|
|
|
|
|
</script>
|
|
|
|
|
|
</body>
|
|
|
|
|
|
</html>
|
2013-08-17 08:34:25 -04:00
|
|
|
|
|
2014-05-27 18:32:57 -04:00
|
|
|
|
**For examples of referencing these templates, see [single content
|
2014-09-03 00:12:26 -04:00
|
|
|
|
templates](/templates/content), [list templates](/templates/list) and [homepage templates](/templates/homepage).**
|
