GUIDE to Hugo commands.md

GUIDE to Hugo commands

Краткий справочник команд для текущего проекта BWWH.

1. Проверить версии инструментов

mise current

Показывает версии инструментов из mise.toml.

В текущем проекте:

[tools]
hugo = "latest"
node = "24"
python = "3.14"

2. Запустить сайт локально

hugo server -D

Что делает команда:

• запускает локальный сервер Hugo;
• показывает draft-страницы, если они есть;
• автоматически пересобирает сайт после сохранения файлов.

Обычный адрес:

http://localhost:1313/

3. Собрать сайт

hugo

Что делает команда:

• читает hugo.yaml;
• берет контент из content/ и themes/basic/content/;
• применяет шаблоны из themes/basic/layouts/;
• создает готовый сайт в public/.

4. Собрать сайт как для GitHub Pages

hugo --minify --baseURL "https://sock-puppet-dev.github.io/BWWH/"

Что добавляют параметры:

• --minify уменьшает итоговые HTML/CSS/JS-файлы;
• --baseURL задает правильный адрес опубликованного сайта.

5. Очистить старые файлы сборки

hugo --cleanDestinationDir

Используй, если в public/ могли остаться старые файлы после удаления страниц.

Вариант с минификацией:

hugo --cleanDestinationDir --minify

6. Создать новую страницу

hugo new about/index.md

Создает leaf bundle:

content/about/index.md

Такой формат удобен, если рядом со страницей позже нужны изображения или другие файлы.

7. Создать новый учебный пост

hugo new posts/my-first-post.md

Для текущего проекта важно понимать разницу:

• основные страницы лежат в content/;
• учебные посты сейчас лежат в themes/basic/content/posts/;
• Hugo публикует оба источника.

8. Создать новую тему

hugo new theme basic

Эта команда уже использовалась для создания локальной темы themes/basic.

Повторно запускать ее в текущем проекте не нужно, иначе можно перезаписать учебную тему.

9. Проверить состояние Git

git status --short

Если вывод пустой, рабочее дерево чистое.

10. Отправить изменения на GitHub

git add .
git commit -m "Описание изменения"
git push origin main

После git push GitHub Actions автоматически запустит деплой.