核心组件的本地化功能

最近更新： 2025年5月5日

主题：
核心组件

创建对象：

开发人员
管理员
用户

许多网站要求以本地化格式跨多种语言和地域提供内容。选定的核心组件具有智能参考解析功能，可轻松为所有本地化内容创建一个统一的模板，此模板会自动根据本地化站点结构进行调整。

示例 - 带导航和页脚的本地化页面

大多数站点都要求跨所有页面显示页脚。通常，这些页脚在页面的所有内容中是一致的。不过，对于本地化的内容页面，需要显示该页眉或页脚的本地化版本。

同样，导航组件通常必须跨所有页面显示。但它还需要反映本地化页面的内容。

通过将导航核心组件和体验片段核心组件的本地化功能与 AEM 的可编辑模板结合使用，可轻松完成此任务。也可以进一步扩展此示例以使用语言导航组件。

内容结构

AEM 及其核心组件的所有本地化功能都依赖本地化内容的清楚合理的内容结构。

假定您的站点称作 my-site 并位于此处：

/content/my-site

假定您用英语创作您的站点并提供其法语版本。如果您有一个称作 my-page 的简单页面，则会在站点的内容树中找到该页面的两个本地化分支：

/content
\-- my-site
   +-- en
       \-- my-page
   \-- fr
       \-- my-page

您将在这两个本地化分支下创建其他站点页面。

通常将使用体验片段创建页脚，因此您将同时需要英语版和法语版，就像您的页面一样。然而，体验片段不是页面，而是能够跨页面重复使用的页面部分，因此它们并不会作为页面的其余部分直接位于 /content 下。相反，体验片段位于自己的文件夹下，但由于它们也必须进行本地化，因此其结构必须镜像站点的本地化结构。

/content
+-- experience-fragments
   +-- en
      \-- footer
   \-- fr
      \-- footer
\-- my-site
   +-- en
      \-- my-page
   \-- fr
      \-- my-page

利用镜像的本地化结构，核心组件可以为相应的页面找到必要的本地化内容。

体验片段组件很灵活，非常适用于页眉或页脚。

由于我们假定的网站具有英语版和法语版，因此我们需要在之前描述的位置创建两个称作 footer 的体验片段。

页面模板

由于页脚将显示在每个页面上，因此我们需要将体验片段添加到我们的标准页面模板中。

我们的模板称作 my-template 并且与其他模板位于同一位置：

/conf/my-site/settings/wcm/templates/my-template

在此模板中，我们将添加需作为页面基础的基本组件。

导航组件
- 导航组件将显示在每个页面的顶部。
- 在导航组件中，我们定义了导航根目录，以便组件获知站点的导航结构的开始位置。
- 该组件会自动根据导航根目录查找对应的本地化内容。
容器组件
- 每个页面都将包含一个可编辑的容器组件，以便作者能够在页面上放置其他内容。
体验片段
- 我们将体验片段组件指向代表页脚的片段的创作语言中的片段路径。
- 此组件会自动根据片段的路径和镜像本地化页面结构的体验片段的结构来查找相应的本地化内容。