核心概念
多语言支持
了解多语言文档的配置方式与维护要点。
Anydocs 原生支持多语言文档。关键不只是把 `languages` 配出来,还要保证每个启用语言都有页面目录和导航文件,并尽量让同一篇文档在不同语言下复用同一个 `pageId`。
基础配置
{
"defaultLanguage": "zh",
"languages": ["zh", "en"]
}目录要求
每个启用语言都需要自己的页面目录和导航文件。
- `pages/<lang>/`:该语言的页面文件
- `navigation/<lang>.json`:该语言的导航树
- `defaultLanguage`:决定根入口默认落到哪种语言
维护建议
如果同一篇内容有多语言版本,建议在不同语言之间保持一致的 `pageId`,这样语言切换器更容易正确跳转到对应页面。slug 可以按语言分别调整,但要保证导航引用与页面文件同步。