作为一名资深安企CMS（AnQiCMS）网站运营人员，我深知内容在网站运营中的核心地位，尤其在全球化浪潮下，多语言内容的快速切换对用户体验和市场拓展至关重要。AnQiCMS 提供了强大而简洁的多语言支持机制，其核心在于灵活运用翻译标签 {% tr %} 来实现模板内容的快速多语言切换。
AnQiCMS 多语言支持的基石
AnQiCMS 的设计理念之一便是支持多语言内容切换与显示，旨在帮助企业无缝拓展国际市场，让内容可以直接触达不同语言用户。这种全球化布局的能力，体现在其模板引擎的精妙设计和后台管理系统的灵活配置上。通过将模板中的固定文本与独立的语言包关联起来，AnQiCMS 实现了前端内容的快速动态翻译，极大地提升了网站的适应性和用户体验。
核心机制：翻译标签 {% tr %}
在 AnQiCMS 中，实现模板内容多语言切换的核心工具是翻译标签 {% tr %}。这个标签的作用是将模板中原本硬编码的文本，替换为对应语言包中定义的翻译文本。它的使用方式直观而高效：{% tr "你的翻译键" %}。
当系统解析到一个 {% tr "someKey" %} 标签时，它会根据当前网站的语言设置，到相应的语言包文件中查找名为 “someKey” 的条目，并将其值作为输出。这种机制将模板结构与具体语言内容解耦，使得维护和更新多语言版本的内容变得异常简单。
构建多语言模板文件：Locales 目录结构
为了让 {% tr %} 标签能够正常工作，我们首先需要为不同语言准备好翻译文件。AnQiCMS 采用了一种清晰的目录结构来管理这些语言文件。在模板的根目录下，需要创建一个名为 locales 的文件夹。在这个 locales 文件夹内，为每种支持的语言创建一个子文件夹，文件夹名称通常是语言的代码（例如，en-us 代表美式英语，zh-cn 代表简体中文）。在每个语言子文件夹中，可以创建一个或多个 .yml 格式的语言包文件，例如 default.yml。
一个典型的多语言文件结构可能如下所示：
./locales
├── en-us
│ └── default.yml
├── ja
│ └── default.yml
└── zh-cn
└── default.yml
default.yml 文件内部则以键值对的形式定义翻译内容。例如，在 zh-cn/default.yml 中，我们可能会有："yourLocation": "您的位置"，而在 en-us/default.yml 中对应地写成："yourLocation": "Your location"。这样，当模板中调用 {% tr "yourLocation" %} 时，系统就会根据当前语言设置，自动加载并显示“您的位置”或“Your location”。
后台语言包设置与前端切换
AnQiCMS 的后台提供了“默认语言包”设置，位于“全局功能设置”中。管理员可以在这里选择网站的默认语言，例如中文或英文。这个设置会影响系统内置的展示信息，确保后台界面和一些系统级的提示以所选语言显示。然而，对于我们使用 {% tr %} 标签来定义的模板内容，其切换机制则更为动态。
为了让访问者能够自主选择语言，我们需要在前端模板中添加语言切换功能。{% languages %} 标签为此提供了便利。通过使用这个标签，我们可以获取所有已配置的多语言站点列表，并为每个语言生成一个切换链接。例如：
{%- languages websites %}
{%- if websites %}
<div>
<span>切换语言：</span>
{%- for item in websites %}
<a href="{{item.Link}}">
{%- if item.LanguageIcon %}
<img src="{{item.LanguageIcon}}" />
{%- else %}
{{item.LanguageEmoji}}
{% endif %}
{{item.LanguageName}}
</a>
{%- endfor %}
</div>
{%- endif %}
{%- endlanguages %}
当用户点击这些链接时，网站会加载对应语言版本的页面，此时 {% tr %} 标签将根据新的语言设置，从相应的语言包文件中提取并显示翻译后的文本，从而实现模板内容的快速多语言切换。此外，{% languages %} 标签也支持生成 hreflang 属性，这对国际化 SEO 至关重要，能够帮助搜索引擎理解不同语言版本的页面内容，提升网站在全球范围内的可见度。
总结
AnQiCMS 通过 {% tr %} 翻译标签与结构化的语言包文件相结合，配合后台的语言设置和 {% languages %} 前端切换功能，提供了一套完善且高效的模板内容多语言切换解决方案。这种设计不仅实现了模板与内容的分离，简化了多语言网站的维护工作，还确保了用户在不同语言版本之间切换时，能够获得流畅而一致的体验，为网站的全球化运营奠定了坚实基础。
常见问题解答 (FAQ)
1. {% tr %} 标签只能翻译模板中的固定文本吗？文章内容如何进行多语言展示？
{% tr %} 标签主要用于翻译模板文件中硬编码的、不随文章内容变化的固定文本，例如导航菜单项、按钮文字、页面标题的辅助信息等。对于文章或产品等动态内容的多语言展示，AnQiCMS 通常通过多站点管理功能实现。您可以为每种语言设置一个独立的站点，每个站点维护自己的内容，但共享一套模板，并通过 {% tr %} 标签处理模板的固定文本翻译。
2. 如何确保多语言切换时，页面的 URL 也能对应变化，以利于 SEO？
AnQiCMS 的多语言站点管理与伪静态规则结合得很好。当您通过 {% languages %} 标签创建语言切换链接时，每个链接都会指向对应语言站点的 URL。同时，系统支持配置 hreflang 标签（{% languages websites %}{% for item in websites %}<link rel="alternate" href="{{item.Link}}" hreflang="{{item.Language}}">{% endfor %}{% endlanguages %}），这有助于搜索引擎理解不同语言版本的页面关系，从而优化国际化 SEO 表现。
3. 如果语言包文件中的翻译键缺失了，{% tr %} 标签会如何表现？
如果 {% tr "yourKey" %} 标签所对应的翻译键 yourKey 在当前语言的 .yml 文件中不存在，AnQiCMS 通常会默认直接显示该键名本身（即 yourKey），或者在特定配置下，回退到默认语言的翻译。这提醒我们在添加新翻译键时，务必确保所有目标语言的语言包文件都已包含相应的翻译，以避免出现未翻译的键名。