部落格 RSS 提要和本地化維護

HagiCode 文件部落格提供與桌面語言選擇器一致的語言 RSS 訂閱源。您可以按需訂閱特定語言的貼文。

適用範圍	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 作為桌面端規範代碼的等價入口。

語言規則

RSS 產生在過濾之前標準化每個部落格文章的語言值：

• 如果貼文明確設定 language 在 frontmatter 中，它被標準化為桌面規範代碼： 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 檢查語言目錄、對應檔案和語言元資料。