Hugo ShortCodes

←Hugo

ShortCodes — это шаблоны Hugo внутри текста страниц.

Внутри текста страниц нельзя использовать переменные типа .Page.Site.BaseURL. Зато можно использовать ShortCodes — поэтому просто помещаем переменную внутрь шорткода и вызываем его.

Создайте файл шорткода:

layouts/shortcodes/baseurl.html

со следующим содержимым:

{{ .Page.Site.BaseURL }}

и вызывайте его в контенте так:

{{< baseurl >}}

Пример: автоматический alt-текст в изображениях

Подготовим шорткод, чтобы вставлять в тэги изображений в качестве alt-текста название страницы (title).

Создайте файл layouts/shortcodes/title.html с содержимым:

{{- .Page.Title -}}

Используйте этот шорткод в тэгах изображений таким образом:

<img src="…" alt="{{<title>}}">

Ограничения

Шорткоды не работают в шаблонах. Вместо них нужно использовать обычный partial.

Перед шорткодом нужно удалять пустые строки, иначе Hugo добавит тэг <p>.

Шорткоды могут не работать, если вверху страницы <!--More--> или <!-- more --> написан с маленькой буквы и без пробелов: <!--more-->