如何实现网站内容的多语言切换和显示？

在构建面向全球用户的网站时，提供多语言支持是至关重要的。安企CMS（AnQiCMS）深知这一需求，内置了强大的多语言切换和显示功能，帮助网站运营者轻松实现内容的国际化。本文将详细探讨如何在安企CMS中配置和实现网站内容的多语言功能，让您的网站能够更好地服务不同语种的用户。

安企CMS 的多语言支持概览

安企CMS 的设计初衷之一就是支持多语言内容的切换和显示，这使得它成为拓展国际市场的理想工具。通过系统提供的多语言功能，您可以让网站内容直接面向全球用户，提升用户体验，并为SEO优化和内容推广带来显著优势。安企CMS 在后台提供了“默认语言包”设置，这主要用于系统界面的语言显示。而对于网站前端内容的呈现，则需要结合模板标签和内容管理策略来共同实现。

内容的多语言准备

要实现网站的多语言显示，核心在于为每种语言创建相应的内容。安企CMS 不会自动翻译您的文章或产品描述，因此您需要为每种目标语言手动输入或导入对应的内容。

  1. 创建多语言内容：
    • 文章和产品：在“内容管理”模块下，您可以为每种语言创建独立的文章（文档）和产品。例如，您可以有一篇“关于我们”的中文文章，同时再创建一篇“About Us”的英文文章。
    • 分类和标签：同样，网站的分类和标签也需要为每种语言分别创建。您可以设置“中文文章”分类和“English Articles”分类，并为它们各自下的内容进行归类。
    • 单页面：像“联系我们”、“隐私政策”等单页面，也需要创建不同语言的版本。

这种内容管理方式确保了每种语言的内容都能精准表达，避免了机器翻译可能带来的歧义或不自然。

多语言切换与显示的前端实现

内容准备就绪后，下一步就是在网站前端实现多语言的显示和切换功能。这主要通过安企CMS 的模板标签和特定的文件结构来完成。

1. 翻译模板中的固定文本

网站模板中往往包含一些不属于文章或产品数据库的固定文本，例如导航菜单项、页脚版权信息、“您的位置”等提示性文字。这些文本可以通过安企CMS 的“翻译标签”({% tr %}) 来实现多语言。

  • 配置翻译文件： 在您的模板目录下，创建一个名为 locales 的文件夹。在该文件夹内，为每种目标语言创建一个子文件夹，例如 en-us（英文）、zh-cn（中文）、ja（日文）等。在每个语言文件夹内，创建一个 default.yml 文件。

    例如，locales/zh-cn/default.yml 可以包含：

    "yourLocation": "您的位置"
"home": "首页"
"aboutUs": "关于我们"

    而 locales/en-us/default.yml 则包含：

    "yourLocation": "Your Location"
"home": "Home"
"aboutUs": "About Us"

  • 使用翻译标签： 在模板文件中，凡是需要进行多语言切换的固定文本，都可以使用 {% tr "键名" %} 的形式调用。例如：

    <nav>
    <a href="/">{% tr "home" %}</a>
    <a href="/about-us">{% tr "aboutUs" %}</a>
    <!-- 其他导航项 -->
</nav>

    当用户切换到不同的语言时，系统会根据当前语言加载对应的 default.yml 文件，并显示相应的翻译文本。

2. 实现语言切换器

网站需要一个显眼的语言切换器，允许用户方便地选择自己偏好的语言。安企CMS 提供了 {% languages %} 标签来获取所有已配置的多语言站点列表，进而构建切换器。

  • 使用 {% languages %} 标签： 您可以在 base.html 或页面头部等位置添加如下代码，以显示一个简单的语言切换菜单： 
    
{%- languages websites %}
{%- if websites %}
<div class="language-switcher">
    <span>选择语言：</span>
    {%- for item in websites %}
    <a href="{{item.Link}}">
        {%- if item.LanguageIcon %}
        <img src="{{item.LanguageIcon}}" alt="{{item.LanguageName}}"/>
        {%- else %}
        {{item.LanguageEmoji}}
        {% endif %}
        {{item.LanguageName}}
    </a>
    {%- endfor %}
</div>
{%- endif %}
{%- endLanguages %}
    这段代码会遍历所有已配置的语言，并为每个语言生成一个带有链接的选项。item.Link 会自动指向当前页面在对应语言下的URL，前提是您的网站结构和内容在不同语言间建立了正确的关联。

3. 搜索引擎优化（SEO）考虑：Hreflang

对于多语言网站，hreflang 标签是告诉搜索引擎您的网站有多个语言版本，并指明它们所面向的地理区域或语言的重要标记。这有助于避免重复内容问题，并确保搜索引擎向用户展示最相关的语言版本。

  • 在 <head> 中添加 hreflang 标签： 利用 {% languages %} 标签，您可以在网站的 <head> 部分动态生成 hreflang 标签： 
    
{%- languages websites %}
{%- for item in websites %}
<link rel="alternate" href="{{item.Link}}" hreflang="{{item.Language}}">
{%- endfor %}
{%- endLanguages %}
    其中，item.Link 是当前页面在特定语言下的完整 URL，而 item.Language 则是该语言的 ISO 639-1 格式代码（例如 zh-cn、en-us）。

运维与**实践

  • 内容管理的一致性：确保每种语言的内容都保持更新和一致。翻译质量至关重要，专业的本地化服务可以帮助您提供高质量的多语言内容。
  • URL 结构：规划清晰的多语言URL结构（例如：yourdomain.com/en/、en.yourdomain.com 或 yourdomain.com?lang=en）。安企CMS 的伪静态规则 (help-plugin-rewrite.md) 可以帮助您构建友好的URL。
  • 测试与用户体验：发布前务必对所有语言版本进行全面测试，确保内容显示正确、切换流畅、功能正常。关注不同语言用户的文化习惯，优化本地化体验。
  • 多站点管理：如果您的多语言策略是使用完全独立的域名来区分语言，例如 example.com (英文) 和 `