mirror of
https://github.com/imfing/hextra.git
synced 2025-08-24 11:06:36 -04:00
ec007d73c0
* docs(blog): prepare for v0.10 release post * Update v0.10.md * Update v0.10.md to refine upgrade instructions and enhance blog features. Added synchronized tab switching and pagination controls, while improving the search experience and table of contents navigation. * Enhance v0.10 release documentation with detailed upgrade instructions and migration guide. Added Tailwind theme variable customization section and clarified breaking changes. Improved clarity on CSS class prefix changes for better user experience. * Update v0.10.md to enhance upgrade instructions, clarify breaking changes, and improve overall readability. Adjusted formatting for consistency and added details on asset management and user experience improvements. * Add notable new features to v0.10.md, including dropdown menu support, enhanced search experience, and blog list pagination. Updated FlexSearch upgrade details for clarity and improved migration guide by removing redundant breaking change notes. * chore: update zh-cn translation * chore: update ja translation * chore: update fa and ja translations * chore: prepare release
83 lines
2.3 KiB
Markdown
83 lines
2.3 KiB
Markdown
---
|
||
title: "多语言支持"
|
||
weight: 1
|
||
prev: /docs/advanced
|
||
---
|
||
|
||
Hextra 支持使用 Hugo 的[多语言模式](https://gohugo.io/content-management/multilingual/)创建多语言网站。
|
||
|
||
<!--more-->
|
||
|
||
## 启用多语言功能
|
||
|
||
要使网站支持多语言，我们需要在站点配置文件中指定支持的语言：
|
||
|
||
```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"}
|
||
documentation: Documentation
|
||
blog: Blog
|
||
```
|
||
|
||
## 翻译字符串
|
||
|
||
要翻译其他位置的字符串，需要将翻译添加到对应的 i18n 文件中：
|
||
|
||
```yaml {filename="i18n/fr.yaml"}
|
||
readMore: Lire la suite
|
||
```
|
||
|
||
主题中使用的字符串列表可以在 `i18n/en.yaml` 文件中找到。
|
||
|
||
## 延伸阅读
|
||
|
||
- [Hugo 多语言模式](https://gohugo.io/content-management/multilingual/)
|
||
- [Hugo 多语言第一部分：内容翻译](https://www.regisphilibert.com/blog/2018/08/hugo-multilingual-part-1-managing-content-translation/)
|
||
- [Hugo 多语言第二部分：字符串本地化](https://www.regisphilibert.com/blog/2018/08/hugo-multilingual-part-2-i18n-string-localization/) |