Настольная программа собирает промо-страницу из описания или по ссылке

Два семейства шаблонов в одном интерфейсе

В репозитории два шаблона: template_1 на Bootstrap и template_2 — статическая сборка на Astro со стилями в духе Tailwind. Разметка, имена файлов и набор мест под содержимое у них разные. Поэтому при переключении шаблона программа перестраивает вкладки: у каждого шаблона свои места под изображения, свой набор цветов и свои правила подстановки. Для пользователя порядок работы остаётся тем же.

Страница по ссылке: встроенный загрузчик

Источником может быть папка на компьютере или адрес уже существующей страницы. Загрузчик написан на стандартной библиотеке Python и ведёт себя как аккуратный браузер:

• учитывает <base href>, когда восстанавливает относительные пути
• собирает файлы страницы из img/link/script/source/srcset и из url(...) во встроенных стилях
• проходит по CSS вглубь, включая url() и @import, чтобы не потерять шрифты и фоны
• скачивает файлы только с того же сайта; файлы с внешних CDN остаются ссылками
• перед разбором вырезает содержимое <script>: иначе строки внутри встроенного JS принимаются за src=

Логотип, значок сайта и фон программа находит по разметке

Первая версия раскладывала картинки по местам, угадывая по имени и размеру файла, и подставляла в шапку случайные картинки. Теперь главное — разметка: значок сайта (фавикон) берётся из <link rel="icon">, логотип — из шапки и из alt/class со словами logo/brand, фон — из background-image: url(...) у body/html, картинки отзывов — из своих блоков. Угадывание по имени и весу осталось только запасным вариантом. Декоративные иконки, аватарки и значки внесены в список исключений и больше не оказываются на месте логотипа. Всё, что программа не смогла определить, видно в интерфейсе и правится вручную.

Цвета берутся с исходной страницы

Программа читает HTML вместе с подключёнными файлами CSS и достаёт цвета из переменных темы. Если цвет задан несколько раз, берётся последнее значение, потому что тема должна перекрывать базовые стили. Цвета из hex, rgb() и oklch() приводятся к одному виду. Серые и почти белые отбрасываются, а остальные распределяются по ролям: кнопка, текст кнопки, шапка, фон страницы, карточка, акцент. Дальше цвета видны в интерфейсе как обычные поля, и любой из них можно поправить.

Проект хранится в файле JSON

Всё о сборке сохраняется в файл проекта: выбранный шаблон, пути, всё содержимое, цвета, раскладка картинок по местам, вопросы, отзывы. Чтобы повторить страницу или сделать вариант, достаточно открыть проект и поправить пару полей. Файлы проектов лежат в репозитории рядом с кодом, поэтому у каждой сборки есть история версий.

Картинки сжимаются перед публикацией

Каждый файл, который попадает в шаблон, проходит через Pillow, библиотеку для работы с картинками. Она уменьшает картинку по большей стороне, сохраняет прозрачность у PNG и WebP и выбирает разумное качество. Если Pillow недоступен, файлы просто копируются, и сборка не прерывается. Вручную за такими мелочами на каждой странице не уследишь.

Перед публикацией программа проверяет разметку

У готовой страницы есть обязательные элементы, которые легко потерять при правке шаблона. Это скрытые метки, на место которых хостинг подставляет данные при показе страницы, и общий идентификатор события для аналитики в браузере и на сервере. Программа проверяет их перед выгрузкой: если чего-то нет, восстанавливает и пишет предупреждение в журнал. Правка шаблона не должна незаметно ломать учёт событий: когда статистика молча показывает нули, это замечают слишком поздно.

Публикация в одно действие, даже если имя уже занято

Готовая папка упаковывается в ZIP прямо в памяти (служебные файлы вроде .DS_Store отсеиваются), кодируется в base64 и отправляется на хостинг через его API. Существующие группы подгружаются в выпадающий список, а имя страницы собирается по шаблону вида {store} - {product} - {template} - {lang}. Если хостинг отвечает ошибкой 422 «имя занято», работа не прерывается: программа находит существующую запись и спрашивает, перезаписать ли её. Если согласиться, она отправляет запрос PUT по найденному id. Ключ доступа хранится вне репозитория, в локальном файле настроек, который может читать только владелец (права 600).

Правила оформления лежат рядом с кодом

В репозитории лежат три брифа. Первый описывает общие основы: шрифты, сетку, состояния элементов, мобильную версию и допустимый вес страницы. Ещё два написаны для каждого семейства шаблонов: в них разобран каждый CSS-селектор, перечислено, что убрать и что добавить, и есть список для проверки. Программа отвечает за структуру, брифы — за внешний вид. Без брифов программа просто быстрее тиражировала бы неудачную вёрстку.

Типовые ошибки теперь ловятся до выгрузки

Забытый og:image, значок сайта от прошлого проекта, логотип не на своём месте, картинка на несколько мегабайт, фон, потерянный при переносе, — всё это раньше замечали глазами уже на живой странице. Теперь эти вещи либо вынесены в интерфейс отдельными полями, либо проверяются автоматически перед выгрузкой.

История коммитов — список найденных ошибок

Инструмент доводился на реальных сборках, и почти каждый коммит исправлял конкретную ошибку. Логотип из-за анимации увеличивался на доли пикселя. Относительные пути ломались при переносе. Совпадение имён при повторной выгрузке раньше просто прерывало работу. Мелкие иконки программа принимала за логотип. Такие вещи заранее не предусмотришь, они обнаруживаются в работе. Поэтому инструмент под свой процесс имеет смысл дорабатывать на живых задачах.

Ограничения

Это внутренний инструмент. Интерфейс не покрыт автоматическими тестами. Качество разбора напрямую зависит от того, насколько аккуратно свёрстан источник. На нестандартной странице программа заполняет часть полей неверно. Поэтому всё, что она определила, можно отредактировать, а журнал показывает каждый шаг. Пользователь всегда видит, что именно подставлено и откуда.