hugo/docs/content/templates/ace.md

69 lines
2.3 KiB
Markdown
Raw Normal View History

2015-04-18 14:23:14 -04:00
---
aliases:
- /doc/templates/ace
- /layout/templates/ace
- /layout/ace/
date: 2014-04-20
linktitle: Ace templates
menu:
main:
parent: layout
next: /templates/functions
prev: /templates/go-templates
2015-07-20 08:49:18 -04:00
title: Ace Templates
2015-04-18 14:23:14 -04:00
weight: 17
---
2015-07-20 18:29:36 -04:00
In addition to [Go templates](/templates/go-templates) and [Amber](/templates/amber) templates, Hugo supports the powerful Ace templates.
2015-04-18 14:23:14 -04:00
For template documentation, follow the links from the [Ace project](https://github.com/yosssi/ace).
* Ace templates must be named with the ace-suffix, e.g. `list.ace`
* It's possible to use both Go templates and Ace templates side-by-side, and include one into the other
* Full Go template syntax support, including all the useful helper funcs
* Partials can be included both with the Ace and the Go template syntax:
* `= include partials/foo.html .`[^ace-theme]
* `{{ partial "foo" . }}`
One noticeable difference between Ace and the others is the inheritance support through [base and inner templates](https://github.com/yosssi/ace/tree/master/examples/base_inner_template).
2015-04-18 14:23:14 -04:00
In Hugo the base template will be chosen in the following order:
```
1. <current-path>/<template-name>-baseof.ace, e.g. list-baseof.ace
2. <current-path>/baseof.ace
3. _default/<template-name>-baseof.ace, e.g. list-baseof.ace.
4. _default/baseof.ace
5. <themedir>/layouts/_default/<template-name>-baseof.ace
6. <themedir>/layouts/_default/baseof.ace
2015-04-18 14:23:14 -04:00
```
In the above, `current-path` is where the corresponding inner template lives, `list.ace`, `single.ace`, `index.ace` ...
```
.:
index.ace
./blog:
single.ace
baseof.ace
./_default:
baseof.ace list.ace single.ace single-baseof.ace
```
Some examples for the layout files above:
* Home page: `./index.ace` + `./_default/baseof.ace`
* Single page in the `blog` section: `./blog/single.ace` + `./blog/baseof.ace`
* Single page in another section: `./_default/single.ace` + `./_default/single-baseof.ace`
* Taxonomy page in any section: `./_default/list.ace` + `./_default/baseof.ace`
**Note:** In most cases one `baseof.ace` in `_default` will suffice.
**Note:** An Ace template without a reference to a base section, e.g. `= content`, will be handled as a standalone template.
2015-04-18 14:23:14 -04:00
[^ace-theme]: Note that the `html` suffix is needed, even if the filename is suffixed `ace`. This does not work from inside a theme, see [issue 763](https://github.com/spf13/hugo/issues/763).