创建页面模板

创建页面时,您必须选择一个模板,该模板将用作创建新页面的基础。 模板定义了生成页面的结构、任何初始内容以及可以使用的组件。

使用模 板编辑器,创建和维护模板不再只是开发人员的任务。 高级用户(称为模板作者 )也可能。 开发人员仍需要设置环境、创建客户端库和创建要使用的组件,但是,在这些基础知识到位后,模板作者就可以灵活地创建和配置模板,而无需开发项目。

模板控制台 允许模板作者:

  • 创建新模板,或复制现有模板。
  • 管理模板的生命周期。

模板编辑器 允许模板作者:

  • 将组件添加到模板并将它们放置在响应式网格上。
  • 预先配置组件。
  • 定义在使用模板创建的页面上可以编辑哪些组件。

本文档说明如何 模板作者 可以使用“模板”控制台和编辑器创建和管理可编辑模板。

有关如何在技术层面使用可编辑模板的详细信息,请参阅开发人员文档 页面模板 — 可编辑 了解更多信息。

注意

模板 ​编辑器不支持直接在模板级别进行定位。 可以定位基于可编辑模板创建的页面,但不能定位模板本身。

注意

使用创建的页面和模板 模板控制台 不能与经典UI一起使用,并且不支持此类使用。

开始之前

注意

管理员必须在​配置浏览器​中配置一个模板文件夹,并应用适当的权限,之后模板作者才能在该文件夹中创建模板。

在开始之前,请务必注意以下几点:

  • 创建新模板需要协作。 因此,为每项任务指明了对应的角色

  • 根据实例的配置方式,请注意AEM现在提供的 两种基本类型的模板. 这不会影响您实际的 使用模板创建页面,但它确实会影响您可以创建的模板类型以及页面与其模板的关系。

角色

使用​“模板”控制台​和​模板编辑器​创建新模板需要以下角色之间的协作:

  • 管理员:

    • 创建新的模板文件夹需要 admin 权限。

    • 此类任务通常也可以由开发人员完成

  • 开发人员:

    • 专注于技术/内部详细信息
    • 需要具有开发环境方面的经验。
    • 为模板作者提供必要信息。
  • 模板作者

    • 特定的作者,template-authors 组中的一个成员。

      • 可分配所需的权限和许可。
    • 可以配置组件的使用和其他高级详细信息,这些详细信息需要:

      • 一些技术知识

        • 例如,在定义路径时使用模式。
      • 由开发人员提供的技术信息。

由于某些任务(如创建文件夹)的性质,需要开发环境,而这需要知识/经验。

本文档中详细列出的任务以及负责执行这些任务的角色。

可编辑的模板和静态模板

AEM现在提供两种基本类型的模板:

  • 可编辑模板

    • 可以是 已创建已编辑 模板作者使用 模板 控制台和编辑器。 此 模板 控制台可在 常规 部分 工具 控制台。

    • 创建新页面后,页面和模板之间会保持动态连接。 这意味着对模板结构和/或锁定内容的更改将反映在使用该模板创建的任何页面上。 对已解锁(即初始)内容所做的更改将不会反映出来。

    • 使用内容策略(可在模板编辑器中定义这些策略)来保留设计属性。 页面编辑器中的设计模式不再用于可编辑的模板。

  • 静态模板

    • 静态模板可用于多个版本的AEM。
    • 它们是 由您的开发人员提供,因此作者无法创建或编辑它们。
    • 将被复制以创建新页面,但之后不存在动态连接(尽管模板名称已注册以供参考)。
    • 使用 设计模式 以保留设计属性。
    • 由于编辑静态模板是开发人员的独家任务,请参阅开发人员文档 页面模板 — 静态 了解更多信息。

根据定义,模板控制台和模板编辑器仅允许创建和编辑可编辑模板。 因此,本文档仅侧重于可编辑的模板。

使用模板创建页面

将模板用于 创建新页面 静态模板与可编辑模板之间没有可见的区别和指示。 对于页面作者,该过程是透明的。

创建和管理模板

在创建新的可编辑模板时,您可以:

注意

通常,在最初设置您的网站时便会预定义​允许的模板

注意

切勿输入任何需要的信息 国际化 放入模板。 出于内部化目的, 核心组件的本地化功能 建议使用。

创建模板文件夹 – 管理员

您应该为项目创建模板文件夹,以保存特定于项目的模板。这是一项管理员任务,在文档中进行了描述 页面模板 — 可编辑.

创建新模板 – 模板作者

  1. 打开​“模板”控制台(通过​工具 -> 常规),然后导航到所需的文件夹。

    注意

    在标准 AEM 实例中,“模板”控制台中已存在​全局​文件夹。此文件夹会保存默认模板,如果在当前文件夹中没有找到策略和/或模板类型,则此文件夹可以充当备用。

    建议最好使用 为您的项目创建的模板文件夹.

  2. 选择​创建,然后选择​创建模板​以打开向导。

  3. 选取 模板类型,然后选择 下一个.

    注意

    模板类型是预定义的模板布局,可以将其视为模板的模板。 这些权限由开发人员或系统管理员预定义。 有关详细信息,请参阅开发人员文档 页面模板 — 可编辑.

  4. 完成 模板详细信息

    • 模板名称
    • 描述
  5. 选择​创建。随即会显示确认对话框,选择​打开🔗以开始编辑模板,或选择​完成​以返回到“模板”控制台。

    注意

    创建新模板后,会在控制台中将其标记为​草稿,这表示页面作者还不能使用此模板。

定义模板属性 — 模板作者

模板可以具有以下属性:

  • 图像

    • 要用作的图像 模板的缩略图 以帮助进行选择,例如在“创建页面”向导中选择。

      • 可以上传
      • 可以基于模板内容生成
  • 标题

    • 用于标识模板的标题,例如 创建页面 向导。
  • 描述

    • 可选描述,用于提供更多有关模板及其用法的信息,例如​创建页面​向导中显示的描述。

要查看和/或编辑属性,请执行以下操作:

  1. 在​模板控制台​中,选择相应的模板。
  2. 从工具栏或快速选项中选择​查看属性​以打开对话框。
  3. 此时您可以查看或编辑模板属性。
注意

模板是简化页面创建工作流的强大工具。不过,太多的模板会让作者不知所措,并使页面创建变得混乱。一个好的经验法则是将模板的数量保持在 100 个以内。

由于潜在的性能影响,Adobe 建议不要使用超过 1000 个模板。

注意

控制台中会指示模板的状态(“草稿”、“已启用”或“已禁用”)。

模板缩略图图像

要定义模板缩略图,请执行以下操作:

  1. 编辑模板属性。

  2. 选择要上传缩略图还是从模板内容生成缩略图。

    • 如果要上传缩略图,请单击或点按 上传图像
    • 如果要生成缩略图,请单击或点按 生成预览
  3. 对于这两种方法,将显示缩略图预览。

    如果不满意,请单击或点按 清除 上传其他图像或重新生成缩略图。

  4. 如果您对缩略图满意,请单击或点按 保存并关闭.

启用和允许模板 — 模板作者

为了能够在创建页面时使用模板,您需要执行以下操作:

启用模板 – 模板作者

可以启用或禁用模板,使其在 创建页面 向导。

注意

启用模板后,当模板作者开始进一步更新模板时,将显示警告。 这是为了告知用户可能会引用该模板,因此任何更改都可能影响引用该模板的页面。

  1. 在​模板控制台​中,选择相应的模板。
  2. 从工具栏中选择​启用​或​禁用,然后在确认对话框中再次选择“启用”或“禁用”。
  3. 现在,您便能够在创建新页面时使用模板,不过您可能想要根据自己的需求编辑模板
注意

控制台中会指示模板的状态(“草稿”、“已启用”或“已禁用”)。

允许模板 – 作者

可以使模板可用于或不可用于某些页面分支。

  1. 对于希望可在其中使用模板的分支,打开其根页面的页面属性

  2. 打开​高级​选项卡。

  3. 在​模板设置​下方,使用​添加字段​指定模板的路径。

    路径可以是显式路径或使用模式。 例如:

    /conf/<your-folder>/settings/wcm/templates/.*

    路径的顺序无关,将扫描所有路径并检索任何模板。

    注意

    如果 允许的模板 列表留空,树将提升,直到找到值/列表。

    请参阅模板可用性 – 对允许的模板适用的原则与此相同。

  4. 单击​保存,以保存对页面属性所做的更改。

注意

通常,在设置您的网站时便会为整个网站预定义允许的模板。

发布模板 – 模板作者

由于渲染页面时会引用模板,因此模板在完全配置后需要进行发布,才能用于发布环境。

  1. 在​模板控制台​中,选择相应的模板。

  2. 从工具栏中选择​发布​以打开向导。

  3. 选择要一同发布的​内容策略

  4. 选择 Publish ,以完成操作。

编辑模板 — 模板作者

创建或编辑模板时,您可以定义多个方面。 编辑模板与页面创作类似。

可以编辑模板的以下方面:

  • 结构

    页面作者不能从生成页面中移动/移除在此处添加的组件。 如果您希望页面作者能够在生成页面中添加和删除组件,则需要将段落系统添加到模板。

    锁定组件后,您可以添加页面作者无法编辑的内容。 您可以解锁组件,以便定义 初始内容.

    注意

    在结构模式下,任何作为已解锁元件的父元件的元件均无法移动、剪切或删除。

  • 初始内容

    解锁组件后,您可以定义要复制到生成页面(使用模板创建)的初始内容。可以在生成页面上编辑这些已解锁的组件。

    注意

    在​初始内容​模式下以及在生成页面上,可以删除任何具有可访问父项的已解锁组件(即,布局容器内的组件)。

  • 布局

    您可以在此处预定义所需设备格式的模板布局。 模板创作的​布局​模式与​页面创作的布局​模式具有相同的功能。

  • 页面策略

    在页面策略下,您可以将预定义的页面策略连接到页面。 这些页面策略可定义各种设计配置。

  • 样式

    样式系统允许模板作者在组件的内容策略中定义样式类,以便内容作者在页面上编辑组件时能够选择这些类。这些样式可以作为组件的替代可视化变量,从而使组件变得更加灵活。

    有关更多信息,请参阅样式系统文档

使用工具栏中的​模式​选择器,可以选择并编辑模板的相应方面:

chlimage_1-133

而使用​页面信息​菜单中的​页面策略​选项,可以选择所需的页面策略

screen_shot_2018-03-23at120604

注意

如果作者开始编辑已启用的模板,将显示警告。 这是为了告知用户可能会引用该模板,因此任何更改都可能影响引用该模板的页面。

编辑模板 – 结构 – 模板作者

在​结构​模式下,您可以为模板定义组件和内容,并为模板及其组件定义策略。

  • 不能在生成的页面上移动模板结构中定义的组件,也不能从任何生成的页面中删除这些组件。

  • 如果您希望页面作者能够添加和删除组件,请向模板中添加一个段落系统。

  • 可以解锁组件,然后再将其锁定,以便定义初始内容

  • 可为组件和页面定义设计策略。

screen_shot_2018-03-23at120819

In 结构 模板编辑器的模式:

  • 添加组件

    向模板中添加组件有多种机制:

    • 组件 浏览器中。

    • 通过使用 插入组件 选项(+ 图标)的工具栏上提供的页面加载项,或者 将组件拖动到此处 盒子。

    • 通过拖动资产(从 资产 浏览器中)直接加载到模板上以就地生成相应的组件。

    添加后,每个组件都标有:

    • 边框
    • 用于显示组件类型的标记
    • 解锁组件时显示的标记
    注意

    将现成的​标题​组件添加到模板后,该组件会包含默认的文本​结构

    如果更改此文本,并添加自己的文本,则在使用该模板创建页面时,将会使用更新的文本。

    如果您保留默认文本(“结构”),则标题会默认使用后续生成页面的名称。

    注意

    将组件和资产添加到模板的操作与在页面创作时执行的类似操作虽然并不完全相同,但也存在许多相似之处。

  • 组件操作

    将组件添加到模板后,对组件执行操作。 每个实例都有一个用于访问可用操作的工具栏,该工具栏取决于组件类型。

    screen_shot_2018-03-23at120909

    显示的工具栏还会取决于执行的操作,例如将策略与组件关联后,便会显示设计配置图标。

  • 编辑和配置

    通过这两项操作,您可以在组件中添加内容。

  • 指示结构的边框

    在中工作时 结构 模式橙色边框表示当前选择的组件。 虚线还指示父组件。

    例如,在下面的屏幕快照中 文本 组件已选取,位于 布局容器 (响应网格)。

    chlimage_1-134

  • 策略和属性(常规)

    内容(或设计)策略定义组件的设计属性。 例如,可用元件或最小/最大尺寸。 这些选项适用于模板(以及使用模板创建的页面)。

    可为组件创建内容策略或选择现有策略。这允许您定义设计详细信息。

    chlimage_1-135 chlimage_1-136

    配置窗口分为两个部分。

    • 在对话框左侧的​策略​下方,您能够创建新策略或选择现有策略。
    • 在对话框右侧的​属性​下方,您可以设置特定于组件类型的属性。

    可用的属性取决于所选的组件。 例如,对于文本组件,属性定义了复制和粘贴选项、格式设置选项以及段落样式等选项。

    策略

    内容(或设计)策略定义组件的设计属性。 例如,可用元件或最小/最大尺寸。 这些选项适用于模板(以及使用模板创建的页面)。

    在​策略​下方,您可以通过下拉列表选择要应用于组件的现有策略。

    chlimage_1-137

    此外,也可以通过选择​选择策略​下拉列表旁边的“添加”按钮,来添加新策略。然后,应该在​策略标题​字段中输入一个新标题。

    chlimage_1-138

    使用​选择策略​下拉列表旁边的“复制”按钮,可复制在此下拉列表中选定的现有策略以将其作为新策略。然后,应该在​策略标题​字段中输入一个新标题。默认情况下,复制的策略的标题将为 X 的副本,其中 X 是被复制的策略的标题。

    chlimage_1-139

    策略说明​字段中的策略说明是可选的。

    在​同时使用该选定策略的其他模板​部分中,您可以轻松地查看同时也使用了​选择策略​下拉列表中的选定策略的其他模板。

    chlimage_1-140

    注意

    如果将同一类型的多个组件添加为初始内容,则同一策略适用于所有这些组件。这会镜像中的相同限制 设计模式 用于静态模板.

    属性

    属性 标题可定义组件的设置。 标题包含两个选项卡:

    • 主要
    • 功能

    主要

    主要 选项卡中,定义了组件最重要的设置。

    例如,对于图像组件,可以定义允许的宽度并启用延迟加载。

    如果某个设置允许多项配置,请单击或点按 添加 按钮以添加其他配置。

    chlimage_1-141

    要删除配置,请单击或点按位于配置右侧的​删除​按钮。

    要删除配置,请单击或点按​删除​按钮。

    chlimage_1-142

    功能

    功能 选项卡允许您启用或禁用组件的其他功能。

    例如,对于图像组件,您可以定义裁剪比例、允许的图像方向以及允许上载的情况。

    chlimage_1-143

    注意

    请注意,在 AEM 中,裁剪比例被定义为​高宽比。这与常见的宽高比的定义不同,这样做是出于对旧版兼容性的考虑。只要您清楚地定义​名称,页面创作用户便不会察觉到任何差异,因为您定义的名称才是 UI 中显示的内容。

    注意

    🔗只能为 RTE 通过其 UI 设置提供的选项定义用于实施富文本编辑器的组件的内容策略。 🔗 🔗

  • 策略和属性(布局容器)

    布局容器的策略和属性设置与常规用法相似,但存在一些差异。

    注意

    对于容器组件而言,必须配置策略,因为它允许您定义将在容器中可用的组件。

    配置窗口分为两部分,就像在窗口的常规用法中一样。

    策略

    内容(或设计)策略定义组件的设计属性。 例如,可用元件或最小/最大尺寸。 这些选项适用于模板(以及使用模板创建的页面)。

    在​策略​下方,您可以通过下拉列表选择要应用于组件的现有策略。此操作方式与该窗口的常规用法相同。

    属性

    属性 标题您可以选择可用于布局容器的组件并定义其设置。 标题有三个选项卡:

    • 允许的组件
    • 默认组件
    • 响应式设置

    允许的组件

    允许的组件 选项卡中,您可以定义哪些组件可用于布局容器。

    • 组件按其组件组进行分组,这些组件组可展开和折叠。
    • 通过选中组名可选择整个组,通过取消选中可取消选择所有组。
    • 减号表示至少选择了一个项目,但并非选择组中的所有项目。
    • 搜索可用于按名称筛选组件。
    • 无论是否应用了过滤器,组件组名称右侧列出的数字都表示这些组中选定组件的总数。

    chlimage_1-144

    默认组件

    默认组件 选项卡,您可以定义哪些组件自动与给定媒体类型关联,以便作者从资产浏览器拖动资产时,AEM知道要将资产与哪个组件关联。 请注意,只有具有拖放区域的组件才可用于此类配置。

    单击或点按 添加映射 添加全新的组件和MIME类型映射。

    在列表中选择一个组件,然后单击或点按 添加类型 ,以向已映射的组件添加其他MIME类型。 单击​删除​图标可删除 MIME 类型。

    chlimage_1-145

    响应式设置

    在​响应式设置​选项卡上,您可以配置布局容器的生成网格中的列数。

  • 解锁/锁定组件

    您可以解锁/锁定组件,以定义内容是否可用于更改 初始内容 模式。

    解锁组件后:

    • 打开的挂锁指示器显示在边框中。

    • 相应地对组件工具栏进行调整。

    • 任何已输入的内容将不再显示于 结构 模式。

      • 已输入的内容会被视为初始内容,因此仅在​初始内容​模式下可见。
    • 无法移动、剪切或删除已解锁组件的父组件。

    chlimage_1-146

    这包括解锁容器组件,以便在初始内容模式或生成的页面 中添加其他组件 。 如果在解锁容器之前已将组件/内容添加到容器,则这些组件/内容在结构模式下不再显示,但将以初始内容模式 显示 。 在​“结构”模式​下,只会显示容器组件本身,及其​允许的组件​列表。

    chlimage_1-147

    为了节省空间,布局容器不会扩大来容纳允许的组件列表。相反,容器会变成一个可滚动的列表。

    可配置的组件会显示一个 策略图标,单击或点按该图标可编辑该组件的策略和属性。

    chlimage_1-148

  • 与现有页面的关系

    如果在基于模板创建页面后更新了模板的结构,则这些页面会反映对模板所做的更改。工具栏中会显示一条警告消息,提醒您这一事实,同时还会显示确认对话框。

    chlimage_1-149

编辑模板 – 初始内容 – 作者

初始内容 模式用于定义首次根据模板创建页面时显示的内容。 随后,页面作者可以编辑初始内容。

虽然在​结构​模式下创建的所有内容在​初始内容​模式下均可见,但只能选择和编辑已解锁的组件。

注意

可以将​初始内容​模式视为使用模板创建的页面的编辑模式。因此,策略不是在​初始内容​模式下定义的,而是在​结构​模式下定义的。

  • 可编辑的已解锁组件将被标记。 选中后,它们具有蓝色边框:

    chlimage_1-150

  • 已解锁组件的工具栏允许您编辑和配置内容:

    chlimage_1-151

  • 如果已将某个容器组件解锁(在​结构​模式下),则您可以将新组件添加到该容器(在​初始内容​模式下)。可以在生成页面上移动或删除在​初始内容​模式下添加的组件。

    您可以通过以下两种方式添加组件:使用​将组件拖动到此处​区域,或使用相应容器工具栏中的​插入新组件​选项。

    chlimage_1-152 chlimage_1-153

  • 如果在基于模板创建页面后更新了模板的初始内容,则对模板的初始内容所做的更改不会影响这些页面。

注意

初始内容用于准备用作创建内容起点的组件和页面布局。 它不是将保持原样的实际内容。 因此,无法翻译初始内容。

如果需要在模板中包括可翻译文本(如在页眉或页脚中),则可以使用核心组件的本地化功能

编辑模板 – 布局 – 模板作者

您可以为各种设备定义模板布局。模板的响应式布局与页面创作时的响应式布局功能相同。

注意

初始内容​模式会反映布局更改,而​结构​模式则不会反映任何布局更改。

chlimage_1-154

编辑模板 — 页面设计 — 模板作者/开发人员

页面设计(包括所需的客户端库和页面策略)在“页面信息”菜单的“页 面设计 ”选项下 进行维护

要访问 页面设计 对话框:

  1. 模板编辑器,选择 页面信息 从工具栏中,然后 页面设计 以打开对话框。

  2. 页面设计 随即会打开对话框,该对话框分为两个部分:

    chlimage_1-155

页面策略

您可以将内容策略应用于模板或生成页面。这会为页面上的主要段落系统定义内容策略。

chlimage_1-156

  • 您可以从​选择策略​下拉列表中为页面选择现有策略。

    chlimage_1-157

    此外,也可以通过选择​选择策略​下拉列表旁边的“添加”按钮,来添加新策略。然后,应该在​策略标题​字段中输入一个新标题。

    chlimage_1-158

    使用​选择策略​下拉列表旁边的“复制”按钮,可复制在此下拉列表中选定的现有策略以将其作为新策略。然后,应该在​策略标题​字段中输入一个新标题。默认情况下,复制的策略的标题将为 X 的副本,其中 X 是被复制的策略的标题。

    chlimage_1-159

  • 在​策略标题​字段中定义策略的标题。策略需要具有标题,以便能够轻松地在​选择策略​下拉列表中对其进行选择。

    chlimage_1-160

  • 策略说明​字段中的策略说明是可选的。

  • 在​同时使用该选定策略的其他模板​部分中,您可以轻松地查看同时也使用了​选择策略​下拉列表中的选定策略的其他模板。

    chlimage_1-161

页面属性

使用​页面设计​对话框中的页面属性,您可以定义所需的客户端库。这些客户端库包含要与模板以及使用该模板创建的页面一起加载的样式表和 JavaScript。

chlimage_1-162

  • 指定要应用于使用此模板创建的页面的客户端库。 在的文本字段中输入库的名称 客户端库 部分。

    chlimage_1-163

  • 如果需要多个库,请单击“添加”按钮,以添加更多用于填写库名称的文本字段。

    chlimage_1-164

    为您的客户端库添加所需数量的文本字段。

    chlimage_1-165

  • 通过使用拖动手柄拖动字段,根据需要定义库的相对位置。

    chlimage_1-166

注意

虽然模板作者可以在模板上指定页面策略,但是他们需要从开发人员处获取相应客户端库的详细信息。

编辑模板 – 初始页面属性 – 作者

使用​初始页面属性​选项,您可以定义要在创建生成页面时使用的初始页面属性

  1. 在模板编辑器中,从工具栏中选择​页面信息,然后选择​初始页面属性​以打开相应的对话框。

  2. 在该对话框中,您可以定义要对使用此模板创建的页面应用的属性。

    chlimage_1-167

  3. 通过以下方式确认您的定义 完成.

最佳实践

在创建模板时,您应该考虑:

  1. 从模板创建页面后对模板进行更改的影响。

    下面列出了对模板可能执行的不同操作,以及这些操作对根据这些操作创建的页面有何影响:

    • 对结构的更改:

      • 这些操作会立即应用于生成的页面。
      • 访客仍需要发布更改的模板,才能看到所做的更改。
    • 对内容策略和设计配置的更改:

      • 这些规则将立即应用于生成页面。
      • 访客需要发布更改才能查看更改。
    • 对初始内容的更改:

      • 这些选项仅适用于对模板进行更改后创建的页面。
    • 布局更改取决于修改的组件是否属于以下组件:

      • 仅结构 — 立即应用
      • 包含初始内容 — 仅在更改后创建的页面上

    在下列情况下,请特别注意:

    • 在启用的模板上锁定或解锁组件。

    • 这会带来一些副作用,因为现有页面已可以使用该功能。 通常:

      • 现有页面上将缺少解锁组件(已锁定)的功能。
      • 锁定组件(可编辑)会隐藏该内容,使其无法在页面上显示。
    注意

    在不再是草稿的模板上更改组件的锁定状态时,AEM会给出显式警告。

  2. 创建您自己的文件夹 特定站点模板的位置。

  3. 发布模板模板 控制台。

在此页面上