mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
77 lines
2.8 KiB
Markdown
77 lines
2.8 KiB
Markdown
|
---
|
||
|
|
title: Alternative Templating Languages
|
||
|
|
linktitle: Alternative Templating
|
||
|
|
description: In addition to Go templates, Hugo supports the powerful Ace templating from @yosssi and Amber templating from @eknkc.
|
||
|
|
godocref:
|
||
|
|
date: 2017-02-01
|
||
|
|
publishdate: 2017-02-01
|
||
|
|
lastmod: 2017-02-20
|
||
|
|
categories: [templates]
|
||
|
|
keywords: [amber,ace,templating languages]
|
||
|
|
menu:
|
||
|
|
docs:
|
||
|
|
parent: "templates"
|
||
|
|
weight: 170
|
||
|
|
weight: 170
|
||
|
|
sections_weight: 170
|
||
|
|
draft: false
|
||
|
|
aliases: [/templates/ace/,/templates/amber/]
|
||
|
|
toc: true
|
||
|
|
---
|
||
|
|
|
||
|
|
## Ace Templates
|
||
|
|
|
||
|
|
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 even include one into the other
|
||
|
|
* Full Go template syntax support, including all the useful helper [template functions][]
|
||
|
|
* Partials can be included both with the Ace and the Go template syntax. For example, the following two will have the same output in Ace:
|
||
|
|
* `= include partials/foo.html .`
|
||
|
|
* `{{ partial "foo" . }}`
|
||
|
|
|
||
|
|
One noticeable difference between Ace and the other templating engines in Hugo is [Ace's inheritance support through base and inner templates][aceinheritance].
|
||
|
|
|
||
|
|
In Hugo, the Ace base template will be chosen with the same rule set as for [Go base templates][].
|
||
|
|
|
||
|
|
```
|
||
|
|
.:
|
||
|
|
index.ace
|
||
|
|
|
||
|
|
./blog:
|
||
|
|
single.ace
|
||
|
|
baseof.ace
|
||
|
|
|
||
|
|
./_default:
|
||
|
|
baseof.ace list.ace single.ace single-baseof.ace
|
||
|
|
```
|
||
|
|
|
||
|
|
{{% note %}}
|
||
|
|
Note that the `html` suffix is needed even if the filename is suffixed `ace`. This does not work from inside a theme ([issue #763](https://github.com/gohugoio/hugo/issues/763)).
|
||
|
|
{{% /note %}}
|
||
|
|
|
||
|
|
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. An Ace template without a reference to a base section (e.g., `= content`) will be handled as a standalone template.
|
||
|
|
{{% /note %}}
|
||
|
|
|
||
|
|
## Amber Templates
|
||
|
|
|
||
|
|
For Amber template documentation, follow the links from the [Amber project][].
|
||
|
|
|
||
|
|
* Amber templates must be named with the Amber suffix; e.g., `list.amber`
|
||
|
|
* Partials in Amber or HTML can be included with the Amber template syntax:
|
||
|
|
* `import ../partials/test.html `
|
||
|
|
* `import ../partials/test_a.amber `
|
||
|
|
|
||
|
|
[aceinheritance]: https://github.com/yosssi/ace/tree/master/examples/base_inner_template
|
||
|
|
[Amber Project]: https://github.com/eknkc/amber
|
||
|
|
[template functions]: /functions/
|
||
|
|
[Go templates]: /templates/introduction/
|
||
|
|
[Go base templates]: /templates/base/
|