更改字体¶

Material for MkDocs 支持国际化(i18n)，并提供了超过 60 种语言的模板变量和标签翻译。此外，如果可用的话，站点搜索可以配置为使用特定语言的词干提取器。

配置¶

站点语言¶

您可以通过以下方式在 mkdocs.yml 中设置网站语言：

theme:
  language: en

网站语言选择器¶

如果您的文档提供多种语言版本，则可以将指向这些语言的语言选择器添加到页眉中。可以通过 mkdocs.yml 定义替代语言。

extra:
  alternate:
    - name: English
      link: /en/ 
      lang: en
    - name: Deutsch
      link: /de/
      lang: de

效果如下图所示：

方向性¶

虽然许多语言都读作 ltr（从左到右），但 Material for MkDocs 还支持 rtl（从右到左）方向性，该方向性是从所选语言推导出来的，但也可以通过以下方式进行设置：

theme:
  direction: ltr

自定义¶

自定义翻译¶

如果您想自定义某种语言的某些翻译，只需按照主题扩展指南并在 overrides 文件夹中创建一个新的部分。然后，将语言的翻译导入为后备，并仅调整要覆盖的翻译：

overrides/partials/languages/custom.html mkdocs.yml

<!-- Import translations for language and fallback -->
{% import "partials/languages/de.html" as language %}
{% import "partials/languages/en.html" as fallback %} <!-- (1)! -->

<!-- Define custom translations -->
{% macro override(key) %}{{ {
  "source.file.date.created": "Erstellt am", <!-- (2)! -->
  "source.file.date.updated": "Aktualisiert am"
}[key] }}{% endmacro %}

<!-- Re-export translations -->
{% macro t(key) %}{{
  override(key) or language.t(key) or fallback.t(key)
}}{% endmacro %}

Note that en must always be used as a fallback language, as it's the default theme language.
Check the [list of available languages], pick the translation you want to override for your language and add them here.

theme:
  language: custom