多语言支持(Multi-language)

为页面框架、文章添加多国语言支持,也叫"国际化"。

官方文档:

页面框架"国际化"

首先,需要在 i18n/ 目录中定义多语言的显示内容。 (这些内容一般由主题项目提供)

i18n/
├── en.toml (默认)
└── zh-cn.toml <---- 新增

e.g. docsy/i18n/zh-cn.toml

1[ui_pager_prev]
2other = "上一页"
3
4[ui_pager_next]
5other = "下一页"
6
7[ui_read_more]
8other = "更多"

然后,在配置文件中更改 defaultcontentlanguage 配置设置。 (默认en

1defaultcontentlanguage: zh-cn

最后,通过调用模板函数 {{ T "ui_pager_prev" }} 就能得到当前环境的框架文本。

文章内容"国际化"

https://www.docsy.dev/docs/language/
https://before80.github.io/docsy_docs_with_hugo/docs/Multi-languageSupport/

1content/en/

站点检索"国际化"

设置 languagecode 配置有利于浏览器和搜索引擎识别站点语言。

它的作用:

  1. 改变内部 RSS 模板中的 <language> 元素
  2. 改变内部别名模板中 <html> 元素的 lang 属性

取值参考: HTML Language Code Reference

Last modified November 4, 2023: Correcting content dir (da1a055)