2 posts tagged with "i18n"

Fix Docusaurus i18n Links Losing Language Prefix

March 3, 2026 · 3 min read

TL;DR

In Docusaurus i18n sites, using <a href="/docs/xxx"> absolute paths in English pages redirects to Chinese. Solution: Use <Link to="/docs/xxx"> for page components, and relative paths ./xxx in MD documents.

Fix Docusaurus 3.9 Translation File Validation Error

March 1, 2026 · 2 min read

TL;DR

Docusaurus 3.9 has strict requirements for translation file format. Values in code.json and current.json must be { "message": "xxx" } object format, not plain strings or nested objects.

TL;DR​

TL;DR​

TL;DR

TL;DR