Основы · 5
Когда вы запускаете heron build, HERON читает папку сайта и записывает готовый сайт в папку dist/. Эта страница показывает, что происходит по дороге, чтобы странный результат или сообщение об ошибке стали понятны.
Программирования здесь нет: только путь одной страницы от текстового файла до браузера и то, как читать сообщения сборки.
Представьте типографию. Вы приносите текст (файлы .md), фотографии (media/) и несколько указаний (site.yaml). У типографии есть макет — тема. Она проверяет, что ничего не забыто, верстает каждую страницу в макет, готовит фото под каждый формат и печатает весь тираж. Готовый тираж — это папка dist/: обычные веб-страницы, которые отдаст любой хостинг.
Типография каждый раз работает одинаково. Одна и та же папка всегда даёт один и тот же сайт — на ноутбуке, на GitHub и на сервере.
Когда нужна эта страница: когда сайт выглядит не так, как вы ждали, или сборка остановилась с ошибкой. Когда можно пропустить: пока всё работает.
prices.md в папке вашего языка: настройки вверху, ниже текст с секциями. Как — показано в Markdown за 10 минут.prices.md становится /prices/. Если языков несколько, копия в папке второго языка получает его префикс, например /de/…. Список страниц вести не нужно: новый файл — новая страница.##, и каждая получает форму: текст, список, шаги, карточки, таблица, вопросы. См. Формы секций.dist/prices/index.html.| В вашей папке | В dist/ |
|---|---|
content/en/index.md | index.html, главная |
content/en/prices.md | prices/index.html, адрес /prices/ |
content/de/prices.md (второй язык) | de/…/index.html, адрес с префиксом языка |
media/team.jpg | media/…, копии нескольких ширин, WebP и AVIF |
site.yaml | Название, меню и контакты на каждой странице, sitemap.xml, robots.txt, llms.txt |
theme/ | Внешний вид: HTML-макет, assets/ со стилями и скриптами |
static/ | Копируется как есть, например файл подтверждения для поисковика |
Сайт на вашем компьютере, обновляется при каждом сохранении.
heron serve ., затем откройте localhost:8000.Собирает весь сайт в dist/ один раз.
heron build .Та, что уходит в работу.
heron build . --env prod --strictВ конце HERON печатает отчёт. Обычный заканчивается числом записанных файлов:
Files written: 128 → my-site/dist
Когда что-то не так, HERON называет файл, строку, что не так и что сделать. Ошибка останавливает сборку:
E002 content/en/prices.md:3: пустое описание
что сделать: добавьте description до 155 знаков
Предупреждение не останавливает пробную сборку, но останавливает итоговую:
Предупреждений — 2:
ссылки — 1:
ru/about.md:14: ссылка /team/ никуда не ведёт
прочее — 1:
ru/prices.md: title длиннее 60 знаков (71)
Как это читать:
E002) — вид проблемы. Список кодов — в разделе Если что-то пошло не так, полностью — в спецификации сборки.dist/, в .heron-cache/warnings.txt.Исправьте первую ошибку, сохраните, соберите снова. Часто одна правка убирает несколько сообщений.
HERON делает работу один раз, при сборке. Посетитель получает готовый файл: ничего не нужно вычислять, не нужно спрашивать базу данных, на сервере нечему ломаться. Поэтому стартовый сайт получает 100 баллов скорости в Lighthouse на телефоне, а тысяча страниц на двух языках собирается за несколько секунд.
Медленная часть первой сборки — фото: каждый размер кодируется один раз. HERON хранит их в кэше, поэтому следующие сборки занимают секунды.
Пока вы пишете, heron serve собирает сам при каждом сохранении. Итоговая сборка нужна только для публикации, а с git push её запускает GitHub.
Проверьте, что файл сохранён и лежит внутри content/. Если смотрите живой сайт — он меняется только после итоговой сборки и выкладки. Обновите страницу в браузере с зажатым Shift, чтобы он не показывал сохранённую копию.
Неправильный файл остановит сборку с сообщением, а живой сайт останется прежним. В этом и смысл строгой сборки: сломанная версия не выходит.
Положите папку на GitHub: Git и GitHub. Полное описание сборки — в разделе Сборка: этапы, команды, ошибки.