For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/web/blog-content.md (or send Accept: text/markdown).
Написание статей блога
Публикуйте локальные типизированные статьи с работающими категориями и ссылками на руководства.
Настройка и конфигурация
Перед любым действием прочтите Перед началом работы и Основные сведения о терминале. В этих инструкциях предполагается, что вы открыли полный монорепозиторий supastack в VS Code; его корень package.json отмечает корень репозитория. В командах pnpm пакет рабочей области представляет собой папку приложения или общего кода; В продукте рабочее пространство — это контейнер данных и граница безопасности команды. corepack pnpm --filter ... выбирает один пакет из монорепозитория, пока команды выполняются из его корня. Если вы открыли только синхронизированную папку мобильного устройства или рабочего стола, она не содержит веб-серверной части, настройки Docker или корневых сценариев: запустите серверную часть из этого монорепозитория или доступного размещенного сервера и используйте собственные сценарии папки платформы. Переменная среды — это именованный параметр, хранящийся в локальном файле .env или на панели управления хостингом; перезапустите соответствующее приложение после его изменения и не допускайте попадания секретов сервера в значения NEXT_PUBLIC_ и EXPO_PUBLIC_.
1. В VS Code откройте apps/web/src/resources/content.ts и скопируйте полную ближайшую статью в качестве отправной точки; Копия статьи находится в репозитории, а не на панели публикации.
2. Присвойте статье новый ярлык, заголовок, категорию, дату, разделы и существующий ярлык.
3. Из корня репозитория запустите corepack pnpm --filter @supastack/web dev и откройте http://localhost:3000/blog/<your-slug>.. Ожидается: статья и связанная с ней ссылка на руководство загружаются локально, прежде чем вы поделитесь URL.
Содержимое блога хранится в файлах src/resources/content.ts и blog-posts.ts. Это контент, управляемый репозиторием; службы публикации CMS нет. Каждому сообщению нужен уникальный ярлык, заголовок, описание, категория, дата, соответствующее руководство и разделы.
{
slug: 'your-article',
title: 'A specific reader question',
category: 'Guides',
date: '2026-09-07',
guide: 'web/local-setup',
sections: [{ id: 'start', title: 'Start here', paragraphs: ['Your original text.'] }]
}Команды для копирования
Следуйте комментариям, чтобы узнать, в какой папке запускается команда. Если помечены два терминала, откройте два окна терминала и продолжайте выполнять первую команду, пока используете вторую.
corepack pnpm --filter @supastack/web dev
# Replace <your-slug> with the article slug:
# http://localhost:3000/blog/<your-slug>
corepack pnpm test -- apps/web/src/resources/content.test.tsРабочий процесс внедрения
Следуйте полному существующему объекту Post для остальных полей типа. Держите slug стабильным после публикации, чтобы общие URL продолжали работать. Заголовкам нужны уникальные ID секций для оглавления и якорных ссылок.
Категории выводятся из каталога статей. Индекс использует фильтрацию по URL, а маршруты статей генерируют метаданные из контента. Значение guide должно совпадать с существующим slug документации; связанный контент должен вести к полезному следующему шагу.
Проверка и устранение неполадок
Если статья возвращает 404, убедитесь, что ее фрагмент уникален и что он был добавлен в список статей в apps/web/src/resources/content.ts.. Если оглавление никуда не переходит, присвойте каждому разделу уникальный идентификатор. Запустите corepack pnpm test -- apps/web/src/resources/content.test.ts из корня, чтобы увидеть ошибки проверки содержимого.
Запустите тесты контента, откройте маршрут статьи, пройдите по связанному руководству и проверьте отфильтрованный индекс. Сверяйте даты и утверждения с исходным материалом. Не публикуйте заглушки ссылок и не заявляйте, что интеграция проверена, только потому что она упомянута в статье.