国际化
自 v1.2.0 版本起,H2O-ac
开始支持国际化,并且可以进行轻松实现全局和单页面的分别控制。
字段数据
国际化的字段数据存储在 /_data/locales/
文件夹中,分别以通用国际语言命名方式命名语言文件名,以下为对应表:
文件名 | 对应语言 |
---|---|
zh-Hans.yml | 中文简体 |
zh-Hant.yml | 中文繁体 |
en.yml | 英文 |
ja.yml | 日文 |
内容主要包括封面(cover
)、侧边栏(panel
)、底部(footer
)、文章页(post
)、归档页(archives
)、分类页(categories
)和语言(langs
),具体请查看 源代码。
快速使用
推荐启用所有可能会用到的语言列表,并设置默认语言为最常用语言。
yaml
languages: ['zh-Hans', 'zh-Hant', 'en', 'ja'] # 国际化语言支持列表
default_lang: 'zh-Hans' # 默认语言
如果想要写非默认语言的文章页或单独页面,请在元信息中声明该页面语言,如下声明为英文页面。
yaml
lang: en
如果存在多语言的相同页面(即相同内容的不同语言版本页面),可以在元信息中声明如下来提示页面还存在其他语言版本。
yaml
langs: [en, zh-Hans]
由于目前页面链接会自动生成,所以不同语言页面的访问链接必须按照固定模式设定,否则就访问 404。
比如主页的链接为 /index.html
:
- 如果默认语言为中文简体,那么英文主页的链接是
/en/index.html
,中文繁体主页的是/zh-Hant/index.html
。 - 如果默认语言为英文,那么中文简体主页的链接是
/zh-Hans/index.html
。