Relearn

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

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

Поиск в боковом меню: подсказки при вводе и отдельная страница результатов. На Lunr, включён сразу.

Плюсы

• Сделана для документации: боковое меню по разделам, хлебные крошки, переход к следующей странице.
• Меню языков и hreflang ведут только на существующие переводы; есть x-default, код pt-br правильный.
• Переключатель языков ставится вверх или вниз бокового меню настройкой, без правки шаблонов.
• Верхняя панель настраивается так же, как меню: какие кнопки и где показывать.
• Боковое меню гибко настраивается: порядок, раскрытые разделы, скрытые страницы, свои меню.
• Много мест для своего кода: head, подвал, до и после заголовка, над и под статьёй, меню.
• Поиск выдаёт только статьи на языке страницы и понимает формы слов для en, ru, pt.
• Много блоков: подсказки, вкладки, раскрывающиеся блоки, карточки, Mermaid, формулы.

Минусы

• Поиск не ищет по-украински: статьи на uk в него не попадают. Настройкой не исправить.
• Тексты для поиска грузятся на каждой странице (ru — 135 КБ), даже если поиском не пользуются.
• Украинский перевод интерфейса не подключается сам: в теме он назван ua, а не uk.
• Оглавление — кнопкой в верхней панели, поверх страницы; колонки сбоку нет.
• Нет canonical и блока «шаги».
• По умолчанию ссылки с index.html на конце — нужно выключить настройкой.
• Переключатель языков в верхнюю панель настройкой не поставить — только своим шаблоном.
• Готовится версия 10 (ещё не вышла): уберёт всё, о чём 9.x предупреждает при сборке. Когда выйдет — перепроверить.

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

Тема для документации. Меню языков и hreflang — лучшие из проверенных тем: правильные сразу, а переключатель ставится куда нужно настройкой.

Главный минус для сайта на украинском — поиск: украинские статьи в него не попадают, и настройкой это не исправить. Оглавление открывается кнопкой поверх страницы, а не колонкой сбоку.

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

Переводы интерфейса для en, uk, ru, pt-BR

Корректный canonical

<link rel="canonical" href="{{ .Permalink }}">

Корректный canonical

[params]
  disableExplicitIndexURLs = true

Переключатель языков вверху меню

[params]
  sidebarheadermenus = [
    { type = 'custom', elements = [ { type = 'languageswitcher', icon = 'globe' } ] },
    { type = 'divider' },
  ]
  sidebarmenus = [ { type = 'page' } ]
  sidebarfootermenus = []

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

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