使用 AEM 为 Headless 创作基本内容

迄今为止的故事

在 AEM Headless 内容作者历程的开头，简介涵盖了与针对 Headless 进行创作相关的基本概念和术语。

本文基于这些内容编写，以便您了解如何为 AEM Headless 项目创作您自己的内容。

目标

  • 受众：初学者
  • 目标：介绍 Headless CMS 创作的基础知识：
    • 使用 AEMaaCS 进行创作简介
    • 内容片段简介

基本处理

在您掌握内容片段之前，这里提供了有关如何使用 AEM 的（非常）简短的介绍…但没有什么能真正取代登录和尝试使用系统的体验。

创作和发布

AEM 安装通常至少包含两个环境：

  • 创作
  • 发布

您登录并使用创作环境来生成您的内容。准备就绪后，您可以发布您的内容以使其公开可用。对于 Headless，这针对的是其他应用程序；对于网页，这针对的是网络上的读者。

有关更多详细信息，请参阅创作概念。

登录

与大多数系统一样，您将需要登录。作为作者，您将获得：

  • 用户（帐户）名
  • 密码
  • 用于访问登录屏幕的链接

您的帐户将配置有您需要的任何权限。如果您有任何问题，我们建议您联系您的内部项目支持团队。

首次登录时，简短的在线教程将重点介绍用户界面的一些主要功能。

之后，您可以使用导航面板访问 AEM 的关键区域。对于内容片段，您将使用​内容片段​控制台（对于某些操作，您还将使用 Assets 控制台）。

可以通过依次选择左上角的 Adobe 图标和小型指南针图标来打开导航面板。

注意

虽然内容片段是 AEM Sites 的一项功能，但它们将另存为​资产。这是一个技术细节，应该不会影响您，但了解它可能会有所帮助。

在控制台中，您可以在左侧面板中选择文件夹以导航到您的内容片段。您也可以过滤和/或搜索。

内容片段控制台

操作、选择、查看

在​内容片段​控制台的工具栏中，为您的内容片段提供了一系列操作：

  • 在资产中打开
  • 创建
  • 引用者​列还提供了显示该片段的所有父引用的直接链接；包括引用内容片段、体验片段和页面。
  • 将鼠标悬停在文件夹名称上将显示 JCR 路径。

选择片段后，所有适当的操作均可用：

  • 打开
  • 发布（和 取消发布）
  • 复制
  • 移动
  • 重命名
  • 删除
注意

“发布”、“取消发布”、“删除”、“移动”、“重命名”、“复制”等操作会触发异步作业。 可以通过 AEM 异步作业 UI 监控该作业的进度。

创作内容片段

虽然这是对 AEM 用户界面 (UI) 的非常简要的介绍，但希望您有机会尝试一下。现在，我们开始探究您真正感兴趣的内容 – Headless 的内容片段。

我们必须从头到尾探究这些内容，但您的实例可能已创建文件夹和/或片段，并且它们可能位于不同的位置。准则是一样的。

编排和导航

除非您的内容片段非常少，否则您将需要编排内容 - 以便您（和其他人）能够再次找到它们。

创建文件夹

您可以通过在 Assets 控制台的​文件​部分中创建一系列文件夹来完成此操作。选择​创建​选项（右上角），然后选择​文件夹：

“创建文件夹”选项

这将打开一个对话框，可在其中输入详细信息，然后使用​创建​进行确认：

“创建文件夹”对话框

使用路径和标记限制文件夹中可用的内容片段模型

此部分的内容略为深入一些。如果您刚开始尝试，则并不是真的需要它；但当您有大量片段时，它​非常​有用。了解它是件好事，即使您尚未使用它。

您的内容架构师将创建您的当前项目以及其他一些项目所需的所有内容片段模型。为了帮助您和其他作者简化工作，您可以限制可用于特定文件夹的模型列表。

创建文件夹后，您可以打开文件夹​属性。这里提供了各种选项卡，其中包含有关文件夹的信息和配置详细信息。具体而言，对于内容片段，您可以使用​策略​选项卡为此文件夹定义特定的路径和/或标记。这将限制可在文件夹中使用的内容片段模型，因为这意味着内容片段模型必须先满足这些要求，之后才能用于在此文件夹中生成片段。

创建文件夹属性 – 策略

注意

您可以参阅“内容片段模型”下的更多详细信息 - 允许 Assets 文件夹中的内容片段模型。

之后，您可以浏览这些文件夹以创建和编辑您的内容片段。

以防万一 – 文件夹云服务配置

以防万一…

您可能会获得一个初始文件夹，可以在其中创建文件夹。这是因为必须将一些配置详细信息应用于根文件夹（此操作通常由开发人员或系统管理员执行）。您可能对此不感兴趣，但如有必要，您可以检查文件夹​属性​的​云服务​中的​配置：

创建文件夹属性 – 配置

注意

您可以参阅“将配置应用于 Assets 文件夹”下的更多信息。

创建内容片段

在​内容片段​控制台中，您可以使用​创建​打开​新建内容片段​对话框：

内容片段控制台 – 创建新片段

指定：

  • 位置
  • 内容片段模型
  • 标题
  • 名称
  • 描述

然后使用​创建​或​创建并打开​进行确认。

编辑片段

您可以在创建片段后立即打开它，或者通过从“内容片段”控制台（也可以从 Assets 控制台）中选择它来将其打开。

在编辑器首次打开时，您将看到：

  • 左侧的图标列表 – 可利用这些图标访问各种功能区域。编辑器在​变体​选项卡中打开，将在此处完成大部分编辑工作。您可能还对​批注​和​元数据​选项卡感兴趣。

  • 包含有关片段的信息的标头，以及对各种操作的访问权限。

  • 主要编辑区域，这取决于用于创建片段的模型。

例如：

  • 只需要多条信息（其中一些信息具有特定类型）的片段。对于 Headless 内容，引用很重要，您将在历程的后面部分中了解相关信息。

    内容片段编辑器 – 我的片段

  • 一个允许您编写长段文本的片段。这里提供了用于管理文本并设置其格式的其他选项。您甚至可以在全屏编辑器中打开各个文本字段（使用右侧的类似小屏幕的图标）

    内容片段编辑器 – 阿拉斯加烈酒

注意

可能需要项目特定的文档来帮助作者详细了解如何成功填写某些字段。

有关一般详细信息，请参阅“内容片段模型 – 数据类型和属性”。

使用​保存​或​保存并关闭​来确认更新。

注意

有关更多详细信息，您可以参阅“变体 – 创作内容片段”。

您（可能）无需担心的事情

好吧，这似乎是一个有点奇怪的部分，但在您打开内容片段编辑器并开始浏览之后，您将看到各种选项，它们（可能）不适用于您（作为内容作者）的 Headless 历程。因此，这只是一个快速提示，说明您应该能够在 Headless 上下文中忽略的内容：

  • 内容片段模型

    您将在编辑器顶部看到内容片段模型的名称 - 位于片段名称的正下方。这也是一个可将您转至模型编辑器的链接。
    实际上，内容片段模型对您的内容片段至关重要，因为它们定义了您使用的结构。不过，创建和编辑这些模型（通常）是另一个角色（即内容架构师）的责任。

    注意

    如果您想了解详情，可以参阅“AEM Headless 内容架构师历程”。

  • 关联的内容

    这一个非常明显，因为它是编辑器中的一个选项卡。

    对于相当多的版本，内容片段已在 AEM 中提供。最初，它们在创作页面时可用于“传统”用途…并且它们仍在此上下文中使用。这可能涉及关联资产（例如图像），这些资产未嵌入片段中，需要在创作页面提供给作者。

  • 预览

    这是编辑器中的另一个选项卡，它提供了技术视图，主要供开发人员使用。

  • 更新页面引用

    可从 …（省略号）下拉列表中执行此操作。Headless 作者对它并不感兴趣，因为它与页面创作有关。

发布

完成片段后，您可以​发布​它，以便 Headless 应用程序可使用它。

可以在编辑器中执行发布操作（或从​内容片段​控制台或 Assets 控制台的工具栏中）：

内容片段编辑器 – 我的片段

后续内容

现在您已了解基础知识，下一步是了解引用。这将介绍和讨论可用的各种引用，以及如何使用片段引用（针对 Headless 的创作的关键部分）创建结构层次。

其他资源

在此页面上