Zola v0.17.2主题优雅本地化实现方案咨询

针对你的需求（仅本地化而非多语言站点，Zola v0.17.2），以下是比data目录单文件更优雅的实现方式：

1. 标准化语言文件结构+全局加载 #

首先规整语言文件的存放路径，统一放在data/i18n/下，命名为en.toml、de.toml，文件内用层级结构管理翻译项，避免扁平结构混乱：

# data/i18n/en.toml
[home]
title = "Welcome"
subtitle = "This is my site"

[nav]
home = "Home"
about = "About"

[button]
read_more = "Read More"

然后在base.html顶部全局加载当前语言包，通过config.toml的配置项指定默认语言，避免重复加载：

{# base.html #}
{% set lang = config.extra.default_language | default(value="en") %}
{% set i18n = load_data(path="data/i18n/" ~ lang ~ ".toml") %}

2. 用Tera宏封装翻译调用 #

创建macros/i18n.html宏文件，把翻译调用封装成复用宏，简化模板里的调用代码：

{# macros/i18n.html #}
{% macro t(key) %}
  {% set keys = key | split(pat=".") %}
  {% set value = i18n %}
  {% for k in keys %}
    {% set value = value[k] %}
  {% endfor %}
  {{ value | default(value=key) }}
{% endmacro %}

在base.html里导入这个宏：

{% import "macros/i18n.html" as i18n_macros %}

之后在任意模板里调用翻译就非常简洁：

<h1>{{ i18n_macros.t("home.title") }}</h1>
<a href="/about">{{ i18n_macros.t("nav.about") }}</a>

3. 扩展：支持手动切换语言（可选） #

如果需要让用户手动切换语言，可以通过URL参数结合模板逻辑实现：

{# base.html 更新语言加载逻辑 #}
{% set lang = get_query_param(name="lang") | default(value=config.extra.default_language) %}
{% set i18n = load_data(path="data/i18n/" ~ lang ~ ".toml") %}

然后在页面添加语言切换按钮：

<div class="lang-switcher">
  <a href="{{ current_url | replace_query_param(name="lang", value="en") }}">EN</a>
  <a href="{{ current_url | replace_query_param(name="lang", value="de") }}">DE</a>
</div>

这种方式既保留了data文件的灵活性，又通过宏和标准化结构让模板代码更干净易维护，完全适配你当前的Zola版本，不需要依赖Fluent。

内容的提问来源于stack exchange，提问作者tweitzel