i18n
internationalization 的缩写,即国际化。
开始之前,你需要
- 在文档里遇到不认识的 Hugo 术语时查阅
读完之后你能
- 能分清界面翻译与内容翻译,并在页面上出现 key 或英文原文时知道去哪一层排查
接着读:多语言
为什么重要
在 Hugo 里 i18n 同时指两样东西:项目根下的 i18n 目录(放界面字符串的翻译表)和模板里的 i18n 函数(按 key 取当前语言的文案)。它负责的是界面文案,而页面正文的翻译靠语言维度和按语言组织的 content/ 目录,两者互不替代。最常见的症状是页面上直接显示未翻译的 key 或英文原文:前者说明翻译表里缺少该语言的条目或 key 拼错,后者说明内容目录里没有对应语言的版本或语言没启用。