Anydocs Documents
核心概念

多语言支持

了解多语言文档的配置方式与维护要点。

Anydocs 原生支持多语言文档。关键不只是把 `languages` 配出来,还要保证每个启用语言都有页面目录和导航文件,并尽量让同一篇文档在不同语言下复用同一个 `pageId`。

基础配置

{
  "defaultLanguage": "zh",
  "languages": ["zh", "en"]
}

目录要求

每个启用语言都需要自己的页面目录和导航文件。

  • `pages/<lang>/`:该语言的页面文件
  • `navigation/<lang>.json`:该语言的导航树
  • `defaultLanguage`:决定根入口默认落到哪种语言

维护建议

如果同一篇内容有多语言版本,建议在不同语言之间保持一致的 `pageId`,这样语言切换器更容易正确跳转到对应页面。slug 可以按语言分别调整,但要保证导航引用与页面文件同步。