Как устроен этот справочник

Справочник собран как статический сайт: каждая статья превращается в готовый HTML ещё до публикации. Это сокращает объём клиентского кода, ускоряет первую загрузку и делает контент доступным даже при отключённом JavaScript.

Архитектура

Генератор Hugo отвечает за маршруты, Markdown, оглавление, sitemap, языковые версии и метаданные. В проекте нет React, Astro и библиотеки компонентов. Шаблоны находятся в layouts/, стили — в assets/css/main.css, а контент — в языковых каталогах content/.

Языковые версии

Английский — основной язык и открывается без префикса. Русская версия живёт в /ru/, немецкая — в /de/. У всех переводов совпадает translationKey, поэтому переключатель языка ведёт на ту же статью, а не на главную страницу.

Что работает в браузере

Небольшой файл на чистом JavaScript решает две задачи: сохраняет светлую или тёмную тему и выполняет поиск по локальному JSON-индексу. Навигация, чтение статей и смена языка работают без него.

Как обновлять материалы

Правьте нужный Markdown-файл в content/en, content/ru или content/de. Если добавляете статью, создайте версии с одинаковым относительным путём и translationKey: так Hugo автоматически свяжет переводы и добавит hreflang в HTML.