已发布的站点可以提供多种语言的文档。访客从公共站点选择语言,而原始语言仍然可用。
配置语言
打开 发布 → 站点设置。
选择站点的原始语言。
添加访客应能选择的其他语言。
保存设置并发布或更新相关文档。
原始语言始终包含在内,且不会进行机器翻译。对于同时服务中文读者的英文文档站点,请将 英语 保留为原始语言,并启用 简体中文 (zh)。您还可以启用 繁體中文 (zh-TW) 作为单独的翻译;它不被视为与简体中文相同的变体。
访客所见
当站点提供至少两种语言时,语言菜单会出现。访客在浏览站点时可以切换语言。Dokki 使用 lang 查询参数,将其保留在内部导航链接中,并记住选择以便以后访问同一站点。在首次访问且没有保存选择时,Dokki 可以选择与浏览器语言匹配的已启用语言。
例如,?lang=zh 选择简体中文,?lang=zh-TW 选择繁体中文。不支持或未启用的语言不会生效。如果请求的翻译尚未就绪,则显示原始内容,而不是在页面请求期间生成翻译。
翻译更新时
在您发布文档或添加语言后,Dokki 会在后台排队翻译,因此可能需要短暂时间才能显示。添加语言会回填站点已发布的文档。后续的源编辑不会更改公开或翻译页面,直到您发布新的冻结版本。
文档更新后,请至少验证同一文档的原始英文页面和简体中文页面。检查标题、正文、面包屑、侧边栏链接、上一页/下一页链接以及页面之间的导航。如果启用了繁体中文,请使用 ?lang=zh-TW 重复检查。
翻译内容
文档标题和正文内容。
受支持的首页和导航文本。
首页标题、描述、文档名称和摘要。
当当前翻译可用时,面包屑和导航标签。
表格和 Artifacts 中的结构化内容可能无法像文档文本那样翻译。在提供翻译站点之前,请单独审查这些资源。
搜索和语言链接
对于文档页面,Dokki 仅宣传当前已发布内容的缓存翻译。准备好的翻译页面会获得带有语言查询参数的自己的规范 URL,并且页面会宣传语言替代方案。缓存未命中时保持原始页面的规范,以免搜索引擎被发送到重复的未翻译内容。
通过及时发布重要的源更新,保持原始语言和翻译页面的一致性。不要仅仅因为语言出现在站点设置中就认为语言推出已完成:打开代表性的公共 URL 并验证当前翻译是否已完成处理。
