如何配置AnQiCMS支持多语言内容的显示与切换？

在全球化日益盛行的今天，网站支持多语言内容显示与切换已成为拓展国际市场、服务多元用户群体的关键要素。AnQiCMS作为一个专注于企业内容管理的高效系统，充分考虑了这一需求，提供了灵活且实用的多语言配置方案。本文将详细探讨如何在AnQiCMS中配置并管理多语言内容，帮助您的网站轻松实现全球化布局。

理解AnQiCMS的多语言机制

在深入配置之前，首先需要理解AnQiCMS处理多语言内容的基本逻辑。AnQiCMS将多语言功能划分为几个层面，以满足不同场景的需求：

  1. 系统语言包： 主要针对后台管理界面以及部分内置的前端提示信息。这决定了AnQiCMS系统本身的操作语言。
  2. 模板静态文本翻译： 用于网站模板中固定的、不随文章内容变化的文本字符串，例如导航菜单项、版权声明、页面模块标题等。
  3. 多语言内容管理： 核心部分，涉及文章、产品、单页面等实际业务内容的翻译与展示。AnQiCMS主要通过“多站点”机制来支持不同语言版本的内容管理。
  4. 语言切换与SEO优化： 提供用户在不同语言版本间切换的机制，并支持生成有利于搜索引擎识别的hreflang标签。

了解这些层面的区分，有助于我们更清晰地规划多语言网站的搭建过程。

一、配置AnQiCMS的系统语言包（后台与内置提示）

AnQiCMS提供内置的语言包，用于本地化系统界面和部分前端内置提示文字。配置这一项相对简单：

您可以在AnQiCMS的后台管理界面中，导航至“后台设置”下的“全局设置”区域。在这里，您会找到一个名为“默认语言包”的选项。系统通常会内置中文、英文等多种语言供您选择。一旦您选择了所需的语言并保存，后台界面的文字以及一些由系统直接输出的固定提示信息将相应地切换为该语言。

需要注意的是，此设置仅影响系统层面的文字显示。您的文章、产品、分类等具体业务内容的语言并不会因此改变，它们需要通过后续的内容管理策略进行独立的维护。

二、实现模板静态文本的翻译

网站模板中往往包含大量固定的文本，如页眉、页脚、侧边栏标题、表单标签等。这些静态文本也需要根据用户选择的语言进行切换。AnQiCMS通过{% tr %}翻译标签和独立的语言文件来实现这一点。

  1. 创建语言文件： 在您的AnQiCMS模板目录下，您需要创建一个名为locales的文件夹。在locales文件夹内，为每种目标语言创建一个子文件夹，例如en-us代表美式英语，zh-cn代表简体中文。在每个语言子文件夹中，创建一个.yml文件（例如default.yml），用于存放该语言对应的翻译键值对。

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

    "yourLocation": "您的位置"
"homePage": "首页"

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

    "yourLocation": "Your Location"
"homePage": "Home"

  2. 在模板中使用翻译标签： 在网站模板（如header.html, footer.html或其他任何.html模板文件）中，您可以使用{% tr %}标签来调用这些翻译后的文本。

    例如，如果您需要在网站的导航栏显示“首页”，则可以这样编写：

    <a href="/">{% tr "homePage" %}</a>

    当用户访问网站时，系统会根据其选择的语言（通常由后续的多语言站点配置决定），自动加载对应的.yml文件，并显示正确的翻译文本。

三、管理多语言内容（核心策略：多站点）

AnQiCMS处理多语言内容的推荐和核心策略是利用其强大的“多站点管理”功能。这意味着您将为每种语言创建一个独立的“站点”，每个站点拥有自己的内容、设置和独立的数据，但它们都由同一个AnQiCMS安装实例进行管理。

  1. 创建多语言站点：

    • 规划站点结构： 首先，决定您的多语言网站的URL结构。常见的模式包括：
      • 独立域名： yourbrand.com (中文), yourbrand.de (德文)
      • 子域名： cn.yourbrand.com (中文), en.yourbrand.com (英文)
      • 子目录： yourbrand.com/cn/ (中文), yourbrand.com/en/ (英文)
    • 新增站点： 登录您AnQiCMS的初始安装站点后台，在“多站点管理”功能下，点击“添加新站点”。为每种语言重复此步骤。在创建新站点时，您需要指定：
      • 站点名称： 例如“中文站”、“英文站”。
      • 网站地址： 对应您规划好的域名、子域名或子目录URL。
      • 数据库名称： 建议为每个语言站点使用独立的数据库，以确保数据隔离和管理便利性。
      • 管理员账号密码： 为每个站点设置独立的后台登录凭证。
    • 配置服务器反向代理： 无论您选择哪种URL结构，都需要在您的Web服务器（如Nginx、Apache）或宝塔/1Panel等面板中，为每个语言站点配置相应的域名解析和反向代理规则，将流量正确引导至AnQiCMS实例的相应端口（如果您是Docker部署，则对应Docker容器的端口）。

  2. 内容创建与维护：

    • 独立管理： 每个语言站点都是一个独立的AnQiCMS实例。这意味着您需要分别登录每个语言站点的后台，并为其创建和管理相应语言的文章、产品、分类和单页面内容。例如，您在中文站创建了一篇关于“AnQiCMS功能介绍”的文章，您也需要在英文站手动翻译并创建一篇对应的“AnQiCMS Features”文章。
    • 保持内容一致性： 尽管内容是独立的，但为了方便管理和保持用户体验，建议在不同语言站点之间尽可能保持内容结构（如分类层级、页面模型字段）的一致性。例如，如果中文站有一个“新闻中心”分类，英文站也应该有一个“News Center”分类，它们的内部内容也应该一一对应。
    • 内容关联提示（可选）： AnQiCMS目前没有内置的内容关联功能来自动链接不同语言版本的内容。您可以通过自定义字段或在文章内容中手动添加链接的方式，提示不同语言版本内容的关联。

四、实现语言切换与SEO优化

用户需要一种简便的方式来在不同语言版本之间切换。同时，为了确保搜索引擎能正确识别您网站的多语言内容，hreflang标签的配置至关重要。

  1. 语言切换器（使用{% languages %}标签）： AnQiCMS提供了{% languages %}标签来获取所有已配置的多语言站点列表，您可以使用它来构建一个语言切换器。

    在您的网站模板（通常是页眉或页脚等公共部分）中，可以这样编写： “`twig {%- languages websites %} {%- if websites %} 

    <span>切换语言：</span>
{%- for item in websites %}
<a href="{{item.Link}}" title="{{item.LanguageName}}">
    {%- if item.LanguageIcon %}
    <img src="{{item.LanguageIcon}}" alt="{{item.LanguageName}}" />
    {%- else %}
    {{item.LanguageEmoji}} <!-- 或直接显示{{item.LanguageName}} -->
    {% endif %}
    {{item