From 2243afe9037327db02a4690f2ea5a62092a35450 Mon Sep 17 00:00:00 2001 From: Peter Kappus Date: Mon, 3 Feb 2020 17:31:06 +0000 Subject: [PATCH] Explain Ace/Amber support has been removed --- content/en/templates/alternatives.md | 61 ++-------------------------- 1 file changed, 3 insertions(+), 58 deletions(-) diff --git a/content/en/templates/alternatives.md b/content/en/templates/alternatives.md index 91de38488..8c57962e7 100644 --- a/content/en/templates/alternatives.md +++ b/content/en/templates/alternatives.md @@ -1,7 +1,7 @@ --- -title: Alternative Templating Languages +title: DEPRECATED - 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. +description: DEPRECATED - Support for Ace & Amber templating has been removed in version 0.62 godocref: date: 2017-02-01 publishdate: 2017-02-01 @@ -19,59 +19,4 @@ 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/ \ No newline at end of file +Support for Amber and Ace templates has been removed since Hugo 0.62 per [issue #6609](https://github.com/gohugoio/hugo/issues/6609).