Блог RSS-каналы и поддержка локализации

Блог документации HagiCode публикует языковые RSS-каналы, соответствующие селектору языка рабочего стола. Подпишитесь только на тот язык, который действительно хотите читать.

Область применения	URL-адрес RSS-канала
Упрощенный китайский	`https://docs.hagicode.com/blog/rss.zh-CN.xml`
Традиционный китайский	`https://docs.hagicode.com/blog/rss.zh-Hant.xml`
английский	`https://docs.hagicode.com/blog/rss.en.xml`
Английский псевдоним кода рабочего стола	`https://docs.hagicode.com/blog/rss.en-US.xml`
японский	`https://docs.hagicode.com/blog/rss.ja-JP.xml`
корейский	`https://docs.hagicode.com/blog/rss.ko-KR.xml`
немецкий	`https://docs.hagicode.com/blog/rss.de-DE.xml`
французский	`https://docs.hagicode.com/blog/rss.fr-FR.xml`
испанский	`https://docs.hagicode.com/blog/rss.es-ES.xml`
Португальский (Бразилия)	`https://docs.hagicode.com/blog/rss.pt-BR.xml`
русский	`https://docs.hagicode.com/blog/rss.ru-RU.xml`

Совместимость

https://docs.hagicode.com/blog/rss.xml удалён. Вместо него используйте RSS конкретного языка. Английская лента сохраняет rss.en.xml, а rss.en-US.xml по-прежнему доступен как алиас для канонического desktop-кода языка.

Языковое правило

Генерация RSS нормализует значение языка для каждого сообщения в блоге перед фильтрацией:

Если сообщение явно устанавливает language во фронтальной части он нормализован до канонического кода рабочего стола: zh-CN, zh-Hant, en-US, ja-JP, ko-KR, de-DE, fr-FR, es-ES, pt-BR, или ru-RU.
Если в сообщении не установлены явные метаданные языка, язык извлекается из пути к содержимому: src/content/docs/blog/ есть zh-CN, src/content/docs/en/blog/ есть en-US, а другие языковые деревья используют свои имена каталогов.

Каждый элемент RSS содержит соответствующий <language> маркер, чтобы читатели каналов и последующие средства автоматизации могли определить язык сообщения.

Соглашения о маршрутах

В блоге сохранен существующий корневой маршрут на упрощенном китайском языке и короткий маршрут на английском языке. Другие языки рабочего стола используют свой канонический код языка в качестве префикса маршрута.

Код языка	Маршрут блога	Каталог контента	Запасные языки
`zh-CN`	`/blog/<slug>/`	`src/content/docs/blog/`	`en-US`
`zh-Hant`	`/zh-Hant/blog/<slug>/`	`src/content/docs/zh-Hant/blog/`	`zh-CN`, `en-US`
`en-US`	`/en/blog/<slug>/`	`src/content/docs/en/blog/`	`en-US`
`ja-JP`	`/ja-JP/blog/<slug>/`	`src/content/docs/ja-JP/blog/`	`en-US`
`ko-KR`	`/ko-KR/blog/<slug>/`	`src/content/docs/ko-KR/blog/`	`en-US`
`de-DE`	`/de-DE/blog/<slug>/`	`src/content/docs/de-DE/blog/`	`en-US`
`fr-FR`	`/fr-FR/blog/<slug>/`	`src/content/docs/fr-FR/blog/`	`en-US`
`es-ES`	`/es-ES/blog/<slug>/`	`src/content/docs/es-ES/blog/`	`en-US`
`pt-BR`	`/pt-BR/blog/<slug>/`	`src/content/docs/pt-BR/blog/`	`en-US`
`ru-RU`	`/ru-RU/blog/<slug>/`	`src/content/docs/ru-RU/blog/`	`en-US`

Добавить сообщение в блоге

Добавляя сообщение в блог, добавьте .mdx файл с тем же именем файла в каждый каталог содержимого, указанный выше. Например, дата и ярлык должны оставаться одинаковыми на разных языках. 2026-04-29-example.mdx.

language Поле frontmatter является необязательным, поскольку валидатор может получить язык из маршрута. Если вы объявите его явно, он должен соответствовать языку маршрута файла. Прежде чем отправлять изменения, запустите npm run verify:blog-i18n-completeness из repos/docs для проверки языковых каталогов, файлов-партнеров и языковых метаданных.