了解如何在内容片段中使用引用 author-headless-references
迄今为止的故事 story-so-far
在 AEM Headless 内容作者历程的开头,简介涵盖了与针对 Headless 进行创作相关的基本概念和术语。
您已学习 Headless CMS 创作的基础知识,并大致了解如何使用 AEMaaCS 进行创作,尤其是创作内容片段。
本文基于这些内容编写,以便您了解如何使用引用来为 AEM Headless 项目创作您自己的内容。
目标 objective
-
受众:高级
-
目标:介绍如何在 Headless CMS 创作中使用引用。提供了哪些类型的引用,它们的作用是什么:
- 内容引用
- 资源/媒体引用
- 片段引用
- 文本块中的临时引用
什么是引用? what-are-references
引用只是一种用于连接资源的机制,无论它是其他内容、资源(如图像)还是其他片段。虽然非常相似,但仍有些许不同。
一些引用具有专用数据类型(例如,内容引用和片段引用),而其他引用只是作为引用内容添加到文本块中(资源引用和临时引用)。
内容引用 content-references
内容引用仅用于此目的,可让您引用任何其他内容。 这将打开一个浏览器,其中您可选择内容项。
资源/媒体引用 assets-media-references
可以使用 插入资源 选项在文本块中引用资源(例如,图像或媒体)。这将打开一个浏览器,其中您可选择资源。
片段引用 fragment-references
片段引用也这样做 — 它们允许您引用另一个片段。 需要进一步说明它很重要的原因。
例如,您可能定义了以下内容片段模型:
- 城市
- 公司
- 人员
- 奖励
看似简单明了,但公司有 CEO 和员工…他们每个人都被定义为一个人员。
一个人员可以获得一个(或两个)奖励。
-
我的公司 – 公司
- CEO – 人员
- 员工 – 人员
- 个人奖励 – 奖励
这只适用于初学者。根据复杂性,奖励可以是特定于公司的,或者公司可以在特定城市设立主要办事处。
可以使用片段引用来表示这些相互关系,因为您(作者)和 Headless 应用程序都已理解它们。
作为作者,虽然您不负责定义这些关系(这项工作由内容架构师在创建内容片段模型时完成),但您需要知道如何识别和编辑引用。
如何创作嵌套片段 author-nested-fragment
创作片段引用非常简单(尽管该字段通常将不被标记为 片段引用)。您可以直接键入引用,或者(更有可能)选择文件夹图标以打开浏览器,以便导航并选择所需的片段。
内容片段模型控件的定义:
- 是否能选择添加多个引用
- 您可以选择的内容片段的模型类型;内容片段模型定义允许引用的片段模型,因此 AEM 仅显示基于这些模型的片段。
如何导航嵌套片段 navigate-nested-fragment
利用内容片段编辑器的 结构树 选项卡,您可以浏览您的片段所引用的片段,然后浏览它们可能包含的任何引用。选择引用会打开该片段进行编辑。
临时引用 adhoc-references
临时引用可作为文本块中的简单链接添加:
后续内容 whats-next
现在您已了解内容片段中的引用和结构,下一步是了解元数据和标记。这将介绍和讨论如何为内容片段定义元数据和标记。