如何在AnQiCMS模板中实现多语言内容的切换和显示？
在今天的数字世界里，您的网站可能需要面向全球用户。AnQiCMS 充分理解这一需求，提供了强大的多语言支持功能，让您能够轻松构建和管理多语言网站，从而更好地服务不同国家和地区的用户。那么，如何在 AnQiCMS 的模板中实现多语言内容的切换和显示呢？让我们一步步来探索。
理解 AnQiCMS 的多语言机制：两种“语言”的处理
在 AnQiCMS 中，我们需要区分两种类型的“语言”内容：
- 系统内置及模板静态文字： 这包括后台管理界面的提示信息、模板中固定的导航项（如“首页”、“联系我们”）、页脚版权声明等，这些内容通常不随用户发布的文章而变化。
- 用户发布的内容： 这指的是您的文章、产品、单页面、分类描述等动态内容，它们是网站的核心信息。
AnQiCMS 针对这两种内容提供了不同的处理方式，以确保灵活性和管理效率。
实现系统内置及模板静态文字的切换与显示
为了让您的网站界面元素能够根据用户选择的语言进行切换，AnQiCMS 引入了语言包和翻译标签的机制。
首先，您需要在模板目录下创建一个名为 locales 的文件夹。在这个文件夹中，您可以为每种支持的语言创建一个子文件夹，例如 zh-cn（简体中文）、en-us（英文）等。每个语言子文件夹内再创建一个 default.yml 文件。
以英文为例，目录结构可能是这样：
/template
└── your_template_name
└── locales
├── en-us
│ └── default.yml
└── zh-cn
└── default.yml
在 en-us/default.yml 文件中，您可以这样定义翻译内容：
"homePage": "Home"
"contactUs": "Contact Us"
"yourLocation": "Your Location"
而在 zh-cn/default.yml 中，对应的内容则是：
"homePage": "首页"
"contactUs": "联系我们"
"yourLocation": "您的位置"
在您的模板文件（例如 header.html 或 index.html）中，您就可以使用 {% tr "key" %} 翻译标签来显示这些静态文本了。例如：
<nav>
<a href="/">{% tr "homePage" %}</a>
<a href="/contact.html">{% tr "contactUs" %}</a>
</nav>
<p>{% tr "yourLocation" %}</p>
当用户切换到不同的语言时，AnQiCMS 会根据当前语言设置自动加载相应的 default.yml 文件，并显示对应的翻译文本。
此外，您可以在 AnQiCMS 后台的“全局功能设置”中，找到“默认语言包”选项。这里可以设置当前站点的后台界面和内置提示信息的语言，例如选择“中文”或“英文”。不过请注意，这个设置主要影响系统自身的语言环境，不会直接改变您模板中文章、分类等用户发布内容的语言。
实现用户发布内容的管理与展示
对于文章、产品、单页面等核心内容，AnQiCMS 的设计理念是通过“多站点管理”功能来实现多语言内容的独立管理和显示。这意味着，您通常会为每种语言设置一个独立的站点，例如：
www.yourdomain.com(中文站点)en.yourdomain.com(英文站点)fr.yourdomain.com(法文站点)
这种方法有几个显著的优势：
- 内容独立性： 每种语言的内容完全独立，方便管理和更新，避免混淆。
- SEO 友好： 每个语言版本都有独立的 URL 结构，有利于搜索引擎对不同语言内容的抓取和排名，也便于配置
hreflang标签。 - 灵活性： 不同语言的站点甚至可以使用不同的模板设计，以适应特定文化或市场需求。
在 AnQiCMS 后台的“多站点管理”中，您可以轻松地添加这些独立的语言站点。每个站点都将有自己的内容、分类、标签，甚至管理员账号。这意味着，您需要在每个语言站点中独立发布和管理相应语言的文章、产品等内容。虽然这可能意味着需要重复录入和翻译内容，但却能带来**的灵活性和可维护性。
在模板中提供语言切换器
为了让用户方便地在不同语言版本之间切换，您需要在模板中添加一个语言切换器。AnQiCMS 提供了 {% languages websites %} 标签来获取所有已配置的多语言站点列表。
您可以在模板的头部或页脚等位置，添加如下代码片段来实现语言切换：
{%- languages websites %}
{%- if websites %}
<div class="language-switcher">
<span>切换语言：</span>
{%- for item in websites %}
<a href="{{item.Link}}" title="{{item.Name}}">
{%- if item.LanguageIcon %}
<img src="{{item.LanguageIcon}}" alt="{{item.LanguageName}}" />
{%- else %}
{{item.LanguageEmoji}}
{% endif %}
{{item.LanguageName}}
</a>
{%- endfor %}
</div>
{%- endif %}
{%- endlanguages %}
这段代码会遍历所有已配置的语言站点，并为每个站点生成一个带有语言名称、图标或 Emoji 的链接。用户点击这些链接，就能跳转到相应语言的站点。
此外，为了更好地进行国际化 SEO，强烈建议您在每个页面的 <head> 区域添加 hreflang 标签，指明当前页面对应的其他语言版本。这可以通过以下方式实现：
<head>
{# 其他head内容 #}
{%- languages websites %}
{%- for item in websites %}
<link rel="alternate" href="{{item.Link}}" hreflang="{{item.Language}}">
{%- endfor %}
{%- endlanguages %}
</head>
hreflang 标签会告诉搜索引擎，您的网站有多个语言版本，并指明每个版本的 URL，这对于避免重复内容问题和引导用户访问正确语言版本页面至关重要。
总结
AnQiCMS 通过区分对待系统内置文字和用户发布内容，提供了灵活且高效的多语言解决方案。利用 locales 目录和 {% tr %} 标签可以轻松处理模板静态文本的翻译，而结合强大的“多站点管理”功能，则能为您的核心内容搭建出清晰、独立的各语言版本网站。配合模板中的语言切换器和 hreflang 标签，您的 AnQiCMS 网站将能够无缝地服务全球用户，助力您的业务走向国际。
常见问题 (FAQ)
1. 我可以直接在同一个 AnQiCMS 站点中，为一篇文章提供多个语言版本吗？
AnQiCMS 的核心设计理念是针对多语言内容采用多站点管理。这意味着，通常情况下，您会为每种语言创建独立的站点（例如 en.yourdomain.com 和 fr.yourdomain.com），然后在每个站点中分别发布该语言的文章。虽然可以在同一个文章内容字段中硬编码多种语言文本，并通过前端逻辑判断显示，但这并非推荐的做法，因为它会使得内容管理变得复杂，且不利于 SEO。多站点模式提供了更清晰、更易于维护的解决方案。
2. 如何确保多语言网站的 SEO 效果？
首先，为每种语言提供独立的 URL（例如通过子域名或子目录）是基础。其次，务必在每个页面的 <head> 区域使用 hreflang 标签，明确告知搜索引擎该页面的其他语言版本及对应的 URL。确保每个语言版本的内容都是高质量且唯一的，避免简单机器翻译。同时，针对不同目标语言的市场进行关键词研究和本地化内容优化，并在每个语言版本中配置独立的 TDK（标题、描述、关键词）和伪静态规则。
3. 如果我网站只有少量固定词语需要翻译，不想搭建完整的多语言站点，可以吗？
完全可以。如果您只需要翻译模板中少量固定的词语，而用户发布的核心内容（文章等）依然是单一语言，那么您只需使用 {% tr "key" %} 翻译标签和 locales 语言包机制即可。您可以只创建包含这些固定词语翻译的语言包文件（例如 en-us/default.yml），并在模板中使用