Гайд по 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, значит, либо ты сидел в танке, либо занимался какой-то совсем уж узкоспециализированной херней. Но это поправимо. ...