74 lines
2.1 KiB
Markdown
74 lines
2.1 KiB
Markdown
---
|
||
title: "多语言"
|
||
weight: 1
|
||
prev: /docs/advanced
|
||
---
|
||
|
||
Hextra 支持使用 Hugo 的[多语言模式](https://gohugo.io/content-management/multilingual/) 创建多语言的网站。
|
||
|
||
<!--more-->
|
||
|
||
## 启用多语言支持
|
||
|
||
为了使我们的网站支持多语言，我们需要告诉 Hugo 需要支持的语言。 在站点配置文件中添加：
|
||
|
||
```yaml {filename="hugo.yaml"}
|
||
defaultContentLanguage: en
|
||
languages:
|
||
en:
|
||
languageName: English
|
||
weight: 1
|
||
fr:
|
||
languageName: Français
|
||
weight: 2
|
||
ja:
|
||
languageName: 日本語
|
||
weight: 3
|
||
```
|
||
|
||
## 按文件名管理翻译
|
||
|
||
Hugo 支持按文件名管理翻译。例如，如果我们有一个英文文件 `content/docs/_index.md`，我们可以创建一个翻译为法语的文件 `content/docs/_index.fr.md`。
|
||
|
||
{{< filetree/container >}}
|
||
{{< filetree/folder name="content" >}}
|
||
{{< filetree/folder name="docs" state="open" >}}
|
||
{{< filetree/file name="_index.md" >}}
|
||
{{< filetree/file name="_index.fr.md" >}}
|
||
{{< filetree/file name="_index.ja.md" >}}
|
||
{{< /filetree/folder >}}
|
||
{{< /filetree/folder >}}
|
||
{{< /filetree/container >}}
|
||
|
||
注意：Hugo 还支持[按内容目录管理翻译](https://gohugo.io/content-management/multilingual/#translation-by-content-directory)。
|
||
|
||
## 翻译菜单项
|
||
|
||
要翻译导航栏中的菜单项，我们需要设置 `identifier` 字段：
|
||
|
||
```yaml {filename="hugo.yaml"}
|
||
menu:
|
||
main:
|
||
- identifier: documentation
|
||
name: Documentation
|
||
pageRef: /docs
|
||
weight: 1
|
||
- identifier: blog
|
||
name: Blog
|
||
pageRef: /blog
|
||
weight: 2
|
||
```
|
||
|
||
## 翻译字符串
|
||
|
||
要翻译其他地方的字符串，我们需要将翻译添加到相应的 `i18n` 文件中：
|
||
|
||
```yaml {filename="i18n/fr.yaml"}
|
||
readMore: Lire la suite
|
||
```
|
||
|
||
## 更多参考
|
||
|
||
- [Hugo Multilingual Mode](https://gohugo.io/content-management/multilingual/)
|
||
- [Hugo Multilingual Part 1: Content translation](https://www.regisphilibert.com/blog/2018/08/hugo-multilingual-part-1-managing-content-translation/)
|
||
- [Hugo Multilingual Part 2: Strings localization](https://www.regisphilibert.com/blog/2018/08/hugo-multilingual-part-2-i18n-string-localization/)
|