创作内容片段

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

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

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

此编辑器提供：

• 自动保存，以防止意外丢失编辑内容。
• 直接上传资源作为内容引用，而不必将它先上传到资源 DAM。
• 预览内容片段投放的所呈现的体验。
• 可从编辑器发布和取消发布。
• 可在编辑器中查看和打开关联的语言副本。
• 可在编辑器中查看版本详细信息。您还可恢复为所选版本。
• 可查看和打开父引用。
• 内容片段及其引用的分层视图，其中使用结构树。

内容片段编辑器

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

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

  • 内容片段控制台的链接（主页图标）

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

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

  • 发布和取消发布操作

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

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

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

    警告

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

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

  • 可使用这些链接在内容片段结构中导航

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

  • 在​属性​选项卡中，可更新片段或​变体​的​标题​和​描述

• 中央面板：显示所选变体的实际字段和内容

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

  根据底层模型中的定义，字段可以遵循某些类型 验证.

在内容片段结构中导航

单个内容片段；

• 由两个级别组成：

  • 内容片段的​变体
  • 字段 - 由内容片段模型定义，并由每个变体使用

• 可包含多种引用。

变体和字段

在左侧面板中，您可以看到：

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

关注链接

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

结构树

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

保存和自动保存

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

变体

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

在编辑器中，您可以：

• 为​主控​内容创建变体

• 选择所需的变体以编辑内容

• 重命名变体

• 删除变体

创建变体

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

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

   注意

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

   

2. 在对话框中，依次输入变体的​标题​和​描述（如果需要）：

   

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

重命名变体

要重命名​变体，请执行以下操作：

1. 选择所需的变体。

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

3. 更新变体​标题。

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

删除变体

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

1. 选择变体。

2. 在​变体​面板中，选择删除图标（垃圾桶）：

   

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

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

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

• 纯文本
• Markdown
• 富文本

定义为纯文本或 Markdown 的字段具有一个简单的文本框，而没有（屏幕上）格式选项：

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

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

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

例如：

全屏编辑器 - 富文本

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

例如：

统计数据 - 富文本

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

例如：

比较和同步 - 富文本

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

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

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

• 用颜色表示差异：

  • 绿色表示添加的内容（添加到变体）
  • 红色表示内容已移除（从变体中）
  • 蓝色表示替换的文本

• 提供​同步​操作，这会将内容从​主控​同步到当前变体

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

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

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

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

管理引用

片段引用

片段引用可用于：

• 创建对现有内容片段的引用
• 创建一个内容片段，然后引用它

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

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

1. 选择字段。

2. 选择​添加现有片段。

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

   注意

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

创建内容片段和引用

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

内容引用

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

引用图像

在​内容引用​字段中，您可以：

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

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

  注意

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

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

要添加资源，您可以：

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

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

  

引用页面

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

1. 选择​添加内容路径。

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

3. 确认​添加。

查看父引用

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

例如：

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

例如：

查看属性和标记

在右侧面板的“属性”选项卡中，可以查看属性（元数据）和标记。属性可以面向：

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

编辑属性和标记

在“属性”选项卡（右侧面板）中，您还可以编辑：

• 标题

• 描述

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

  

打开内容片段模型

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

例如：

查看版本历史记录

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

恢复到某个版本

您可以恢复到任何版本。

要恢复到特定版本，请执行以下操作：

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

2. 选择​恢复。

查看语言副本

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

例如：

预览您的片段

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

要使用此功能，您首先需要：

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

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

发布您的片段

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

• 预览实例
• 发布实例

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

取消发布您的片段

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

• 预览实例
• 发布实例

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

字段、数据类型和图标

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

应了解的要点

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

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

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

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

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

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