Роль: Контент и SEO

Роль контента — автор и редактор сайта. Она работает только с текстами и картинками: создаёт страницы, заполняет три строки для поиска вверху, пишет секции, добавляет переводы и переносит тексты со старого сайта. Внешний вид сайта и скрипты она не трогает.

Пример. Чтобы добавить страницу услуги, роль контента копирует существующий файл услуги под новым именем, меняет title, h1, description и текст, кладёт фото в media/ и запускает проверку. Если факта нет — цены, телефона, — она его не выдумывает: оставляет поле пустым и добавляет вопрос в список для владельца.

Эта страница нужна, когда вы отдаёте работу с текстами агенту или делаете её сами и хотите чек-лист.

На входе: структура сайта (ключи, типы, секции по типам, языки) и тексты или факты заказчика. Для существующего сайта — сама папка.

На выходе: файлы страниц в content/ по языкам, картинки в media/, справочники в data/, redirect_from у страниц, список долгов контента и вопросов.

$H page service roof мой-сайт --folder services            # → content/MAIN_LANG/services/roof.md
$H page service roof мой-сайт --folder services --lang ru  # перевод

heron page кладёт полный SEO-блок и заготовки всех секций, которые тема объявила у типа (types.TYPE.uses). Можно и скопировать готовый файл — результат тот же. Образец заполненной страницы — templates/page.md.

Имя файла — ключ страницы: латиница, цифры, дефис; одинаковое во всех языках. Другой адрес у перевода — поле slug.

Восемь групп, порядок и комментарии сохраняются; пустые необязательные поля остаются закомментированными.

Все поля и значения по умолчанию — контракт, формат страницы (§4.2).

• вступление — до первого ##, не больше двух абзацев: подводка и обещание;
• секции — ## Заголовок {#якорь}, якоря — из uses типа. Опечатка в якоре — строка «тема не использует» в отчёте;
• форма секции — разметкой: список, 1. шаги, ### Вопрос? FAQ, ключ | значение факты, таблица, > совет; классы .alert, .timeline, .gallery в якоре. Таблица форм — формат страницы (§4.4);
• нет материала — нет секции. Заготовку из heron page удалить, а не заполнять общими словами.

• на свои страницы — ключом от корня без языкового префикса: ссылка на кровлю ведёт на /services/roof/, на главную — на /. HERON подставит адрес нужного языка;
• «смотрите также», «по теме» — поля связей из theme.yaml (related: [gutter]), не ручные списки ссылок;
• телефон, адрес, часы, соцсети — не в тексте, а в contact/organization в site.yaml.

Файлы — в media/, путь от корня сайта: media/services/roof.png. Иллюстрации — PNG/WebP с прозрачным фоном, фото — JPEG; нарезку HERON делает сам. У каждой картинки — alt (image_alt, подпись в ![…]).

• старый адрес, содержимое которого переехало, — redirect_from у новой страницы, кириллицей или %D0%…;
• две-три старых страницы об одном — одна новая, все адреса в её redirect_from;
• адреса, которых больше нет, — в gone в site.yaml, не в странице.

Порядок переезда — гайд SEO, раздел «Переезд со старого сайта».

Перевод — файл с тем же именем в папке языка, например content/ru/. Нет перевода — страница остаётся на основном языке, в отчёте предупреждение. Основной язык не может быть пустым в проде (E021).

• у каждой страницы структуры есть файл; имена файлов одинаковы во всех языках
• title, h1, description заполнены и различаются; группа 2 заполнена
• ни одного выдуманного факта; непроверенное — в вопросы
• пустых секций-заглушек нет
• ссылки ключами; связи полями темы
• у картинок alt
• старые адреса разнесены по redirect_from и gone
• check без ошибок; сводка «Не заполнено» — в отчёт

Эта страница повторяет файл docs/agents/content.md из ветки prod. Репозиторий обновляется первым: content.md на GitHub.