hugo/docs/content/templates/single-page-templates.md
2017-07-21 11:00:08 +02:00

3.8 KiB

title linktitle description date publishdate lastmod categories menu weight sections_weight draft aliases toc
Single Page Templates The primary view of content in Hugo is the single view. Hugo will render every Markdown file provided with a corresponding single template. 2017-02-01 2017-02-01 2017-04-06
templates
docs
parent weight
templates 60
60 60 false
/layout/content/
true

Single Page Template Lookup Order

You can specify a content's type and layout in a single content file's front matter. However, you cannot specify section because this is determined based on file location (see content section).

Hugo assumes your content section and content type are the same unless you tell Hugo otherwise by providing a type directly in the front matter of a content file. This is why #1 and #3 come before #2 and #4, respectively, in the following lookup order. Values in angle brackets (<>) are variable.

  1. /layouts/<TYPE>/<LAYOUT>.html
  2. /layouts/<SECTION>>/<LAYOUT>.html
  3. /layouts/<TYPE>/single.html
  4. /layouts/<SECTION>/single.html
  5. /layouts/_default/single.html
  6. /themes/<THEME>/layouts/<TYPE>/<LAYOUT>.html
  7. /themes/<THEME>/layouts/<SECTION>/<LAYOUT>.html
  8. /themes/<THEME>/layouts/<TYPE>/single.html
  9. /themes/<THEME>/layouts/<SECTION>/single.html
  10. /themes/<THEME>/layouts/_default/single.html

Example Single Page Templates

Content pages are of the type page and will therefore have all the page variables and site variables available to use in their templates.

post/single.html

This single page template makes use of Hugo base templates, the .Format function for dates, the .WordCount page variable, and ranges through the single content's specific taxonomies. with is also used to check whether the taxonomies are set in the front matter.

{{< code file="layouts/post/single.html" download="single.html" >}} {{ define "main" }}

{{ .Title }}

{{ .Content }}
{{ end }} {{< /code >}}

To easily generate new instances of a content type (e.g., new .md files in a section like project/) with preconfigured front matter, use content archetypes.