Написание статей блога

Настройка и конфигурация

Перед любым действием прочтите Перед началом работы и Основные сведения о терминале. В этих инструкциях предполагается, что вы открыли полный монорепозиторий supastack в VS Code; его корень package.json отмечает корень репозитория. В командах pnpm пакет рабочей области представляет собой папку приложения или общего кода; В продукте рабочее пространство — это контейнер данных и граница безопасности команды. corepack pnpm --filter ... выбирает один пакет из монорепозитория, пока команды выполняются из его корня. Если вы открыли только синхронизированную папку мобильного устройства или рабочего стола, она не содержит веб-серверной части, настройки Docker или корневых сценариев: запустите серверную часть из этого монорепозитория или доступного размещенного сервера и используйте собственные сценарии папки платформы. Переменная среды — это именованный параметр, хранящийся в локальном файле .env или на панели управления хостингом; перезапустите соответствующее приложение после его изменения и не допускайте попадания секретов сервера в значения NEXT_PUBLIC_ и EXPO_PUBLIC_.

1. В VS Code откройте packages/web-core/src/resources/content.ts и скопируйте полную ближайшую статью в качестве отправной точки; Копия статьи находится в репозитории, а не на панели публикации.

2. Присвойте статье новый ярлык, заголовок, категорию, дату, разделы и существующий ярлык.

3. Из корня репозитория запустите corepack pnpm --filter @supastack/web-tanstack 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-tanstack dev

# Replace <your-slug> with the article slug:
# http://localhost:3000/blog/<your-slug>
corepack pnpm test -- packages/web-core/src/resources/content.test.ts

Рабочий процесс внедрения

Следуйте полному существующему объекту Post для остальных полей типа. Держите slug стабильным после публикации, чтобы общие URL продолжали работать. Заголовкам нужны уникальные ID секций для оглавления и якорных ссылок.

Категории выводятся из каталога статей. Индекс использует фильтрацию по URL, а маршруты статей выводят head-метаданные из контента. Значение guide должно совпадать с существующим slug документации; связанный контент должен вести к полезному следующему шагу.

Проверка и устранение неполадок

Если статья возвращает 404, убедитесь, что ее фрагмент уникален и что он был добавлен в список статей в packages/web-core/src/resources/content.ts.. Если оглавление никуда не переходит, присвойте каждому разделу уникальный идентификатор. Запустите corepack pnpm test -- packages/web-core/src/resources/content.test.ts из корня, чтобы увидеть ошибки проверки содержимого.

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