使用 AEM 为 Headless 创作基本内容 author-headless-basics

迄今为止的故事 story-so-far

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

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

目标 objective

  • 受众:初学者

  • 目标:介绍 Headless CMS 创作的基础知识:

    • 使用 AEMaaCS 进行创作简介
    • 内容片段简介

基本处理 basic-handling

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

“创作”、“预览”和“发布” author-preview-publish

AEM 安装通常包含三个环境:

  • 创作
  • 发布
  • 预览

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

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

从​ 内容片段 ​控制台,您也可以在发布前发布到​ 预览服务,以进行测试和预览。请参阅“发布和预览片段”。

登录 signing-in

与大多数系统一样,您需要登录。作为作者,您会获得:

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

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

导航 navigation

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

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

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

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

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

内容片段控制台

操作、选择、查看 actions-selecting-viewing

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

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

选择片段后,所有适当的操作均可用:

  • 打开
  • 发布(和 取消发布
  • 复制
  • 移动
  • 重命名
  • 删除
NOTE
“发布”、“取消发布”、“删除”、“移动”、“重命名”、“复制”等操作会触发异步作业。可通过 AEM 异步作业 UI 监视该作业的进度。

创作内容片段 authoring-content-fragments

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

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

编排和导航 organizing-and-navigating

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

创建文件夹 creating-folder

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

“创建文件夹”选项

随后将打开一个对话框,您可在其中输入详细信息,然后用​ 创建 ​进行确认:

“创建文件夹”对话框

使用路径和标记限制文件夹中可用的内容片段模型 tags-paths-for-models-in-folder

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

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

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

创建文件夹属性 – 策略

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

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

以防万一 – 文件夹云服务配置 cloud-services-folder

以防万一…

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

创建文件夹属性 – 配置

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

创建内容片段 creating-fragment

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

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

指定:

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

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

编辑片段 editing-fragment

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

NOTE
内容片段是一项站点功能,但存储为​ 资源
有两个编辑器用于创作内容片段。
  • 新编辑器,主要从​ 内容片段 ​控制台访问它。
  • 原始编辑器,主要从​ 资源 ​控制台访问它。

在编辑器首次打开时,您将看到:

  • 顶部工具栏:用于关键信息和操作

    • 内容片段控制台的链接(主页图标)
    • 有关模型和文件夹的信息
    • 预览链接;如果为模型配置了默认预览 URL 模式
    • 发布和取消发布操作
    • 用于显示所有​ 父引用 ​的选项(链接图标)
    • 片段​ 状态 ​和上次保存的信息
    • 用于切换到原始(基于资源的)编辑器的开关
  • 左侧面板:显示内容片段的​ 变体 ​及其​ 字段

    • 可使用这些链接在内容片段结构中导航
  • 右侧面板:有多个选项卡,其中显示属性(元数据)和标记、关于版本历史记录的信息以及与任何语言副本相关的信息

    • 在​ 属性 ​选项卡中,可更新片段或​ 变体 ​的​ 标题 ​和​ 描述
  • 中央面板:显示所选变体的实际字段和内容

    • 使您可编辑内容
    • 如果在模型中定义了​ 选项卡占位符 ​字段,则将在此处显示这些字段,并可使用这些字段进行导航

例如,片段可以:

  • 需要多条信息,其中一些信息具有特定类型。对于 Headless 内容,引用很重要(您将在历程的后面了解这些内容)。

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

内容片段编辑器 – Alaska Spirits

NOTE
可能需要项目特定的文档来帮助作者详细了解如何成功填写某些字段。
有关一般详细信息,请参阅“内容片段模型 – 数据类型和属性”。

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

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

您(可能)无需担心的事情 what-you-probably-do-not-need-to-worry-about

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

  • 内容片段模型

    您可在编辑器的右侧面板中看到内容片段模型的名称。这也是一个可将您转至模型编辑器的链接。
    实际上,内容片段模型对您的内容片段至关重要,因为它们定义了您使用的结构。不过,创建和编辑这些模型(通常)是另一个角色(即内容架构师)的责任。

    note note
    NOTE
    如果您想了解详细信息,可以参阅“AEM Headless 内容架构师历程”。

发布 publishing

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

发布操作在编辑器中可用:

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

NOTE
您也可以从​ Assets ​或​ 内容片段»控制台发布您的片段。

后续内容 whats-next

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

其他资源 additional-resources

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab