Как с помощью ИИ разработали инструмент проверки HTML для WordPress

Инструмент VozniNet для проверки HTML перед публикацией в WordPress: окно с кодом, предпросмотром и панелью результатов
Внутренний инструмент для предварительной проверки разметки перед публикацией.

Кейс VozniNet · разработка с помощью ИИ

От требований редактора – к проверяемому инструменту

Для подготовки публикаций мы разработали программу, которая проверяет HTML-фрагмент до добавления в запись WordPress. ИИ помог при создании кода, а готовый инструмент выполняет проверку по заданным правилам – без обращения к нейросети и без отправки текста на сервер.

8групп правил
1автономный HTML-файл
9вариантов с ошибками проверено
0отправок фрагмента на сервер

01 · Суть разработки

Что именно мы создали

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

ЗадачаСверять HTML до публикации

Находить формальные несоответствия в коде записи.

РешениеОтдельный HTML-файл

Поле для кода, кнопки управления и отчёт по правилам.

ОбработкаВнутри окна браузера

Вставленный материал не отправляется на сервер.

РешениеОстаётся за редактором

Программа сообщает о замечании, но не переписывает код.

02 · Исходная задача

Проверять до публикации, а не после неё

В запись WordPress можно добавить собственную разметку – заголовки, изображения, внутренние ссылки, раскрывающиеся ответы и другие блоки. Перед публикацией редактору нужно сверить код с требованиями сайта.

Например, убедиться, что в записи ровно один маркер разделения анонса и полного текста, у изображений заполнены необходимые атрибуты, а ссылки-якоря ведут к существующим элементам.

01Повторяющиеся требования

Одни и те же условия приходится держать в памяти при каждой публикации.

02Ошибки в большом фрагменте

Повторный id, пустой alt или пропущенный блок легко не заметить при чтении.

03Ручная вычитка решает другое

Она оценивает смысл и подачу, а не все формальные свойства кода.

04Нужна узкая проверка

Автоматизировать только то, что описывается точным и повторяемым правилом.

Граница проекта. Мы не создавали универсальный анализатор всех страниц WordPress. Первая версия проверяет один вставляемый фрагмент и требования, важные для публикационного процесса VozniNet.

03 · Логика программы

Восемь правил – восемь понятных результатов

Каждое требование превратили в отдельное условие, сопоставили с сообщением в отчёте и подготовили для него проверочный пример.

Схема восьми групп правил проверки HTML: маркер анонса, заголовки, изображения, ссылки, якоря, порядок блоков и ограничения кода
Отдельные группы проверок связаны с конкретными требованиями к публикационному фрагменту.
01

Один маркер разделения

Программа ищет маркер разделения анонса WordPress и проверяет, что он встречается ровно один раз. При отсутствии или повторе показывает найденное количество.

02

Без второго H1

Главный заголовок записи задаётся отдельно в WordPress. Поэтому инструмент считает элементы H1 внутри фрагмента и отмечает их наличие.

03

Атрибуты изображений

Для каждого изображения проверяются src, alt и title. Если картинок нет, результат предлагает ручную проверку – отсутствие изображений может быть уместным.

Наличие атрибутов не подтверждает, что файл открывается или описание точно передаёт его содержание.

04

Только внутренние адреса

Разрешены адреса VozniNet, относительные пути и переходы к разделам текущего материала. Адреса других сайтов отмечаются как несоответствие.

Программа проверяет запись адреса, но не открывает страницу и не подтверждает её доступность.

05

Уникальные id и рабочие якоря

Инструмент находит повторяющиеся значения id и сверяет ссылки вида #razdel с существующими элементами.

Это помогает заметить разрыв между ссылкой в тексте, оглавлением или кнопкой перехода и нужным разделом.

06

Понятная последовательность заголовков

В принятой структуре H2 обозначает основные разделы, H3 – подразделы. Проверка отмечает H3 до первого H2 и уровни глубже H3.

Смысл разделов и точность формулировок остаются предметом редакторской оценки.

07

Вопросы перед финальным обращением

Инструмент ищет раздел частых вопросов, раскрывающиеся блоки и ссылку на страницу контактов, а затем проверяет их порядок.

Это правило для принятой структуры VozniNet, а не распознавание любых форм призыва к действию.

08

Без отдельных таблиц стилей и сценариев

В коде записи программа отмечает отдельные элементы style и script, а также подключённую таблицу стилей. В этой вёрстке оформление задано встроенными атрибутами HTML.

Зачем делить правила. Когда у каждого условия есть отдельный результат, редактор видит, что именно сработало, и может проверить замечание без догадок.

04 · Разработка с ИИ

ИИ ускорил работу над кодом, но не получил роль исполнителя проверки

Сначала редакционные требования перевели в проверяемые условия. Для каждого правила определили три возможных состояния: соблюдено, требуется ручной просмотр или найдено несоответствие.

Затем ИИ помог подготовить структуру проверок и первоначальный вариант кода. Поведение инструмента сопоставили с требованиями, уточнили пограничные случаи и проверили на отдельных вариантах разметки.

Где используется ИИ

ПостановкаТребование переводится в условие.
Подготовка кодаИИ помогает собрать первый вариант.
Проверка человекомРезультат сверяется с задачей.

После запуска ИИ не вызывается. Инструмент работает по заданным правилам и не отправляет вставленный код ни в модель, ни на сервер.

Рабочая сцена разработки: специалисты и ИИ помогают подготовить и проверить код, после чего редактор получает отчёт автономного инструмента
ИИ участвовал в создании программы. Пользовательская проверка после запуска выполняется автономно.

05 · Рабочий процесс

Как редактор проверяет фрагмент

Всё собрано в одном HTML-файле: поле для кода, кнопки проверки, показа примера и очистки, а также область отчёта.

ШАГ 01Вставить фрагмент

Исходный код остаётся в окне браузера.

ШАГ 02Запустить проверку

Программа последовательно применяет восемь групп условий.

ШАГ 03Изучить результаты

Каждое правило получает отдельное пояснение.

ШАГ 04Исправить вручную

Редактор сам решает, как устранить замечание.

ШАГ 05Проверить повторно

После изменений можно запустить проверку ещё раз.

ПройденоУсловие выполнено для проверяемого фрагмента.
Нужен просмотрАвтоматического вывода недостаточно – проверьте пункт вручную.
Найдено несоответствиеОтчёт указывает, какое правило следует перепроверить.

Код не меняется автоматически. Инструмент не сохраняет его в отдельном хранилище, а найденные замечания и решения по исправлению остаются под контролем автора.

06 · Проверка результата

Проверили верный пример и девять намеренных ошибок

Цель испытаний – проверить именно реализованные условия на подготовленных фрагментах, а не заявить поддержку всех возможных вариантов HTML.

Испытательный стенд с корректным HTML-фрагментом и примерами разметки с различными структурными ошибками
Один положительный пример и отдельные сценарии для проверки каждого типа замечания.

Контрольный пример

Все 8 правил пройдены

Корректный фрагмент получил ожидаемые положительные результаты.

Ошибки, включённые в испытания

Нет маркера разделения анонса.
Добавлен лишний H1.
Не заполнен атрибут изображения.
Указана ссылка на другой домен.
Внешний адрес записан без протокола.
Повторяется значение id.
Нарушена последовательность заголовков.
Блок вопросов расположен в неверном порядке.
Добавлен отдельный элемент style.

Отдельно проверили пограничный адрес. Запись вида //example.org не должна ошибочно приниматься за внутренний путь. Подготовленный вариант был распознан как внешний адрес.

07 · Границы автоматизации

Что проверяет программа – и что остаётся человеку

Разделение ответственности не ограничивает пользу инструмента, а делает его результат понятным. Формальное правило можно проверить автоматически; качество публикации требует редакторского решения.

✓

Автоматическая сверка

  • Количество маркеров разделения.
  • Наличие H1 во фрагменте.
  • Атрибуты src, alt и title у изображений.
  • Адреса ссылок и переходы-якоря.
  • Повторяющиеся id и порядок заголовков.
  • Положение вопросов и заключительной ссылки.
  • Отдельные элементы style и script.
!

Редакторская проверка

  • Смысл, точность и убедительность текста.
  • Соответствие изображения содержанию.
  • Доступность самого файла изображения.
  • Фактическая работа ссылок и доступность страниц.
  • Скорость загрузки и отображение на устройствах.
  • Вид страницы после вставки в тему WordPress.

Практический порядок. Сначала проверить формальные условия, затем вставить код в WordPress, открыть предварительный просмотр, проверить страницу на телефоне и перейти по ключевым ссылкам.

08 · Результат разработки

Предварительная проверка с объяснимым итогом

Получился автономный инструмент для проверки HTML перед публикацией в WordPress. Он принимает код в окне браузера, последовательно проверяет восемь групп правил и объясняет результат, не изменяя исходный фрагмент.

Повторяющиеся требования стали явными: их можно обсуждать, уточнять и проверять отдельно. Если появятся новые условия к изображениям, ссылкам или структуре материалов, набор правил можно развивать.

Логика отчёта

ПройденоФормальное условие выполнено.
ВниманиеНужна ручная оценка редактора.
ОшибкаНайдено несоответствие правилу.

Экран отчёта проверки HTML с тремя состояниями: успешно, требуется внимание и найдена ошибка; редактор может просмотреть исходный код
Отчёт показывает состояние каждого правила; окончательное решение о правках принимает редактор.
Без неподтверждённых обещанийЭкономию времени, рост трафика или числа обращений отдельно не измеряли.
Практическая пользаФормальные требования проверяются последовательно до публикации.
Контроль у автораИсходный код не меняется, а результат можно перепроверить.

09 · Применение подхода

Когда разработка программы с помощью ИИ оправдана

В первую очередь – когда повторяющаяся операция уже описывается правилами, а цена ошибки понятна и контролируема.

РЕДАКЦИЯ

Проверка публикаций

Обязательные поля, структура документа, оформление записей и типовые требования.

ТОРГОВЛЯ

Карточки товаров

Наличие характеристик, единый формат сведений и контроль заполнения полей.

ОПЕРАЦИИ

Сборка отчётов

Повторяемая обработка данных с заранее оговорёнными условиями и форматом результата.

ДОКУМЕНТЫ

Контроль структуры

Проверка обязательных разделов, порядка блоков и типовых условий перед передачей дальше.

Что важно определить до начала разработки

Входные данные
Что именно поступает в программу?
Правила
Какие условия можно выразить точно?
Исключения
В каких случаях нужен человек?
Цена ошибки
Чем опасен неверный автоматический вывод?

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

11 · Ответы по проекту

Частые вопросы

Коротко о том, что делает инструмент, как использовался ИИ и где остаётся необходимым ручной контроль.

Может ли ИИ сам проверять код во время работы программы?
Нет. ИИ использовали при разработке. После открытия файла проверка выполняется по заданным условиям и не обращается к нейросети или внешнему серверу.
Программа исправляет HTML автоматически?
Нет. Она показывает найденные несоответствия, но не переписывает исходный фрагмент. Исправления вносит автор или редактор, после чего код можно проверить повторно.
Проверяет ли инструмент, что ссылка или изображение открываются?
Нет. Программа анализирует адрес ссылки в коде, но не переходит по нему. Для изображений проверяются src, alt и title, но не загрузка файла и не точность описания.
Нужно ли после проверки просматривать страницу WordPress?
Да. Инструмент проверяет фрагмент до публикации, а итоговый вид зависит от темы и настроек сайта. После вставки нужно открыть предварительный просмотр, проверить страницу на телефоне и пройти по важным ссылкам.
Можно ли настроить подобные правила под другой сайт?
Да. Сначала фиксируют требования и примеры допустимого и недопустимого кода, затем определяют, какие проверки можно надёжно автоматизировать. Объём разработки зависит от правил и способа публикации.

Обсудим вашу задачу

Нужно проверить повторяющийся процесс в вашем проекте?

Опишите, что команда регулярно делает вручную, какие требования важно соблюдать и где чаще всего возникают ошибки. Мы оценим задачу и предложим подходящий формат разработки – от небольшой автономной программы до отдельного решения для сайта.

Обсудить задачу с VozniNet

Расскажите о задаче и желаемом результате.