mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-21 20:46:30 -05:00
ba44e860a3
* Add meta author, description and generator tags * Add Hugo version beside the logo and in the footer * Suggest the user to run `go get -u -v` to update dependencies * Requires Go 1.3+ rather than Go 1.1+ * Improve rendering/formatting in some places * Add trailing slash to URLs where appropriate * GitHub redirects all http requests to https, update accordingly
72 lines
2.1 KiB
Markdown
72 lines
2.1 KiB
Markdown
---
|
||
aliases:
|
||
- /doc/templates/
|
||
- /layout/templates/
|
||
- /layout/overview/
|
||
date: 2013-07-01
|
||
linktitle: Overview
|
||
menu:
|
||
main:
|
||
parent: layout
|
||
next: /templates/go-templates
|
||
prev: /themes/creation
|
||
title: Hugo Templates
|
||
weight: 10
|
||
---
|
||
|
||
Hugo uses the excellent Go html/template library for its template engine.
|
||
It is an extremely lightweight engine that provides a very small amount of
|
||
logic. In our experience it is just the right amount of logic to be able
|
||
to create a good static website.
|
||
|
||
While Hugo has a number of different template roles, most complete
|
||
websites can be built using just a small number of template files.
|
||
Please don’t be afraid of the variety of different template roles. They
|
||
enable Hugo to build very complicated sites. Most sites will only
|
||
need to create a [/layouts/\_default/single.html](/templates/content/) & [/layouts/\_default/list.html](/templates/list/)
|
||
|
||
If you are new to Go's templates, the [Go Template Primer](/layout/go-templates/)
|
||
is a great place to start.
|
||
|
||
If you are familiar with Go’s templates, Hugo provides some [additional
|
||
template functions](/templates/functions/) and [variables](/templates/variables/) you will want to be familiar
|
||
with.
|
||
|
||
## Primary Template roles
|
||
|
||
There are 3 primary kinds of templates that Hugo works with.
|
||
|
||
### [Single](/templates/content/)
|
||
Render a single piece of content
|
||
|
||
### [List](/templates/list/)
|
||
Page that list multiple pieces of content
|
||
|
||
### [Homepage](/templates/homepage/)
|
||
The homepage of your site
|
||
|
||
## Supporting Template Roles (optional)
|
||
|
||
Hugo also has additional kinds of templates all of which are optional
|
||
|
||
### [Partial Templates](/templates/partials/)
|
||
Common page parts to be included in the above mentioned templates
|
||
|
||
### [Content Views](/templates/views/)
|
||
Different ways of rendering a (single) content type
|
||
|
||
### [Taxonomy Terms](/templates/terms/)
|
||
A list of the terms used for a specific taxonomy, e.g. a Tag cloud
|
||
|
||
## Other Templates (generally unnecessary)
|
||
|
||
### [RSS](/templates/rss/)
|
||
Used to render all rss documents
|
||
|
||
### [Sitemap](/templates/sitemap/)
|
||
Used to render the XML sitemap
|
||
|
||
### [404](/templates/404/)
|
||
This template will create a 404.html page used when hosting on GitHub Pages
|
||
|
||
|