Hugo Book

Тема для движка Hugo

Поиск по сайту

Поиск работает в браузере, на MiniSearch.

Плюсы

• Меню языков показывает только существующие переводы — одной настройкой BookTranslatedOnly = true.
• hreflang ставится только на существующие переводы.
• 9 заготовок для своего кода (head, меню, до и после статьи, оглавление, подвал) — тему не нужно править.
• Оглавление справа, на странице выключается параметром bookToC: false.
• Есть блоки «шаги», подсказки, вкладки, раскрывающиеся блоки, диаграммы Mermaid.
• Интерфейс переведён на uk, ru, pt.
• Поиск грузит тексты, только когда человек начинает искать — страницы лёгкие.

Минусы

• Переключатель языков стоит в боковом меню под поиском — переставить можно только копией шаблона меню.
• Боковое меню — дерево разделов: статью можно скрыть или свернуть раздел, но убрать меню на странице нельзя. Для вики меню придётся переписать.
• Нет хлебных крошек и разметки Schema.org — делаются своим кодом.
• hreflang без ссылки страницы на саму себя и без x-default; португальский помечен pt, а не pt-BR.
• В поиске нельзя выбрать, что искать, — всегда весь текст.

Общее впечатление

На этой теме работает вики dieg.net. Тема лежит в проекте обычными файлами, без сабмодуля.

С языками Hugo Book справляется лучше Hextra и Lotus Docs: меню и hreflang не ссылаются на несуществующие переводы. Главные минусы — боковое меню и место переключателя языков: их не настроить параметрами, только переписать шаблоны.

Что пришлось доработать

Микроразметка schema.org

Хлебные крошки

Результаты по требованиям с этой темой

Многие результаты задаёт сам Hugo, и они одинаковы для всех тем: языковые адреса, работа без базы данных, генерация страниц из данных. От темы зависят меню языков, hreflang, поиск и места для своего кода — их нужно проверять у каждой темы отдельно. Значок в пунктирной рамке — результат перенесён из проверки с другой темой этого движка. Наведите на значок, чтобы увидеть подробности.