HERON
Начать

Анкета вместо файла настроек

Конфигуратор

Конфигуратор — это анкета, которая настраивает сайт. Вы заполняете название и домен, справочники (контакты, адрес, кто вы и чем занимаетесь: компания, клиника, юрист, частное лицо), выбираете тему и способ публикации, а конфигуратор подгоняет структуру под ваш проект: пишет файл настроек, сценарий сборки и скрипты.

У каждого поля есть подсказка, у некоторых — короткое видео. Любой ответ можно поменять позже: конфигуратор читает тот же файл, который пишет.

Как открыть

  1. 1

    Создайте сайт

    heron new my-site -y берёт последний образ HERON, и образ создаёт папку сайта: структуру контента, демо-страницы и тему.
    С чего начать
  2. 2

    Запустите конфигуратор

    cd my-site && heron setup . открывает анкету на localhost:8000. Запускайте его из папки сайта: в другой папке он подскажет, где сайт.
  3. 3

    Заполните её

    Пройдите группы ниже и сохраните. Ответы попадут в site.yaml и в файлы, перечисленные дальше.

О чём он спрашивает

Девять групп. Для начала нужны только первые две, остальные подождут до публикации. У каждого поля есть подсказка, а изменённое поле помечено: видно, что было, и его можно вернуть.

Один набор ответов — всё согласовано

Конфигуратор спрашивает каждый факт один раз и записывает его в одно место — site.yaml. Всё, что читают поисковики и нейросети, собирается оттуда при каждой сборке, поэтому ничто ничему не противоречит.

schema.org

Выбранные «кто вы», сфера и специализация становятся разметкой каждой страницы: Dentist с адресом и часами работы, Person с профессией.

Карта сайта

Строится по рабочему домену и страницам в content/, с датами из истории каждого файла.

llms.txt

Сверху короткая заметка для нейросетей, дальше страницы с заголовками и описаниями.

Поменяли один раз

Новый телефон или часы работы меняются в site.yaml, и следующая сборка обновит подвал, разметку и llms.txt вместе.

Часть того, что записывает конфигуратор:

site:
  domain: smith-dental.com
  name: "Smith Dental"
  default_lang: ru
  languages: [ru, de]

organization:
  name: "Стоматология Smith"
  name_de: "Zahnarztpraxis Smith"
  field_of_work: Медицина и здоровье
  specialization: Стоматология

contact:
  phone: "+43 1 234 56 78"
  country: AT
  city: Вена
  channels:
    - {type: phone, purpose: main, value: "+43 1 234 56 78"}
    - {type: telegram, purpose: support, value: "@smithdental"}

seo:
  llms_note:
    ru: |
      ### Как с нами связаться

      Телефон +43 1 234 56 78, с понедельника по пятницу с 8 до 18.

Все ключи site.yaml

Что он записывает

ФайлЧто этоКогда
site.yamlВсе настройки сайта в одном файлеВсегда
.heron/scripts/build.shИтоговая сборка одной командойЕсли включён помощник
.heron/scripts/publish.shПубликация выбранным способом: push, образ или файлыЕсли выбран способ и включён помощник
.gitignoreНе пускает в git кэш и dist/Если включён помощник
.github/workflows/image.ymlСборка на GitHub: проверить, собрать образ, опубликоватьЕсли включена автоматическая сборка

После сохранения

  1. 1

    Посмотрите сайт

    heron serve . и localhost:8000.
  2. 2

    Напишите страницы

    Откройте файл главной страницы в папке вашего языка внутри content/ и замените тексты. Новая страница — копия файла страницы под новым именем.
    Страницы и контент
  3. 3

    Опубликуйте

    Когда всё готово, опубликуйте готовый сайт выбранным способом: .heron/scripts/publish.sh сделает это за вас.
    Хранение и публикация

Вопросы

Конфигуратор обязателен?

Нет. Он пишет обычный site.yaml, и этот файл можно править руками. Каждая настройка описана в спецификации.

Мой токен в безопасности?

Он остаётся на вашем компьютере, вне папки сайта, и в git не уходит. Для git-публикации в реестр самого GitHub личный токен не нужен: GitHub выдаёт сборке собственный, короткоживущий.

Моего типа бизнеса нет в списке. Что делать?

Выберите ближайшую сферу и специализацию или только вид организации, например «местный бизнес». Разметка останется верной, просто менее подробной.

Конфигуратор можно запустить ещё раз?

Да. Он прочитает site.yaml и покажет ваши ответы; изменённые поля помечены, их можно вернуть. Поменяйте нужное и сохраните — сценарий и скрипты перепишутся под новые ответы.