Skip to content

国际化

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]

o0COTW.webp

由于目前页面链接会自动生成,所以不同语言页面的访问链接必须按照固定模式设定,否则就访问 404。

比如主页的链接为 /index.html

  • 如果默认语言为中文简体,那么英文主页的链接是 /en/index.html,中文繁体主页的是 /zh-Hant/index.html
  • 如果默认语言为英文,那么中文简体主页的链接是 /zh-Hans/index.html

Released under the MIT License.