hugo/docs/content/layout/templates.md

---
title: "Hugo Templates"
date: "2013-07-01"
aliases: ["/doc/templates/"]
linktitle: "Overview"
groups: ["layout"]
groups_weight: 10
---

Hugo uses the excellent golang 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

If you are new to go's templates the [go template primer](/layout/go-templates)
is a great place to start.

## Template roles

There are 6 different kinds of templates that Hugo works with.

### [Homepage](/layout/homepage/)
The homepage of your site

### [RSS](/layout/rss/)
Used to render all rss documents

### [Index](/layout/indexes)
Page that list multiple pieces of content

### [Content](/layout/content)
Render a single piece of content

### [Views](/layout/views)
Different view of a single piece of content type

### [Chrome](/layout/chrome)
Support for the above templates
Complete overhaul of the docs 2013-08-17 08:34:25 -04:00			`---`
Minor Docs Tweaks 2014-02-18 18:35:03 -05:00			`title: "Hugo Templates"`
Complete overhaul of the docs 2013-08-17 08:34:25 -04:00			`date: "2013-07-01"`
			`aliases: ["/doc/templates/"]`
Big visual overhaul of the docs. Docs now using indexes for all menu generation. 2013-10-26 02:18:14 -04:00			`linktitle: "Overview"`
			`groups: ["layout"]`
			`groups_weight: 10`
Complete overhaul of the docs 2013-08-17 08:34:25 -04:00			`---`

minor documentation cleanup. - changed it's -> its where appropriate. - added post/ parent directory above happy/ to the organization examples Signed-off-by: Noah Campbell <noahcampbell@gmail.com> 2013-09-29 22:37:29 -04:00			`Hugo uses the excellent golang html/template library for its template engine.`
Complete overhaul of the docs 2013-08-17 08:34:25 -04:00			`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`

			`If you are new to go's templates the [go template primer](/layout/go-templates)`
			`is a great place to start.`

			`## Template roles`

			`There are 6 different kinds of templates that Hugo works with.`

			`### [Homepage](/layout/homepage/)`
Add highlighting of code in documentation and clean up a bunch of the docs. 2014-01-10 21:19:19 -05:00			`The homepage of your site`
Complete overhaul of the docs 2013-08-17 08:34:25 -04:00
			`### [RSS](/layout/rss/)`
Add highlighting of code in documentation and clean up a bunch of the docs. 2014-01-10 21:19:19 -05:00			`Used to render all rss documents`
Complete overhaul of the docs 2013-08-17 08:34:25 -04:00
Refactor layout selection code The render code path would use a fallback if there was an exception. This change instead relies on explicit declaration of the layout to use and includes a check to see if the layout indeed exists before attempting to render it. 2013-10-07 00:57:45 -04:00			`### [Index](/layout/indexes)`
Add highlighting of code in documentation and clean up a bunch of the docs. 2014-01-10 21:19:19 -05:00			`Page that list multiple pieces of content`
Complete overhaul of the docs 2013-08-17 08:34:25 -04:00
			`### [Content](/layout/content)`
Add highlighting of code in documentation and clean up a bunch of the docs. 2014-01-10 21:19:19 -05:00			`Render a single piece of content`
Complete overhaul of the docs 2013-08-17 08:34:25 -04:00
			`### [Views](/layout/views)`
Add highlighting of code in documentation and clean up a bunch of the docs. 2014-01-10 21:19:19 -05:00			`Different view of a single piece of content type`
Complete overhaul of the docs 2013-08-17 08:34:25 -04:00
			`### [Chrome](/layout/chrome)`
Add highlighting of code in documentation and clean up a bunch of the docs. 2014-01-10 21:19:19 -05:00			`Support for the above templates`