Lotus Docs

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

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

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

Плюсы

• Аккуратная раскладка документации: боковое меню слева, оглавление справа, на телефоне оглавление — выпадающим списком.
• Оглавление отключается на отдельной странице параметром toc: false.
• Подсветка кода Prism: 297 языков, кнопка «копировать», выделение строк; можно переключить на подсветку самим Hugo (prism = false).
• Хлебные крошки размечены Schema.org BreadcrumbList.
• Open Graph и автоматическая картинка-карточка для соцсетей.
• Обработчик ссылок находит битые внутренние ссылки при сборке.
• Собирается без Go: тему и зависимости можно положить в themes/ и подключить через replacements.

Минусы

• Меню языков для языков без перевода ведёт на несуществующие страницы /en/docs, /uk/docs, /pt/docs (ошибка 404).
• Нет hreflang в <head>, нет заготовок для своего кода — для hreflang и JSON-LD придётся копировать шаблоны темы.
• Индекс поиска с полным текстом всех статей вшит в каждую страницу — для большой вики не подходит.
• Боковое меню показывает только текущий раздел; скрыть статью или рубрику и отключить меню на странице нельзя.
• Тема рассчитана на раздел /docs/ и ставит на главную свой рекламный лендинг — исправляется настройкой cascade.
• Нет блока «шаги», нет шаблонов для тегов и рубрик.
• Интерфейс не переведён на uk и ru; часть подписей вшита на английском.
• Использует устаревшие функции Hugo; последний релиз — апрель 2026.

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

Тема для документации на Bootstrap. Проверена на тестовом наборе вики: 4 языка, часть статей только на ru.

Для вики с несколькими языками у неё те же пробелы, что у Hextra: меню языков ведёт на несуществующие страницы, hreflang нет. Но здесь хуже: нет заготовок для своего кода, поэтому любые правки — это копии шаблонов темы. Самое серьёзное для вики — поиск: полный текст всех статей вшит в каждую страницу, и с ростом вики страницы будут становиться всё тяжелее. Боковое меню показывает только текущий раздел и не управляется параметрами.

Сильные стороны — оглавление (справа, на телефоне выпадающим списком, отключается на странице), подсветка кода и разметка хлебных крошек.

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

Свои разделы вместо /docs/

[[cascade]]
  type = "docs"
  [cascade.target]
    kind = "{home,section,page}"

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

[params.flexsearch]
  enabled = true
  searchSectionsIndex = ["docs"]

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

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