Как подготовить текст перед публикацией в Wagtail

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

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

Перед публикацией задайте один вопрос: что должен понять или сделать человек после чтения этой страницы?

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

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

Хорошая страница не обязана быть короткой. Но она должна быть собрана вокруг одной понятной задачи.

Подготовка текста — это не только проверка орфографии. Иногда текст написан грамотно, но всё равно не готов к публикации.

Перед размещением проверьте изменяемые данные:

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

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

Для редактора это может быть просто забытый фрагмент. Для пользователя — сигнал, что сайт давно не обновляли. Для бизнеса — потеря доверия.

Wagtail позволяет быстро обновлять контент, но он не знает сам, какие условия в компании изменились. Актуальность информации всё равно проверяет человек.

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

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

Один главный смысл на страницу

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

Если в материале смешаны инструкция, описание услуги, новость, FAQ и внутренний регламент, лучше остановиться и решить, что именно должно быть опубликовано. Иногда один сырой текст нужно превратить не в одну страницу, а в две или три отдельные.

Это особенно важно для Wagtail-проектов с продуманной структурой. Страница находится в дереве сайта, может входить в раздел, иметь свой адрес, ссылки, SEO-поля и место в навигации. Если тема страницы размыта, страдает не только текст, но и структура сайта.

Заголовки H2 и H3 должны отражать структуру

Заголовки помогают читателю ориентироваться.

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

Плохая ситуация: редактор выделяет жирным случайные фразы и визуально делает их «почти заголовками». В итоге текст вроде бы разделён, но структура не читается.

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

Абзацы должны быть короткими

Один абзац — одна мысль. Это простое правило хорошо работает для сайта.

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

Перед публикацией пройдитесь по тексту и разбейте слишком длинные фрагменты. Не нужно дробить каждое предложение на отдельную строку, но абзац на 10–15 строк почти всегда стоит сократить или разделить.

Списки нужны там, где они помогают

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

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

Одна из частых проблем при работе с сайтом — копирование текста вместе с мусорным форматированием.

Если вставить материал из Word, Google Docs, старого сайта, PDF или мессенджера, вместе с текстом могут попасть лишние стили: разные размеры шрифта, скрытые отступы, случайные жирные выделения, кривые списки, пустые строки и другие следы прошлого.

В результате в админке всё может выглядеть терпимо, а на сайте текст внезапно отображается неровно. Где-то абзац крупнее, где-то список съехал, где-то появились странные интервалы.

Лучше вставить очищенный текст и заново применить нужное оформление средствами Wagtail: заголовки, списки, ссылки, выделения, цитаты или другие доступные элементы.

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

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

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

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

Текст ссылки тоже важен. Ссылки «здесь», «тут», «подробнее» часто непонятны без окружающего текста. Лучше писать так, чтобы было ясно, куда человек перейдёт.

Плохо: «Подробнее здесь».

Лучше: «Читайте инструкцию по добавлению изображений в Wagtail».

Перед публикацией проверьте внутренние ссылки на страницы сайта, внешние ссылки на сторонние ресурсы и ссылки на документы. Если страница, на которую вы ссылаетесь, ещё не опубликована или была переименована, переход может работать не так, как ожидалось.

Подробную работу со ссылками лучше смотреть в отдельной инструкции: как добавлять ссылки внутри страницы Wagtail, как выбирать внутренние страницы, как ссылаться на документы и что проверять после вставки.

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

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

Файл должен быть нормально назван. Названия вроде image1.png, photo-final-new-2.jpg или scan123.pdf неудобны для поиска и дальнейшей поддержки. Лучше использовать понятное название, по которому администратор позже сможет понять, что это за файл.

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

Для изображения желательно подготовить alt-текст — короткое описание того, что изображено. Alt-текст помогает описать изображение и может быть важен для доступности и SEO. Это не набор ключевых слов, а нормальное краткое пояснение.

Документы нужно проверять так же внимательно, как основной текст. PDF может открываться, но содержать старые условия, внутренние комментарии, неправильную дату или лишние страницы.

Для CMS это просто файл. Для пользователя — официальный материал компании.

Например, в тексте написано «скачайте актуальный прайс», а прикреплён прошлогодний PDF. Технически всё загружено. По сути — ошибка.

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

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

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

Если в вашей команде редактор отвечает за SEO-поля, заранее подготовьте SEO Title и Description. SEO Title — это SEO-заголовок страницы, Description — краткое описание страницы для поисковых систем и сниппетов. Они должны быть понятными, аккуратными и связанными с содержанием страницы.

Важно разделять зоны ответственности. Редактор может подготовить текст, заголовки, описание и базовые метаданные. А техническое SEO, шаблоны метатегов, микроразметка, индексация, редиректы и сложная структура URL часто требуют SEO-специалиста или разработчика.

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

Админка и итоговая страница сайта — не одно и то же. В админке вы работаете с полями и блоками. На сайте текст отображается внутри шаблона, с реальными стилями, отступами, изображениями и адаптивной версией.

В предпросмотре проверьте, как выглядят заголовки, абзацы, списки, ссылки, изображения и документы. Посмотрите, нет ли слишком длинных фрагментов. Убедитесь, что после чтения понятно, что пользователь должен сделать дальше.

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

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

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