blob: d04db7a9d8dc9202c069354198cf21aef45ac5c5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
|
---
aliases:
- /doc/templates/
- /layout/templates/
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 that 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
are 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 eg. a Tag cloud
## Other Templates (generally unncessary)
### [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
|
