在多语言网站的运营中，确保搜索引擎能够准确理解您的内容所针对的语言和地区，对于提升用户体验和搜索引擎优化（SEO）至关重要。hreflang 标签正是解决这一问题的关键工具。它告诉搜索引擎，您的网站上存在针对不同语言或地区的内容变体，从而避免重复内容问题，并帮助搜索引擎为不同语言用户展示最相关的页面。

AnQiCMS 作为一款支持多语言内容管理系统，已经为实现 hreflang 标签提供了坚实的基础。系统内置的多语言支持功能，允许您轻松创建和管理不同语言版本的内容，而 languages 标签的灵活运用，则让 hreflang 标签的部署变得直观高效。

AnQiCMS 中的多语言能力概览

AnQiCMS 的核心优势之一便是其强大的多语言支持。它不仅允许您为网站配置不同的语言包，更重要的是，您可以针对同一内容创建多个语言版本。例如，一篇产品介绍文章，您可以同时拥有中文版、英文版甚至更多语言版本，并独立进行管理和发布。这种能力是部署 hreflang 标签的前提，因为 hreflang 的本质就是声明这些语言变体之间的关系。

在 AnQiCMS 后台，通常可以在“全局设置”或“内容设置”中找到语言包的相关配置，并为每个站点或内容设置其对应的语言。当多语言内容准备就绪后，下一步就是在网站前端页面中正确地声明这些关系。

如何在 AnQiCMS 网站中实现 hreflang 标签

实现 hreflang 标签，我们需要在网站的 HTML 页面头部 <head> 区域添加 <link> 标签，指明当前页面对应的所有语言变体。在 AnQiCMS 中，这可以通过修改模板文件来完成。

  1. 定位核心模板文件 AnQiCMS 的模板结构通常包含一个用于定义页面公共部分的模板文件，比如 bash.html 或者类似名称的头部（header）文件。这些文件通常位于您当前使用的模板主题目录下的 template 文件夹中。在这个文件中，您可以找到 <head> 区域，这是放置 hreflang 标签的理想位置，因为它会应用于网站的所有页面。

  2. 利用 languages 标签获取多语言站点信息 AnQiCMS 提供了一个名为 languages 的模板标签，专门用于获取当前网站配置的所有多语言站点信息。这个标签在 tag-languages.md 文档中详细介绍，它不需要任何参数，会返回一个包含所有语言站点信息的数组对象。

    您可以这样在模板中使用它：

    {%- languages websites %}
{# 循环遍历所有语言站点 #}
{%- for item in websites %}
    <link rel="alternate" href="{{item.Link}}" hreflang="{{item.Language}}">
{%- endfor %}
{%- endLanguages %}

    这里，websites 是一个临时变量，它包含了每个语言站点的详细信息。在循环中，item 代表了每个具体的语言站点。

    • item.Link：会输出该语言版本的页面链接（URL）。AnQiCMS 会确保这里提供的链接是完整的、绝对路径的 URL，这是 hreflang 标签的要求。
    • item.Language：会输出该语言版本对应的语言代码，通常是 ISO 639-1 格式（例如 en 代表英文，zh 代表中文），也可能包含地区代码（例如 en-US 代表美式英语，zh-CN 代表简体中文）。

  3. 添加 x-default 标签（可选但推荐） 除了为每个语言版本指定 hreflang 标签外，通常还会建议添加一个 x-default 标签。x-default 标签用于指定当用户的浏览器语言与您网站提供的任何特定语言都不匹配时，搜索引擎应该展示的默认页面。这通常是您的主语言页面，或者一个语言选择器页面。

    假设您的主语言是英文，您可以在上述循环之后，再添加一行 x-default 标签：

    <link rel="alternate" href="您的默认/主语言页面的完整URL" hreflang="x-default" />

    这个“默认/主语言页面的完整URL”通常是您在 websites 列表中某个 item.Link 的值。您可以根据您的网站设置，选择其中一个作为 x-default。

完整的模板代码示例

将上述内容整合到您的 <head> 区域，看起来可能像这样：

<!DOCTYPE html>
<html lang="zh-CN"> {# 这里的 lang 属性应与当前页面的实际语言代码一致 #}
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{% tdk with name="Title" siteName=true %}</title>
    <meta name="keywords" content="{% tdk with name="Keywords" %}">
    <meta name="description" content="{% tdk with name="Description" %}">

    {# 其他您的CSS、JS文件引入 #}
    <link href="{% system with name="TemplateUrl" %}/css/style.css" rel="stylesheet">

    {# AnQiCMS 自动生成的 Canonical 标签 (如果存在) #}
    {%- tdk canonical with name="CanonicalUrl" %}
    {%- if canonical %}
    <link rel="canonical" href="{{canonical}}" />
    {%- endif %}

    {# AnQiCMS Hreflang 标签配置 #}
    {%- languages websites %}
    {%- for item in websites %}
    <link rel="alternate" href="{{item.Link}}" hreflang="{{item.Language}}">
    {%- endfor %}
    {# 假设您的英文版是默认语言或通用 fallback 语言 #}
    {%- for item in websites %}
        {%- if item.Language == "en" %} {# 替换成您实际的 x-default 语言代码 #}
        <link rel="alternate" href="{{item.Link}}" hreflang="x-default" />
        {%- endif %}
    {%- endfor %}
    {%- endLanguages %}
</head>
<body>
    <!-- 您的网站内容 -->
</body>
</html>

请注意，上述代码中 lang="zh-CN" 属性和 x-default 的判断 item.Language == "en" 仅为示例，您需要根据您网站的实际情况和主语言配置进行调整。通常，lang 属性应该反映当前页面的真实语言，而 x-default 则指向您希望搜索引擎在无法确定用户语言时显示的通用版本。

配置 hreflang 的重要提示

  • 放置位置：hreflang 标签必须放置在 HTML 文档的 <head> 部分。
  • 绝对 URL：确保 href 属性中的 URL 是完整的绝对路径，包含域名和协议（例如 https://www.example.com/en/page）。AnQiCMS 的 item.Link 通常能满足这一要求。
  • 相互引用：每个语言版本的页面都应该包含一组 hreflang 标签，不仅指向其他所有语言版本，也必须包含一个指向自身的标签。AnQiCMS 的 languages 标签会自动生成所有已配置语言站点的链接，只要所有站点都使用了这个公共头部，就能实现相互引用和自引用。
  • 语言和地区代码：hreflang 属性值应遵循 ISO 639-1 语言代码（例如 en、zh）和可选的 ISO 3166-1 Alpha 2 地区代码（例如 en-US、zh-CN）。请确保您的 AnQiCMS 后台配置的语言代码是规范的。
  • 一致性：整个网站的 hreflang 策略应保持一致性，确保所有相关的语言版本都正确地链接在一起。

通过以上步骤，您可以在 AnQiCMS 网站中有效地部署 hreflang 标签，帮助搜索引擎更好地理解您的多语言内容布局，从而为全球不同地区的用户提供更精准的搜索结果，提升网站的国际化 SEO 表现。

常见问题 (FAQ)

Q1: hreflang 标签应该放在网站的哪个位置？ A1: hreflang 标签必须放置在 HTML 文档的 <head> 区块中。将其放置在此区域之外可能会导致搜索引擎无法识别或正确处理这些标签。

Q2: AnQiCMS 会自动生成 x-default 标签吗？如果需要，我应该如何设置？ A2: 根据当前文档描述，AnQiCMS 的 languages 标签会列出所有已配置的多语言站点链接，但没有明确提及会自动生成 x-default 标签。您需要根据您的网站策略，手动在模板中指定一个页面作为 x-default。通常，这会是您的主语言版本页面或一个语言选择器页面。例如，您可以选择英文版作为默认，然后在模板中额外添加一个 x-default 标签，并将其 href 值指向您的英文版页面链接。

Q3: 如果我的网站有多种方言（如简体中文、繁体中文），hreflang 标签如何设置？ A3: 对于不同方言，您应该使用包含地区代码的语言代码。例如，简体中文可以使用 zh-CN，繁体中文（台湾）可以使用 zh-TW，繁体中文（香港）可以使用 zh-HK。确保 AnQiCMS 后台为这些方言配置了正确的语言代码，languages 标签将自动输出对应的 item.Language 值，从而生成正确的 hreflang 标签。