创作内容片段 authoring-content-fragments

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

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

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

此编辑器提供:

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

内容片段编辑器 content-fragment-editor

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

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

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

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

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

    • 发布取消发布操作

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

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

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

      note warning
      WARNING
      原始编辑器将在同一选项卡中打开。 建议不要同时打开两个编辑器。
  • 左侧面板:显示内容片段的​ 变体 ​及其​ 字段

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

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

    • 使您可编辑内容
    • 如果 制表符占位符 这些字段是在模型内定义的,显示在此处,并可用于导航;它们将会水平显示或作为下拉列表显示。
    note note
    NOTE
    根据底层模型中的定义,字段可以遵循某些类型 验证.

内容片段编辑器 – 概述

在内容片段结构中导航 navigate-structure

单个内容片段;

  • 由两个级别组成:

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

变体和字段 variations-and-fields

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

  • 已为此片段创建的​ 变体 ​的列表:

    • 主控 ​是首次创建内容片段时出现的变体,稍后可以添加其他变体
    • 您可以选择并打开变体以进行编辑
    • 您也可以创建变体
  • 片段及其变体中的​ 字段

    • 图标指示数据类型
    • 文本是字段名称
    • 这些项目共同提供了中央面板中字段内容的直接链接(对于当前变体)

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

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

结构树 structure-tree

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

内容片段编辑器 - 结构树

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

保存和自动保存 saving-autosaving

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

变体 variations

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

在编辑器中,您可以:

创建变体 create-variation

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

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

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

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

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

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

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

重命名变体 rename-variation

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

  1. 选择所需的变体。

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

  3. 更新变体​ 标题

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

删除变体 delete-variation

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

NOTE
无法删除​ 主控
  1. 选择变体。

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

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

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

编辑多行文本字段 - 纯文本或 Markdown edit-multi-line-text-fields-plaintext-markdown

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

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

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

编辑多行文本字段 - 富文本 edit-multi-line-text-fields-rich-text

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

  • 编辑内容:

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

  • 统计数据

  • 比较和同步

例如:

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

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

全屏编辑器 - 富文本 full-screen-editor-rich-text

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

例如:

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

统计数据 - 富文本 statistics-rich-text

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

例如:

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

比较和同步 - 富文本 compare-and-synchronize-rich-text

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

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

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

  • 用颜色表示差异:

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

    • 如果已更新​ 主控,这些更改将传输到变体中
    • 如果已更新变体,这些更改将由​ 主控 ​内容覆盖
    note caution
    CAUTION
    同步仅可将更改​ 从​ 主控 ​复制到变体
    不提供将更改​ 从变体传输到​ 主控 的选项。

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

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

管理引用 manage-references

片段引用 fragment-references

片段引用可用于:

创建对现有内容片段的引用 create-reference-existing-content-fragment

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

  1. 选择字段。

  2. 选择​ 添加现有片段

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

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

创建内容片段和引用 create-reference-content-fragment

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

内容引用 content-references

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

引用图像 reference-images

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

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

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

    note note
    NOTE
    要直接将图像上传到​ 内容引用 ​字段,它​ 必须
    • 已定义一个​ 根路径(在内容片段模型中)。这将指定图像的存储位置。
    • 在接受的内容类型列表中包括​ 图像

要添加资源,您可以:

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

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

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

引用页面 reference-pages

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

  1. 选择​ 添加内容路径

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

  3. 确认​ 添加

查看父引用 view-parent-references

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

例如:

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

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

例如:

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

查看属性和标记 view-properties-tags

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

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

内容片段编辑器 - 属性

编辑属性和标记 edit-properties-tags

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

  • 标题

  • 描述

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

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

打开内容片段模型 open-content-fragment-model

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

例如:

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

查看版本历史记录 view-version-history

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

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

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

恢复到某个版本 revert-version

您可以恢复到任何版本。

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

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

  2. 选择​ 恢复

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

查看语言副本 view-language-copies

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

例如:

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

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

预览您的片段 preview-content-fragment

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

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

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

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

发布您的片段 publish-content-fragment

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

  • 预览实例
  • 发布实例

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

取消发布您的片段 unpublish-content-fragment

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

  • 预览实例
  • 发布实例

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

字段、数据类型和图标 fields-datatypes-icons

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

单行文本
多行文本
数字
布尔值
日期和时间
枚举
标记
内容引用
片段引用
JSON 对象

选项卡占位符

选项卡占位符 显示在左侧面板中,但未用实际图标表示。
它也显示在中心面板中,水平显示或下拉列表(当有太多内容无法水平显示时)中。

应了解的要点 good-to-know

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

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

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

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

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

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

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