多语言网站

Zola 支持拥有多种语言的网站。

🔗配置

首先,您需要将要支持的语言添加到您的config.toml. 例如:

[languages.fr]
generate_feed = true # there will be a feed for French content
build_search_index = true
taxonomies = [
    {name = "auteurs"},
    {name = "tags"},
]

[languages.fr.translations]
summary = "Mon blog"

[languages.it]
# Italian language doesn't have any taxonomies/feed/search index

[languages.it.translations]
summary = "Mio blog"

# translations for the default language are not prefixed by languages.code
[translations]
summary = "My blog"

注意:默认情况下,不包括中文和日文搜索索引。您可以zola使用cargo build --features search/indexing-ja --features search/indexing-zh. 另请注意,启用中文索引将使二进制文件大小增加约 5 MB,而启用日语索引将使二进制文件大小增加约 70 MB,因为字典非常大。

🔗内容

添加语言后,您就可以开始翻译您的内容了。Zola 使用文件名来检测语言:

  • content/an-article.md: 这将是默认语言
  • content/an-article.fr.md: 这将是法语

如果文件名中的语言代码与其中一种语言或配置的默认语言不对应,则会显示错误。

如果您的默认语言_index.md在目录中有一个,您将需要添加一个_index.{code}.md 具有所需前选项的文件,因为没有语言后备。

🔗输出

Zola 输出翻译后的内容,其基本 URL 为{base_url}/{code}/. path唯一的例外是如果您直接在首页设置翻译页面。