多语言模式
2020-10-21
2分钟阅读时长
除了前文的内容管理以及定制 Eureka,Eureka 也支持多语言模式。本文将带领你了解如何构建一个多语言网站。
如果你的区域存在难以访问GitHub的问题,你可以将所有涉及到GitHub的网址替换为[Gitee镜像](https://gitee.com/wangchucheng/hugo-eureka/)。例如将`https://github.com/wangchucheng/hugo-eureka/`替换为`https://gitee.com/wangchucheng/hugo-eureka/`即可。
多语言配置
首先我们需要对配置文件进行一些修改以使用多语言功能。
将config/_default/languages.yaml
中注释的内容取消注释。具体而言,对于默认语言的contentDir
属性,取消其注释并将原来content
文件夹中的所有内容移至content/<language_code>/
文件夹中。
接下来将其他语言的配置取消注释,你可以在其中修改特定配置属性的值,就像示例中的title
一样。
之后我们需要继续修改导航栏的相关内容。首先请在config/_default/
文件夹中新建menus.<language_code>.yaml
文件,并复制menus.yaml
中的内容并进行相应设置。
最后,Eureka 中有一些i18n
字符串。Eureka 目前官方支持的语言为:
- 简体中文
- 英文
由社区提供的语言支持:
- 繁体中文
- 阿拉伯语
- 法语
- 德语
- 意大利语
- 日语
- 韩语
- 波兰语
- 葡萄牙语
- 俄语
- 西班牙语
如果你需要其他语言的翻译,你可以将i18n文件夹复制到项目根目录中,并根据其中的内容添加你语言的翻译,并以相应的语言代码命名。
我们同时欢迎用户为我们提供其他语言的翻译,你可以提交相应的Pull Request给我们。
至此我们完成了多语言的配置。
多语言内容
在前一步,相信你已经将content
文件夹中的内容移动至了content/<language_code>/
文件夹中。多语言内容与内容管理相似,但是新建内容的方式并不相同。接下来将介绍如何在多语言网站中新建内容。
单一语言时,我们新建文件只需要使用如下指令:
hugo new posts/<your_post.md>
而在多语言时则会生成在某一语言中,如果你想指定生成的语言位置,可以使用如下方式:
hugo new content/<language_code>/posts/<your_post.md>
需要注意的是,路径需从content
开始。、