> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

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

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

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

Перед любым действием прочтите [Перед началом работы](https://supastack.dev/ru/docs/web/before-you-start.md) и [Основные сведения о терминале](https://supastack.dev/ru/docs/web/terminal-basics.md). В этих инструкциях предполагается, что вы открыли полный монорепозиторий 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 из корня, чтобы увидеть ошибки проверки содержимого.

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


## Вперёд

[Документация продукта](https://supastack.dev/ru/docs/web/docs-site.md)