hugo

Оглавление гайда по Hugo для суровых инженеров:

• Оглавление гайда по Hugo для суровых инженеров:
• 1. Вводная для тех, кто не в теме
  • Что за зверь этот Hugo и на кой хрен он нужен?
  • Почему статика – это зашибись (краткий ликбез по преимуществам)
  • Когда Hugo – твой выбор, а когда лучше даже не начинать
• 2. Быстрый старт, чтобы сразу в бой
  • Установка (без лишней воды, по-спартански)
  • hugo new site мой_супер_сайт – создаем проект за три секунды
  • Структура каталогов Hugo: что, где и почему именно так
  • hugo server -D – запускаем локальный сервер и смотрим, что получилось
• 3. Контент – всему голова
  • Markdown – твой основной инструмент. Фичи и как им пользоваться по-человечески.
  • Front Matter (YAML/TOML/JSON) – метаданные для твоих страниц. Зачем и как.
  • Типы контента (content types): посты, страницы, кастомные разделы.
  • Таксономии: категории, теги и прочая сортировка контента.
  • Архетипы: шаблоны для создания однотипного контента, чтобы не копипастить.
• 4. Шаблоны – лицо сайта
  • Go Templates – основы основ (синтаксис, переменные, функции)
  • Базовые шаблоны и блоки (DRY, мать его)
  • Списковые страницы (индексы, категории, теги и т.д.)
  • Одиночные страницы (деталка поста/страницы)
  • Partials (переиспользуемые куски кода)
  • Встроенные переменные Hugo (.Page, .Site – что доступно из коробки)
• 5. Конфигурация – рулим всем из одного места
  • Файл конфигурации (hugo.toml или config.toml/yaml/json) – сердце проекта.
  • Основные настройки: baseURL, title, languageCode, theme.
  • Настройка меню (главное, боковое, подвальное – какое хочешь).
  • Переменные окружения для разных конфигураций (дев, прод).
• 6. Расширенные возможности
  • Shortcodes (макросы для контента, если Markdown уже не хватает)
  • Data Templates (грузим данные из JSON, YAML, CSV – откуда угодно)
  • Asset Pipeline (Hugo Pipes) – обработка CSS/JS, картинок
  • Мультиязычность (если вдруг приспичило)
  • Обработка изображений (ресайз, кроп, вот это всё)
• 7. Сборка и деплой
  • Команда hugo – собираем статику
  • Оптимизация для продакшена (минификация всего и вся)
  • Куда деплоить (Netlify, Vercel, GitHub Pages, свой сраный VPS – вариантов масса)
  • CI/CD – автоматизируем рутину
• 8. Лучшие практики и подводные камни
  • Организация проекта (чтобы потом самому не охренеть)
  • Производительность (как не сделать тормознутый сайт на статике)
  • Отладка (когда всё пошло… не так)
  • Типичные ошибки новичков (и не очень)

1. Вводная для тех, кто не в теме

Слушай сюда, инженер. Если ты до сих пор не слыхал про Hugo, значит, либо ты сидел в танке, либо занимался какой-то совсем уж узкоспециализированной херней. Но это поправимо.