如何实现支持Jinja模板代码的Jinja2+Gettext模板翻译方案？

当然可以实现这种需求，核心思路是结合Gettext的占位符机制与Jinja2的模板渲染能力，针对不同场景有以下几种可行方案：

方案1：将Jinja渲染结果作为Gettext占位符参数传递 #

把需要动态生成的模板逻辑（比如自定义函数调用）先渲染成最终内容，再作为参数传入翻译字符串。这种方式适合逻辑独立于翻译文本结构的场景：

{# 模板代码 #}
{{ _("Watch the %(video_link)s to learn how sprints work.") % {
    "video_link": pycon_link("PyCon US 'What is a sprint?' video")
} }}

翻译时，译者只需关注占位符%(video_link)s的位置，无需理解背后的Jinja逻辑，最终渲染时会自动替换为函数生成的内容。

方案2：直接在Jinja {% trans %}块中嵌入模板表达式 #

Jinja2的{% trans %}原生支持在翻译块内嵌入模板变量和函数调用，配合jinja2.ext.i18n扩展，Gettext可以正确识别并提取翻译文本（忽略模板表达式部分）：

{# 模板代码 #}
{% trans %}
Watch the {{ pycon_link("PyCon US 'What is a sprint?' video") }} to get detailed explanations about sprints.
{% endtrans %}

配置要点： #

• 确保Jinja环境启用jinja2.ext.i18n扩展
• 使用支持Jinja语法的Gettext提取工具（比如jinja2-gettext-extractor），避免把{{ ... }}当成普通文本提取

方案3：拆分翻译单元+组合渲染 #

如果复杂模板逻辑需要与翻译文本深度绑定（比如动态内容的文本本身也需要翻译），可以将翻译拆分为多个独立单元，再在模板中组合：

{# 模板代码 #}
{{ _("Watch the") }} 
{{ pycon_link(_("PyCon US 'What is a sprint?' video")) }} 
{{ _("to learn everything about sprints.") }}

这种方式既保证了动态内容里的文本可被翻译，又能完整保留Jinja函数的逻辑，适合需要精细化控制翻译内容的场景。

注意事项 #

• 若自定义函数返回HTML内容（比如链接），确保函数内部已处理安全问题（或返回Markup对象），避免额外使用|safe过滤器引发XSS风险
• 提取翻译时，需配置工具正确识别Jinja语法，避免误提取模板表达式

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