ブログの RSS フィードとローカリゼーションのメンテナンス

HagiCode ドキュメントブログでは、デスクトップ言語セレクターに合わせた言語別 RSS フィードを公開しています。必要な言語のフィードだけを購読してください。

範囲	RSS URL
簡体字中国語	`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 も引き続き提供します。

言語規則

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 言語ディレクトリ、対応するファイル、および言語メタデータを確認します。