Hugo: Архитектура статических сайтов и CI/CD

Mon, 01 Jan 0001 00:00:00 +0000

Использование Hugo для генерации статических сайтов позволяет достичь максимальной производительности при минимальных накладных расходах. Все проекты на стеке *.potatoenergy.ru используют единую методологию сборки, конфигурации и деплоя.

Ключевые принципы:

🔹 Декларативная конфигурация через hugo.toml и config/_default/
🔹 Мультиязычность через translationKey без дублирования логики
🔹 Наследование параметров через cascade во фронтматтере
🔹 Оптимизация ассетов через Hugo Pipes (минификация, фолбэки, хеширование)
🔹 Изоляция окружения сборки через Docker

🗂 Структура проекта
#

project/
├── config/_default/
│ ├── hugo.toml # Базовые настройки: baseURL, theme, outputs
│ ├── params.toml # Глобальные параметры темы и кастомные переменные
│ ├── menus.toml # Конфигурация навигации
│ └── languages.*.toml # Локализация: displayName, copyright, author
├── content/
│ ├── {section}/
│ │ ├── _index.{ru,en}.md # Страница-листинг с описанием раздела
│ │ └── {slug}/
│ │ ├── index.{ru,en}.md # Контент с переводом через translationKey
│ │ └── assets/ # Ресурсы, привязанные к странице
│ └── _index.{ru,en}.md # Главная страница
├── layouts/
│ ├── _default/ # Шаблоны по умолчанию: single.html, list.html
│ ├── partials/ # Переиспользуемые компоненты: head, footer, svg
│ ├── shortcodes/ # Кастомные шорткоды: audio, toggle, icon
│ └── shortcodes/ # Переопределение шаблонов темы (при необходимости)
├── static/ # Файлы, копируемые «как есть»: robots.txt, favicons
├── assets/ # Исходники для Hugo Pipes: CSS/JS для сборки
└── docker-compose.yml # Окружение для локальной разработки

🌐 Мультиязычность без дублирования
#

Связь переводов реализуется через translationKey во фронтматтере:

Blowfish on Ponfertato

Hugo: Архитектура статических сайтов и CI/CD

🗂 Структура проекта #

🌐 Мультиязычность без дублирования #

🗂 Структура проекта
#

🌐 Мультиязычность без дублирования
#