创建页面模板

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

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

在​“模板”控制台​中,模板作者可以执行以下操作:

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

在​模板编辑器​中,模板作者可以执行以下操作:

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

本文档将介绍​模板作者​如何使用“模板”控制台和模板编辑器来创建和管理可编辑的模板。

For detailed information about how editable templates work at a technical level, please see the developer document Page Templates for more information.

注意

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

开始之前

注意

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

在开始之前,请务必考虑到创建新模板需要多方协作。因此,为每项任务指明了对应的角色。这并不会影响您使用模板来创建页面的实际操作方式,但却会影响页面与模板之间的关系。

角色

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

  • 管理员
    • 创建新的模板文件夹需要 admin 权限。
    • 此类任务通常可由开发人员完成。
  • 开发人员
    • 专注于技术/内部细节。
    • 需要具有开发环境方面的经验。
    • 为模板作者提供必要信息。
  • 模板作者
    • 特定的作者,template-authors 组中的一个成员。
      • 可分配所需的权限和许可。
    • 可配置组件的使用及其他高级详细信息,因而需要掌握以下内容:
      • 一些技术知识。
        • 例如,会在定义路径时使用模式。
      • 由开发人员提供的技术信息。

鉴于某些任务(例如创建文件夹)的特定性质,需要用到开发环境,这又需要具备一定的知识/经验。

本文档详细介绍的任务列有负责执行这些任务的角色。

创建和管理模板

创建新的可编辑模板时,您需要执行以下步骤:

  • 使用​模板​控制台。此控制台可从​工具​控制台的​常规​部分访问。
    • 或直接从以下网站进行访问:https://<host>:<port>/libs/wcm/core/content/sites/templates.html/conf
  • 如有必要,可以创建模板文件夹
  • 创建新模板,新模板最初是空的
  • 如有必要,为该模板定义其他属性
  • 编辑该模板,以定义以下各项:
    • 结构 - 不能在使用该模板创建的页面上更改的预定义内容。
    • 初始内容 - 能够在使用该模板创建的页面上更改的预定义内容。
    • 布局 - 针对各种设备。
    • 样式 - 定义要用于该模板及其组件的样式。
  • 启用该模板,以在创建页面时使用
  • 允许该模板用于您网站的所需页面或分支
  • 发布该模板,以使其可用于发布环境
注意

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

注意

切勿在模板中输入任何需要国际化的信息。

对于必须本地化的模板元素(如页眉和页脚),请利用核心组件的本地化功能。

创建模板文件夹 - 管理员

您应该为项目创建模板文件夹,以保存特定于项目的模板。This is an admin task and is described in the document Page Templates.–>

创建新模板 - 模板作者

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

    注意

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

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

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

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

    注意

    模板类型是预定义的模板布局,可将其视为模板的模板。模板类型是由开发人员或系统管理员预定义的。More information can be found in the developer document Page Templates.–>

  4. 填写​模板详细信息

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

    注意

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

定义模板属性 - 模板作者

模板可能具有以下属性:

  • 图像
    • 要用作模板的缩略图以帮助进行选择的图像,例如“创建页面”向导中的图像。
      • 可上传
      • 可根据模板内容生成
  • 标题
    • 用于标识模板的标题,例如​创建页面​向导中的标题。
  • 描述
    • 可选描述,用于提供更多有关模板及其用法的信息,例如​创建页面​向导中显示的描述。

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

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

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

模板缩略图图像

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

  1. 编辑模板属性。
  2. 选择是要上传缩略图,还是要从模板内容中生成缩略图。
    • 如果要上传缩略图,请单击或点按​上传图像
    • 如果要生成缩略图,请单击或点按​生成预览
  3. 使用上述两种方法时,系统都会显示缩略图预览。
    • 如果对缩略图不满意,请单击或点按​清除​以上传其他图像,或重新生成缩略图。
  4. 如果对缩略图满意,请单击或点按​保存并关闭

启用并允许模板 - 模板作者

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

启用模板 - 模板作者

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

注意

启用模板后,当模板作者开始进一步更新模板时,系统会显示一条警告消息。此消息用于告知用户,该模板可能已被引用,因此所做的任何更改可能会影响引用该模板的页面。

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

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

允许模板 - 作者

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

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

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

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

    路径可以是显式的,也可以使用模式。例如:

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

    路径的顺序无关紧要,所有路径都会经过扫描,任何模板都可以检索到。

    注意

    如果​允许的模板​列表为空,则树会向上追溯,直到找到值/列表。

    See Template Availability - the principles for allowed templates remain the same.

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

注意

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

发布模板 - 模板作者

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

  1. 在​模板控制台​中,选择相应的模板。
  2. 从工具栏中选择​发布​以打开向导。
  3. 选择要一同发布的​内容策略
  4. 从工具栏中选择​发布​以完成操作。

编辑模板 - 模板作者

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

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

模板编辑器模式选择器

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

模板编辑器页面信息

注意

如果作者开始编辑已经启用的模板,系统会显示一条警告消息。此消息用于告知用户,该模板可能已被引用,因此所做的任何更改可能会影响引用该模板的页面。

模板属性

可以编辑模板的以下属性:

结构

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

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

注意

在“结构”模式下,不能移动、剪切或删除已解锁组件的任何父组件。

初始内容

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

注意

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

布局

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

页面策略

页面策略可以将预定义的页面策略关联到页面。这些页面策略可定义各种设计配置。

样式

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

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

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

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

  • 不能在生成页面上移动在模板结构中定义的组件,也不能从任何生成页面中删除这些组件。
  • 如果要使页面作者能够添加和删除组件,请在模板中添加段落系统。
  • 可以解锁组件,然后再将其锁定,以便定义初始内容
  • 可为组件和页面定义设计策略。

模板编辑器页面结构

您可以在模板编辑器的​结构​模式中执行许多操作,并且有许多功能可协助您执行操作:

添加组件

可使用以下几种方法将组件添加到模板:

  • 从侧面板中的​组件​浏览器添加。
  • 使用模板中现有组件的工具栏上的​插入组件​选项,或使用​将组件拖动到此处​框。
  • 将资产(从侧面板中的​资产​浏览器)直接拖动到模板,以就地生成相应的组件。

添加后,每个组件会带有以下标记:

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

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

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

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

注意

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

组件操作

将组件添加到模板后,可以对其执行一些操作。每个实例都有其各自的工具栏,以供您访问可用的操作。显示的工具栏取决于组件类型。

模板组件的操作工具栏

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

编辑和配置

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

指示结构的边框

在​结构​模式下工作时,橙色边框指示当前选定的组件。虚线指示父组件。

策略和属性(常规)

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

可为组件创建内容策略或选择现有策略。

“内容策略”按钮

这允许您定义设计详细信息。

内容策略

配置窗口分为两个部分。

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

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

策略

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

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

选择策略

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

“添加策略”按钮

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

“复制策略”按钮

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

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

使用现有策略

注意

如果将同一类型的多个组件添加为初始内容,则同一策略适用于所有这些组件。

属性

在​属性​标题下方,您可以定义组件的设置。该标题包含两个选项卡:

  • 主要
  • 功能
主要

在​主要​选项卡上,可定义最重要的组件设置。

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

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

“添加”按钮

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

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

“删除”按钮

功能

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

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

“功能”选项卡

注意

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

注意

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

策略和属性(布局容器)

布局容器的策略和属性设置与常规用法类似,只存在些许不同之处。

注意

对于容器组件而言,必须配置策略,因为这样才能定义可在容器中使用的组件。

配置窗口分为两个部分,其使用方式与该窗口的常规用法相同。

策略

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

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

属性

在​属性​标题下方,您可以选择可用于布局容器的组件,并定义其设置。该标题包含三个选项卡:

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

在​允许的组件​选项卡上,您可以定义可用于布局容器的组件。

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

允许的组件选项卡

默认组件

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

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

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

“默认组件”选项卡

响应设置

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

解锁和锁定组件

通过解锁/锁定组件,您可以定义内容是否可在​初始内容​模式下进行更改。

解锁组件后:

  • 边框中会显示一个打开的挂锁指示符。
  • 组件工具栏会相应地做出调整。
  • 结构​模式将不再显示任何已输入的内容。
    • 已输入的内容会被视为初始内容,因此仅在​初始内容​模式下可见。
  • 无法移动、剪切或删除已解锁组件的父组件。

“锁定组件”按钮

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

允许的组件

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

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

“可配置组件”图标

与现有页面的关系

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

正在使用模板的横幅警告

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

初始内容​模式可用于定义最初基于模板创建页面后将显示的内容。页面作者随后可以编辑初始内容。

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

注意

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

  • 可编辑的已解锁组件带有标记。选定此类组件后,它们会显示一个蓝色边框:

    初始内容模式

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

    已解锁的组件

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

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

    添加组件
    添加组件

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

注意

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

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

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

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

注意

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

编辑模板布局

编辑模板 - 页面策略 - 模板作者/开发人员

将在​页面信息​菜单的​页面策略​选项下维护包含所需客户端库的页面策略。

要访问​页面策略​对话框,请执行以下操作:

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

  2. 随即会打开​页面策略​对话框,该对话框分成两个部分:

    页面设计

页面策略

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

页面策略

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

    策略选择器

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

    “添加策略”按钮

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

    “复制策略”按钮

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

    策略标题

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

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

    策略使用情况

页面属性

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

页面属性

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

    客户端库

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

    “添加”按钮

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

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

    拖动手柄

注意

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

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

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

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

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

    模板初始页面属性

  3. 单击​完成​以确认您的定义。

最佳实践

创建模板时,您应该考虑以下事项:

  1. 使用模板创建页面后,对模板所做的更改会影响这些页面。

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

    • 更改结构:

      • 此类更改会立即应用于生成页面。
      • 还需要发布已更改的模板,之后访客才能看见所做的更改。
    • 更改内容策略和设计配置:

      • 此类更改会立即应用于生成页面。
      • 需要发布所做的更改,之后访客才能看见这些更改。
    • 更改初始内容:

      • 此类更改只会应用于对模板进行更改后创建的页面。
    • 更改布局,具体影响取决于修改的组件属于以下哪种情况:

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

    在执行以下操作时,请务必要特别小心:

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

    • 这可能会产生不良后果,因为现有页面可能已在使用该组件。通常:

      • 解锁组件(之前已锁定)会使该组件从现有页面上缺失。
      • 锁定组件(之前可编辑)会隐藏相关内容,使其不在页面上显示。
    注意

    在已不再是草稿的模板上更改组件的锁定状态时,AEM 会显示明确的警告消息。

  2. 为特定于站点的模板创建您自己的文件夹

  3. 从​模板​控制台发布您的模板

在此页面上