mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
5e078383a7
49809a03 Merge commit '20a631b4964fc0ab9137cce1e41774cbc17de044' 20a631b4 Squashed 'themes/gohugoioTheme/' changes from b8202f539..dafc91ff1 8b58f565 Re-generate CLI docs 4653a724 Add Netlify deployment badge 2d6246bc Remove some deprecated site variables e6777153 Improve Algolia Search Display Styling 1570999f Add missing "." in front of gitlab-ci.yaml example b922ae7d This adds documentation to the new configDir/Environment logic from .53 (#729) 7cff379f Correctly escape multi-word taxonomy terms in example 2dfeeda4 fix typo by removing stray paren 0870bd9a Fix typo in `paginate` description 91e8be85 Fixes https://github.com/gohugoio/hugo/issues/5609 c1db65ec Make the dummy URL more obvious b4589ff0 Fix a link b73dcb9a Consistently use "posts" as section name in examples 7a56abbc Format definitions a9c6fd9b Minor clarification over the last commit 5c86bdc8 Add alternative instructions for Quick Start for non-git users dafe7ee9 Add Visual Studio Code plug-ins 110ed19e Update HUGO_VERSION 2abd031a Update page.md b332f7b9 Update page.md f5a8c9d4 Update static-files.md 6d0c155c Add note about relative protocol URLs a13751ac Theme Warning: Remove note about unquoted URLs 4c8f7d68 Incorporate feedback 6f2b9cf0 Update Creating Themes Warning 40d88d98 Fix ToC example to use binary true/false 4a11f3f1 Fix typo 2dbfc0a4 Fix a typo in taxonomies d63790ef Do not mark UndocumentedFeature issues as stale d7aff095 Regenerate docs.json 71c0826f Update transform.Unmarshal.md git-subtree-dir: docs git-subtree-split: 49809a038b2691637bab7f3f2e385dde654a88b8
92 lines
2.9 KiB
Markdown
92 lines
2.9 KiB
Markdown
---
|
|
title: Single Page Templates
|
|
linktitle:
|
|
description: The primary view of content in Hugo is the single view. Hugo will render every Markdown file provided with a corresponding single template.
|
|
date: 2017-02-01
|
|
publishdate: 2017-02-01
|
|
lastmod: 2017-04-06
|
|
categories: [templates]
|
|
keywords: [page,templates]
|
|
menu:
|
|
docs:
|
|
parent: "templates"
|
|
weight: 60
|
|
weight: 60
|
|
sections_weight: 60
|
|
draft: false
|
|
aliases: [/layout/content/]
|
|
toc: true
|
|
---
|
|
|
|
## Single Page Template Lookup Order
|
|
|
|
See [Template Lookup](/templates/lookup-order/).
|
|
|
|
## Example Single Page Templates
|
|
|
|
Content pages are of the type `page` and will therefore have all the [page variables][pagevars] and [site variables][] available to use in their templates.
|
|
|
|
### `posts/single.html`
|
|
|
|
This single page template makes use of Hugo [base templates][], the [`.Format` function][] for dates, the [`.WordCount` page variable][pagevars], and ranges through the single content's specific [taxonomies][pagetaxonomy]. [`with`][] is also used to check whether the taxonomies are set in the front matter.
|
|
|
|
{{< code file="layouts/posts/single.html" download="single.html" >}}
|
|
{{ define "main" }}
|
|
<section id="main">
|
|
<h1 id="title">{{ .Title }}</h1>
|
|
<div>
|
|
<article id="content">
|
|
{{ .Content }}
|
|
</article>
|
|
</div>
|
|
</section>
|
|
<aside id="meta">
|
|
<div>
|
|
<section>
|
|
<h4 id="date"> {{ .Date.Format "Mon Jan 2, 2006" }} </h4>
|
|
<h5 id="wordcount"> {{ .WordCount }} Words </h5>
|
|
</section>
|
|
{{ with .Params.topics }}
|
|
<ul id="topics">
|
|
{{ range . }}
|
|
<li><a href="{{ "topics" | absURL}}{{ . | urlize }}">{{ . }}</a> </li>
|
|
{{ end }}
|
|
</ul>
|
|
{{ end }}
|
|
{{ with .Params.tags }}
|
|
<ul id="tags">
|
|
{{ range . }}
|
|
<li> <a href="{{ "tags" | absURL }}{{ . | urlize }}">{{ . }}</a> </li>
|
|
{{ end }}
|
|
</ul>
|
|
{{ end }}
|
|
</div>
|
|
<div>
|
|
{{ with .PrevInSection }}
|
|
<a class="previous" href="{{.Permalink}}"> {{.Title}}</a>
|
|
{{ end }}
|
|
{{ with .NextInSection }}
|
|
<a class="next" href="{{.Permalink}}"> {{.Title}}</a>
|
|
{{ end }}
|
|
</div>
|
|
</aside>
|
|
{{ 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][archetypes].
|
|
|
|
[archetypes]: /content-management/archetypes/
|
|
[base templates]: /templates/base/
|
|
[config]: /getting-started/configuration/
|
|
[content type]: /content-management/types/
|
|
[directory structure]: /getting-started/directory-structure/
|
|
[dry]: https://en.wikipedia.org/wiki/Don%27t_repeat_yourself
|
|
[`.Format` function]: /functions/format/
|
|
[front matter]: /content-management/front-matter/
|
|
[pagetaxonomy]: /templates/taxonomy-templates/#displaying-a-single-piece-of-content-s-taxonomies
|
|
[pagevars]: /variables/page/
|
|
[partials]: /templates/partials/
|
|
[section]: /content-management/sections/
|
|
[site variables]: /variables/site/
|
|
[spf13]: http://spf13.com/
|
|
[`with`]: /functions/with/
|