创作内容片段

上次更新: 2023-11-18
  • 创建对象:
  • User
    Developer

创作内容片段侧重于 Headless 投放和页面创作。

有两个编辑器用于创作内容片段。此部分中描述的编辑器:

  • 专为投放 Headless 内容开发而成(但它们可用于所有场景)
  • 可从​内容片段​控制台找到它

此编辑器提供:

警告

只有**在线 Adobe Experience Manager (AEM) as a Cloud Service 中有此部分中所述的编辑器可用。

内容片段编辑器

首次打开内容片段编辑器时,您将看到四个主要区域:

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

    • 内容片段控制台的链接(主页图标)

    • 有关模型和文件夹的信息

    • 预览链接(如果为模型配置了默认预览 URL 模式)

    • 发布取消发布操作

    • 用于显示所有​父引用​的选项(链接图标)

    • 片段​状态​和上次保存的信息

    • 用于切换到原始(基于资源的)编辑器的开关

      警告

      原始编辑器将在同一选项卡中打开。 建议不要同时打开两个编辑器。

  • 左侧面板:显示内容片段的​变体​及其​字段

  • 右侧面板:有多个选项卡,其中显示属性(元数据)和标记、关于版本历史记录的信息以及与任何语言副本相关的信息

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

    • 使您可编辑内容
    • 如果在模型中定义了​选项卡占位符​字段,则将在此处显示这些字段,并可使用这些字段进行导航;它们将水平显示或作为下拉列表显示。

内容片段编辑器 – 概述

单个内容片段;

  • 由两个级别组成:

    • 内容片段的​变体
    • 字段 - 由内容片段模型定义,并由每个变体使用
  • 可包含多种引用。

变体和字段

在左侧面板中,您可以看到:

  • 已为此片段创建的​变体​的列表:
    • 主控​是首次创建内容片段时出现的变体,稍后可以添加其他变体
    • 您可以选择并打开变体以进行编辑
    • 您也可以创建变体
  • 片段及其变体中的​字段
    • 图标指示数据类型
    • 文本是字段名称
    • 这些项目共同提供了中央面板中字段内容的直接链接(对于当前变体)

在编辑器的各个部分中,您可以看到链接图标。 这可用于打开显示的项目;例如内容片段模型、父引用或所引用的片段:

内容片段编辑器 - 链接图标

结构树

从编辑器工具栏打开​结构树​选项卡以显示内容片段及其引用的层次结构。使用链接图标导航到引用。

内容片段编辑器 - 结构树

注意

有关更多详细信息,请参阅分析内容片段结构 - 结构树

保存和自动保存

每次进行更新时,内容片段都会自动保存。上次保存的时间将显示在顶部工具栏中。

变体

变体是 AEM 的内容片段的一项重要功能。通过变体,可创建和编辑​主控​内容的副本以供在特定渠道和场景上使用,从而更加灵活地投放 Headless 内容和创作页面。

在编辑器中,您可以:

创建变体

要创建内容片段的变体,请执行以下操作:

  1. 在左侧面板中,选择​变体​右侧的​加号创建变体)。

    注意

    创建第一个变体后,现有变体将在同一面板中列出。

    内容片段编辑器 - 创建您的第一个变体

  2. 在对话框中,依次输入变体的​标题​和​描述(如果需要):

    内容片段编辑器 -“创建变体”对话框

  3. 创建​变体。它显示在列表中。

重命名变体

要重命名​变体,请执行以下操作:

  1. 选择所需的变体。

  2. 打开右侧面板中的​属性​选项卡。

  3. 更新变体​标题

  4. Return 或移至另一个字段以自动保存更改。标题将在左侧的​变体​面板中更新。

删除变体

要删除内容片段的变体,请执行以下操作:

注意

无法删除​主控

  1. 选择变体。

  2. 在​变体​面板中,选择删除图标(垃圾桶):

    内容片段编辑器 -“删除变体”图标

  3. 这将打开一个对话框。选择​删除​以确认操作。

编辑多行文本字段 - 纯文本或 Markdown

多行文本​字段可采用下列三种格式之一:

定义为纯文本或 Markdown 的字段具有一个简单的文本框,而没有(屏幕上)格式选项:

内容片段编辑器 - 多行文本 - 全屏

编辑多行文本字段 - 富文本

对于定义为​富文本​的​多行文本​字段,可以使用各种功能:

  • 编辑内容:
    • 还原/重做
    • 粘贴/粘贴为文本
    • 复制
    • 选择段落格式
    • 创建/管理表
    • 设置文本格式;粗体、斜体、下划线、颜色
    • 设置段落对齐方式
    • 创建/管理列表;项目符号列表,编号列表
    • 缩进文本;减少,增加
    • 清除当前格式
    • 插入链接
    • 选择并插入对图像资源的引用
    • 添加特殊字符
  • 全屏编辑器 - 在全屏和流量中之间切换
  • 统计数据
  • 比较和同步

例如:

内容片段编辑器 - 多行文本 - 全屏切换

注意

多行文本字段也由​字段​面板中相应的图标指示。

全屏编辑器 - 富文本

全屏编辑器提供与流量中时相同的编辑选项 - 但为文本提供了更多空间。

例如:

内容片段编辑器 - 多行文本 - 全屏

统计数据 - 富文本

统计数据​操作显示有关多行字段中的文本的一系列信息。

例如:

内容片段编辑器 - 统计数据

比较和同步 - 富文本

在打开一个​变体​后,可对多行字段执行​比较​操作。

这将在全屏模式下打开多行字段,并且:

  • 并行显示​主控​和当前​变体​的内容,并突出显示任何差异

  • 用颜色表示差异:

    • 绿色表示添加的内容(添加到变体)
    • 红色表示内容已移除(从变体中)
    • 蓝色表示替换的文本
  • 提供​同步​操作,这会将内容从​主控​同步到当前变体

    • 如果已更新​主控,这些更改将传输到变体中
    • 如果已更新变体,这些更改将由​主控​内容覆盖
    注意

    同步仅可将更改​从​主控​复制到变体

    不提供将更改​从变体传输到​主控的选项。

例如,在完全重写变体内容的场景中,同步会将新内容替换为​主控​内容:

内容片段编辑器 - 比较和同步

管理引用

片段引用

片段引用可用于:

创建对现有内容片段的引用

要创建对现有内容片段的引用,请执行以下操作:

  1. 选择字段。

  2. 选择​添加现有片段

  3. 从片段选择器中选择所需的片段。

    注意

    您一次只能选择一个片段。

创建内容片段和引用

或者,您可以选择​创建新片段​以打开​创建​对话框。此片段一经创建便会被引用。

内容引用

内容引用用于引用其他 AEM 内容类型,例如图像、页面和体验片段。

引用图像

在​内容引用​字段中,您可以:

  • 引用存储库中已存在的资源

  • 直接将资源上传到字段;这样一来,便无需使用​资源​控制台进行上传

    注意

    要直接将图像上传到​内容引用​字段,它​必须

    • 已定义一个​根路径(在内容片段模型中)。这将指定图像的存储位置。
    • 在接受的内容类型列表中包括​图像

要添加资源,您可以:

  • 将新的资源文件直接(例如,从您的文件系统中)拖放到​内容引用​字段

  • 使用​添加资源​操作,然后选择​浏览资源​或​上传​以打开适当的选择器进行使用:

    内容片段编辑器 - 添加资源选项

引用页面

要添加对 AEM 页面、体验片段或其他内容类型的引用,请执行以下操作:

  1. 选择​添加内容路径

  2. 在输入字段中添加所需的路径。

  3. 确认​添加

查看父引用

选择顶部工具栏中的链接图标将打开所有父引用的列表。

例如:

内容片段编辑器 - 显示引用

这将打开一个窗口,其中列出了所有相关引用。要打开引用,请选择名称或标题,或链接图标。

例如:

内容片段编辑器 - 显示引用

查看属性和标记

在右侧面板的“属性”选项卡中,可以查看属性(元数据)和标记。属性可以面向:

  • 内容片段 - 如果当前已选定​主控
  • 特定的​变体

内容片段编辑器 - 属性

编辑属性和标记

在“属性”选项卡(右侧面板)中,您还可以编辑:

  • 标题

  • 描述

  • 标记:使用下拉列表或选择对话框

    内容片段编辑器 - 管理标记

打开内容片段模型

在选定​主控​后,底层内容片段模型的名称将显示在“属性”部分中。选择链接图标,在单独的选项卡中打开模型。

例如:

内容片段编辑器 - 打开内容片段模型

查看版本历史记录

在右侧面板的​版本历史记录​选项卡中,将显示当前版本和早期版本的详细信息:

注意

发布内容片段时将创建新版本。

内容片段编辑器 - 版本历史记录概述

恢复到某个版本

您可以恢复到任何版本。

要恢复到特定版本,请执行以下操作:

  1. 选择版本旁边的三个圆点图标。

  2. 选择​恢复

内容片段编辑器 - 版本历史记录恢复

查看语言副本

在​语言属性​选项卡中,将显示任何相关语言副本的详细信息。选择链接图标,在单独的选项卡中打开副本。

例如:

内容片段编辑器 - 打开语言副本

注意

有关翻译内容片段和创建语言副本的更多详细信息,请参阅 AEM Headless 翻译历程

预览您的片段

利用内容片段编辑器中的选项,作者可以在外部前端应用程序中预览其编辑内容。

要使用此功能,您首先需要:

  • 与您的 IT 团队一起设置外部前端应用程序,该应用程序将使用其 JSON 输出来渲染内容片段。
  • 当设置外部前端应用程序时, 默认预览URL模式 必须定义为 相应内容片段模型的属性.

在定义 URL 后,预览​按钮将处于活动状态。您可以选择此按钮来启动外部应用程序(在单独的选项卡中)以渲染内容片段。

发布您的片段

您可以将片段​发布​到:

  • 预览实例
  • 发布实例

您可以从编辑器或控制台发布片段。有关完整详细信息,请参阅发布和预览片段

取消发布您的片段

您也可从以下项目中​取消发布​您的片段:

  • 预览实例
  • 发布实例

您可以从编辑器或控制台取消发布片段。有关完整详细信息,请参阅取消发布片段

字段、数据类型和图标

字段​面板列出了内容片段中的所有字段。图标指示​数据类型

单行文本

多行文本

数字

布尔值

日期和时间

枚举

标记

内容引用

片段引用

JSON 对象

选项卡占位符

选项卡占位符显示在左侧面板中,但未用实际图标表示。
它也显示在中央面板中,要么如下所示以水平方式显示,要么显示在下拉列表中(如果项目太多而无法以水平方式显示)。

应了解的要点

  • 要编辑内容片段,您需要相应的权限。如果您遇到问题,请联系您的系统管理员。

    例如,如果您没有 edit 权限,则编辑器将是只读的。

  • 内容片段模型通常可以定义名为​标题​和​描述​的数据字段。如果存在这些字段,则它们是用户定义的字段,并在编辑片段时可在​中央面板​中更新这些字段。

    内容片段及其变体也具有名为​标题​和​描述​的元数据字段(变体属性)。这些字段是任何内容片段的组成部分,并在创建该片段时中定义这些字段。在编辑片段时可在​右侧面板​中更新这些字段。

  • 有关原始内容片段编辑器的完整信息,请参阅资源文档 - 从​资源​控制台和​内容片段​控制台均可找到此编辑器。

  • 如有必要,您的项目团队可以自定义编辑器。 有关进一步详细信息,请参阅自定义内容片段控制台和编辑器

在此页面上