AnQiCMS 如何在模板中实现多语言站点的切换链接显示，并设置`hreflang`？

在AnQiCMS中构建多语言网站，并提供便捷的语言切换功能以及正确的SEO设置，是拓展国际市场和提升用户体验的关键一步。作为一个基于Go语言开发的现代化内容管理系统，AnQiCMS在这方面提供了强大而灵活的支持，让内容运营者能够轻松驾驭全球化的内容发布需求。

理解AnQiCMS的多语言能力

AnQiCMS在设计之初就充分考虑了全球化内容推广的需求，其内置的多语言支持功能是构建国际化网站的核心优势之一。这意味着我们不仅可以发布不同语言版本的内容，还能在模板层面实现语言的切换和对应的hreflang设置。

在AnQiCMS的后台，我们可以通过“多站点管理”功能创建多个语言版本的站点，每个站点可以拥有独立的域名、子域名或子目录。同时，在“全局功能设置”中，我们可以为每个站点指定其默认语言包，例如中文、英文等，这会影响系统内置文字的显示。

更进一步，AnQiCMS还支持模板层面的多语言内容翻译。通过在模板目录下创建locales文件夹，并按照语言代码（如en-us、zh-cn）组织default.yml等语言文件，我们可以使用{% tr "yourKey" %}这样的翻译标签来显示不同语言的对应文本。例如，如果zh-cn/default.yml中定义了"yourLocation": "您的位置"，en-us/default.yml中定义了"yourLocation": "Your location"，那么在中文站点将显示“您的位置”，英文站点则显示“Your location”，这让模板的国际化变得非常高效。

在模板中实现多语言切换链接

要在网站前端为用户提供一个方便的语言切换入口，我们需要在模板中调用AnQiCMS提供的特定标签来获取所有已配置的语言站点信息。这通常会在网站的页眉、页脚或侧边栏等显眼位置进行。

AnQiCMS提供了一个名为languages的模板标签，它可以获取后台配置的所有多语言站点列表。这个标签不需要任何参数，直接调用即可获得一个包含所有语言站点信息的数组对象。

我们可以像下面这样在模板中使用它来生成语言切换链接：

{%- languages websites %}
{%- if websites %}
<div class="language-switcher">
    <span>切换语言：</span>
    {%- for item in websites %}
    <a href="{{item.Link}}" {% if item.Nofollow == 1 %} rel="nofollow"{% endif %}>
        {%- if item.LanguageIcon %}
        <img src="{{item.LanguageIcon}}" alt="{{item.LanguageName}} Flag" class="language-flag" />
        {%- else %}
        <span class="language-emoji">{{item.LanguageEmoji}}</span>
        {% endif %}
        <span class="language-name">{{item.LanguageName}}</span>
    </a>
    {%- endfor %}
</div>
{%- endif %}
{%- endlanguages %}

在这段代码中，websites是一个数组，item是每次循环中代表一个语言站点的对象。我们可以利用item.Link获取对应语言站点的URL，item.LanguageName获取语言名称（如“简体中文”、“English”），item.LanguageEmoji获取语言对应的Emoji表情，以及item.LanguageIcon获取自定义的语言图标。item.Nofollow属性则可以帮助我们判断是否需要为链接添加nofollow标签，这在某些SEO策略中可能会用到。通过这些字段，我们可以灵活地构建出既美观又实用的语言切换器。

设置hreflang标签以优化SEO

除了为用户提供直观的语言切换功能，对于搜索引擎优化（SEO）而言，正确配置hreflang标签同样至关重要。hreflang标签告诉搜索引擎，你的网站内容有多个语言或地区版本，有助于搜索引擎向正确的用户展示最相关的语言版本，避免重复内容问题，并提升国际SEO表现。

hreflang标签通常放置在HTML文档的<head>区域。AnQiCMS同样利用languages标签来帮助我们轻松生成这些SEO友好的元数据。

在你的模板（通常是基础布局文件，如base.html）的<head>部分，你可以添加如下代码来自动生成hreflang链接：

<head>
    {# 其他head内容，如meta标签、title等 #}
    {%- languages websites %}
    {%- for item in websites %}
    <link rel="alternate" href="{{item.Link}}" hreflang="{{item.Language}}">
    {%- endfor %}
    {%- endlanguages %}
</head>

在这里，我们再次使用了languages标签获取所有语言站点。对于每个item（语言站点），我们使用item.Link作为href属性的值，提供对应语言站点的URL。而hreflang属性的值则来自于item.Language字段，它会返回标准的语言代码（例如zh-cn、en-us）。这样，搜索引擎就能准确地理解不同语言版本之间的关系了。

实践中的考量与建议

  1. 后台站点配置：所有这些灵活的切换功能都依赖于AnQiCMS后台“多站点管理”模块的正确配置。你需要为每种目标语言创建一个独立的站点，并配置好它们的域名、子域名或子目录，以及对应的默认语言包。只有后台配置完善，前台的languages标签才能正确获取到所有语言版本的信息。

  2. hreflang与x-default：除了为每种语言设置hreflang，如果你的网站有一个不针对特定语言或地区（例如英语国际版）的默认版本，建议添加一个x-default的hreflang标签。AnQiCMS的languages标签目前提供的是针对每个已配置语言站点的hreflang输出，如果需要x-default，可能需要额外判断并手动添加。例如：

    <link rel="alternate" href="https://yourwebsite.com/en/" hreflang="x-default">

    这里的https://yourwebsite.com/en/应指向你的通用默认语言版本。

  3. 模板文件位置：语言切换链接通常放置在header.html或footer.html等公共模板文件中，确保每个页面都能访问到。而hreflang标签则必须位于所有页面的<head>标签内。

通过以上步骤，你可以充分利用AnQiCMS的多语言支持功能，不仅为用户提供无缝的语言切换体验，还能通过正确的hreflang设置，为你的网站在国际搜索引擎中赢得更好的可见度和排名。

常见问题 (FAQ)

Q1: 在AnQiCMS后台，如何配置多个语言版本的站点？ A1: 要配置多个语言版本的站点，你需要前往AnQiCMS后台的“功能管理”或“多站点管理”模块。在这里，你可以添加新的站点，为每个站点设置独立的域名（如example.com）、子域名（如en.example.com）或子目录（如example.com/en/）。同时，你还需要为每个站点指定其默认语言包（如中文、英文）和使用的模板。

Q2: 如果我的网站只有一个域名，如何实现多语言？ A2: 即使只有一个主域名，AnQiCMS也支持通过“多站点管理”实现多语言。你可以选择将不同语言版本配置为子目录形式（例如example.com/en/用于英文，example.com/fr/用于法文）。在后台创建站点时，将网站地址设置为对应的子目录URL即可。AnQiCMS会自动处理路由和链接生成，确保不同语言版本的内容在各自的子目录下展示。

Q3: hreflang标签和{% tr %}翻译标签有什么区别，它们各自的作用是什么？ A3: hreflang标签和{% tr %}翻译标签虽然都与多语言相关，但它们的作用和目标受众不同：

  • hreflang标签 主要面向搜索引擎。它是一种SEO元数据，用于告诉搜索引擎你的网页有多个语言或地区版本。这有助于搜索引擎将正确语言的内容展示给相应地区的用户，避免因内容相似导致的重复内容惩罚，并优化国际搜索排名。
  • {% tr "key" %}翻译标签 主要面向网站访客和内容运营者。它用于在模板文件中实现静态文本内容的翻译。例如，导航