Hugo: Static Site Architecture & CI/CD

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

Using Hugo for static site generation delivers maximum performance with minimal overhead. All projects in the *.potatoenergy.ru stack share a unified methodology for configuration, building, and deployment.

Core principles:

🔹 Declarative configuration via hugo.toml and config/_default/
🔹 Multilingual support via translationKey without logic duplication
🔹 Parameter inheritance via cascade in front matter
🔹 Asset optimization via Hugo Pipes (minification, fallbacks, hashing)
🔹 Build environment isolation via Docker

🗂 Project structure
#

project/
├── config/_default/
│ ├── hugo.toml # Base settings: baseURL, theme, outputs
│ ├── params.toml # Global theme params and custom variables
│ ├── menus.toml # Navigation configuration
│ └── languages.*.toml # Localization: displayName, copyright, author
├── content/
│ ├── {section}/
│ │ ├── _index.{ru,en}.md # Listing page with section description
│ │ └── {slug}/
│ │ ├── index.{ru,en}.md # Content with translation via translationKey
│ │ └── assets/ # Page-bundled resources
│ └── _index.{ru,en}.md # Homepage
├── layouts/
│ ├── _default/ # Default templates: single.html, list.html
│ ├── partials/ # Reusable components: head, footer, svg
│ ├── shortcodes/ # Custom shortcodes: audio, toggle, icon
│ └── shortcodes/ # Theme template overrides (if needed)
├── static/ # Files copied as-is: robots.txt, favicons
├── assets/ # Hugo Pipes sources: CSS/JS for processing
└── docker-compose.yml # Local development environment

🌐 Multilingual without duplication
#

Translation linking is handled via translationKey in front matter:

Static on Ponfertato

Hugo: Static Site Architecture & CI/CD

🗂 Project structure #

🌐 Multilingual without duplication #

🗂 Project structure
#

🌐 Multilingual without duplication
#