创建页面模板 creating-page-templates
创建页面时,必须选择一个模板,该模板将用作创建新页面的基础。 模板可定义生成页面的结构、任何初始内容以及可使用的组件。
使用模 板编辑器,创建和维护模板不再只是开发人员的任务。 高级用户(称为模板作者 )也可能。 开发人员仍需要设置环境、创建客户端库和创建要使用的组件,但是,在这些基础知识到位后,模板作者就可以灵活地创建和配置模板,而无需开发项目。
的 “模板”控制台 允许模板作者执行以下操作:
- 创建新模板,或复制现有模板。
- 管理模板的生命周期。
的 模板编辑器 允许模板作者执行以下操作:
- 将组件添加到模板,并将它们放置在响应式网格上。
- 预先配置组件。
- 定义可以在使用该模板创建的页面上编辑的组件。
本文档介绍 模板作者 可以使用“模板”控制台和编辑器创建和管理可编辑的模板。
有关如何在技术层面使用可编辑模板的详细信息,请参阅开发人员文档 页面模板 — 可编辑 以了解更多信息。
开始之前 before-you-start
在开始之前,请务必考虑以下几点:
角色 roles
使用 “模板”控制台 和 模板编辑器 创建新模板需要以下角色之间的协作:
-
管理员:
- 创建新的模板文件夹需要
admin
权限。 - 此类任务通常也可由开发人员完成
- 创建新的模板文件夹需要
-
开发人员:
- 重点关注技术/内部细节
- 需要具有开发环境方面的经验。
- 为模板作者提供必要信息。
-
模板作者:
-
特定的作者,
template-authors
组中的一个成员。- 可分配所需的权限和许可。
-
可以配置组件的使用情况和其他高级详细信息,这些信息需要:
-
一些技术知识
- 例如,在定义路径时使用模式。
-
由开发人员提供的技术信息。
-
-
由于某些任务(如创建文件夹)的性质,需要开发环境,这需要知识/经验。
本文档中详细列出的任务以及负责执行这些任务的角色。
可编辑和静态模板 editable-and-static-templates
AEM现在提供两种基本类型的模板:
-
可编辑模板
-
静态模板
根据定义,模板控制台和模板编辑器仅允许创建和编辑可编辑的模板。 因此,本文档专门介绍可编辑的模板。
使用模板创建页面 using-a-template-to-create-a-page
使用模板 创建新页面 静态模板和可编辑模板之间没有明显差异,也没有任何指示。 对于页面作者而言,该过程是透明的。
创建和管理模板 creating-and-managing-templates
创建新可编辑的模板时,您可以:
创建模板文件夹 – 管理员 creating-a-template-folder-admin
您应该为项目创建模板文件夹,以保存特定于项目的模板。这是一项管理员任务,在文档中有相关说明 页面模板 — 可编辑.
创建新模板 – 模板作者 creating-a-new-template-template-author
-
打开 “模板”控制台 (通过 工具 -> 常规),然后导航到所需的文件夹。
note note NOTE 在标准 AEM 实例中,“模板”控制台中已存在 全局 文件夹。此文件夹会保存默认模板,如果在当前文件夹中没有找到策略和/或模板类型,则此文件夹可以充当备用。 建议最好使用 为项目创建的模板文件夹. -
选择 创建,然后选择 创建模板 以打开向导。
-
选择 模板类型,然后选择 下一个.
note note NOTE 模板类型是预定义的模板布局,可以视为模板的模板。 这些权限由开发人员或系统管理员预定义。 有关更多信息,请参阅开发人员文档 页面模板 — 可编辑. -
完成 模板详细信息:
- 模板名称
- 描述
-
选择 创建。随即会显示确认对话框,选择 打开🔗以开始编辑模板,或选择 完成 以返回到“模板”控制台。
note note NOTE 创建新模板后,会在控制台中将其标记为 草稿,这表示页面作者还不能使用此模板。
定义模板属性 — 模板作者 defining-template-properties-template-author
模板可以具有以下属性:
-
图像
-
要用作 模板缩略图 以帮助进行选择,例如在创建页面向导中。
- 可以上传
- 可以根据模板内容生成
-
-
标题
- 用于标识模板的标题,例如 创建页面 向导。
-
描述
- 可选描述,用于提供更多有关模板及其用法的信息,例如 创建页面 向导。
要查看和/或编辑属性,请执行以下操作:
- 在 模板控制台 中,选择相应的模板。
- 从工具栏或快速选项中选择 查看属性 以打开对话框。
- 此时您可以查看或编辑模板属性。
模板缩略图图像 template-thumbnail-image
要定义模板缩略图,请执行以下操作:
-
编辑模板属性。
-
选择是要上传缩略图,还是要从模板内容中生成缩略图。
- 如果要上传缩略图,请单击或点按 上传图像
- 如果要生成缩略图,请单击或点按 生成预览
-
对于这两种方法,将显示缩略图的预览。
如果不满意,请单击或点按 清除 上传其他图像或重新生成缩略图。
-
如果您对缩略图满意,请单击或点按 保存并关闭.
启用和允许模板 — 模板作者 enabling-and-allowing-a-template-template-author
为了能够在创建页面时使用模板,您需要执行以下操作:
启用模板 – 模板作者 enabling-a-template-template-author
可以启用或禁用模板,以使其在 创建页面 向导。
允许模板 – 作者 allowing-a-template-author
可以使模板可用于或不可用于某些页面分支。
发布模板 – 模板作者 publishing-a-template-template-author
由于渲染页面时会引用模板,因此模板在完全配置后需要进行发布,才能用于发布环境。
-
在 模板控制台 中,选择相应的模板。
-
从工具栏中选择 发布 以打开向导。
-
选择要一同发布的 内容策略。
-
选择 发布 来完成操作。
编辑模板 — 模板作者 editing-templates-template-authors
创建或编辑模板时,可以定义多个方面。 编辑模板与页面创作类似。
可以编辑模板的以下方面:
-
页面作者不能从生成页面中移动/删除在此处添加的组件。 如果希望页面作者能够向生成页面添加组件和删除组件,则需要向模板添加段落系统。
锁定组件后,您可以添加页面作者无法编辑的内容。 您可以解锁组件,以便定义 初始内容.
note note NOTE 在结构模式下,无法移动、剪切或删除任何已解锁组件的父组件。 -
解锁组件后,您可以定义要复制到生成页面(使用模板创建)的初始内容。可以在生成页面上编辑这些已解锁的组件。
note note NOTE 在 初始内容 模式下以及在生成页面上,可以删除任何具有可访问父项的已解锁组件(即,布局容器内的组件)。 -
在此,您可以为所需的设备格式预定义模板布局。 模板创作的 布局 模式与 页面创作的布局 模式具有相同的功能。
-
在页面策略下,您可以将预定义的页面策略连接到页面。 这些页面策略可定义各种设计配置。
-
样式系统允许模板作者在组件的内容策略中定义样式类,以便内容作者在页面上编辑组件时能够选择这些类。这些样式可以作为组件的替代可视化变量,从而使组件变得更加灵活。
有关更多信息,请参阅样式系统文档。
使用工具栏中的 模式 选择器,可以选择并编辑模板的相应方面:
而使用 页面信息 菜单中的 页面策略 选项,可以选择所需的页面策略:
编辑模板 – 结构 – 模板作者 editing-a-template-structure-template-author
在 结构 模式,为模板定义组件和内容,并为模板及其组件定义策略。
-
在模板结构中定义的组件不能在生成页面上移动,也不能从任何生成页面中删除。
-
如果希望页面作者能够添加和删除组件,请向模板添加段落系统。
-
可以解锁组件,然后再将其锁定,以便定义初始内容。
-
可为组件和页面定义设计策略。
在 结构 模板编辑器模式:
-
添加组件
可通过以下几种机制将组件添加到模板:
- 从 组件 浏览器。
- 通过使用 插入组件 选项(+ 图标),该图标可在模板中现有的组件工具栏上使用,或者 将组件拖动到此处 框中。
- 通过拖动资产(从 资产 浏览器)直接置于模板上以就地生成相应的组件。
添加后,每个组件都会标记:
- 边框
- 显示组件类型的标记
- 组件解锁后显示的标记
note note NOTE 将现成的 标题 组件添加到模板后,该组件会包含默认的文本 结构。 如果更改此文本,并添加自己的文本,则在使用该模板创建页面时,将会使用更新的文本。 如果您保留默认文本(“结构”),则标题会默认使用后续生成页面的名称。 note note NOTE 将组件和资产添加到模板的操作与在 页面创作. -
组件操作
将组件添加到模板后,对它们执行操作。 每个实例都有一个允许您访问可用操作的工具栏,该工具栏取决于组件类型。
显示的工具栏还会取决于执行的操作,例如将策略与组件关联后,便会显示设计配置图标。
-
编辑和配置
通过这两项操作,您可以在组件中添加内容。
-
指示结构的边框
在中工作时 结构 模式橙色边框表示当前选定的组件。 虚线还指示父组件。
例如,在下面的屏幕截图中, 文本 在 布局容器 (响应式网格)。
-
策略和属性(常规)
内容(或设计)策略可定义组件的设计属性。 例如,可用组件或最小/最大维度。 这些值适用于模板(以及使用该模板创建的页面)。
可为组件创建内容策略或选择现有策略。这允许您定义设计详细信息。
配置窗口分为两个部分。
- 在对话框左侧的 策略 下方,您能够创建新策略或选择现有策略。
- 在对话框右侧的 属性 下方,您可以设置特定于组件类型的属性。
可用属性取决于选定的组件。 例如,对于文本组件,属性定义了复制和粘贴选项、格式选项以及段落样式等其他选项。
策略
内容(或设计)策略可定义组件的设计属性。 例如,可用组件或最小/最大维度。 这些值适用于模板(以及使用该模板创建的页面)。
在 策略 下方,您可以通过下拉列表选择要应用于组件的现有策略。
此外,也可以通过选择 选择策略 下拉列表旁边的“添加”按钮,来添加新策略。然后,应该在 策略标题 字段中输入一个新标题。
使用 选择策略 下拉列表旁边的“复制”按钮,可复制在此下拉列表中选定的现有策略以将其作为新策略。然后,应该在 策略标题 字段中输入一个新标题。默认情况下,复制的策略的标题将为 X 的副本,其中 X 是被复制的策略的标题。
策略说明 字段中的策略说明是可选的。
在 同时使用该选定策略的其他模板 部分中,您可以轻松地查看同时也使用了 选择策略 下拉列表中的选定策略的其他模板。
note note NOTE 如果将同一类型的多个组件添加为初始内容,则同一策略适用于所有这些组件。这反映了 设计模式 (对于静态模板)。 属性
在 属性 标题。 标题包含两个选项卡:
- 主要
- 功能
主要
在 主要 选项卡中,定义了组件最重要的设置。
例如,对于图像组件,可以定义允许的宽度并启用延迟加载。
如果设置允许进行多个配置,请单击或点按 添加 按钮以添加其他配置。
要删除配置,请单击或点按位于配置右侧的 删除 按钮。
要删除配置,请单击或点按 删除 按钮。
功能
的 功能 选项卡,用于启用或禁用组件的其他功能。
例如,对于图像组件,您可以定义裁剪比例、允许的图像方向,以及是否允许上传。
note caution CAUTION 请注意,在 AEM 中,裁剪比例被定义为 高宽比。这与常规的宽度/高度定义不同,这是出于对旧版兼容性的考虑。 只要您清楚地定义 名称,页面创作用户便不会察觉到任何差异,因为您定义的名称才是 UI 中显示的内容。 note note NOTE 🔗只能为 RTE 通过其 UI 设置提供的选项定义用于实施富文本编辑器的组件的内容策略。 -
策略和属性(布局容器)
布局容器的策略和属性设置与常规用法类似,但有一些不同。
note note NOTE 对于容器组件,必须配置策略,因为它允许您定义将在容器中可用的组件。 配置窗口分为两个部分,与窗口的常规用法一样。
策略
内容(或设计)策略可定义组件的设计属性。 例如,可用组件或最小/最大维度。 这些值适用于模板(以及使用该模板创建的页面)。
在 策略 下方,您可以通过下拉列表选择要应用于组件的现有策略。此操作方式与该窗口的常规用法相同。
属性
在 属性 标题,您可以选择可用于布局容器的组件并定义其设置。 标题包含三个选项卡:
- 允许的组件
- 默认组件
- 响应式设置
允许的组件
在 允许的组件 选项卡,可定义可用于布局容器的组件。
- 这些组件按其组件组进行分组,这些组件组可以展开和折叠。
- 通过勾选组名称可以选择整个组,通过取消选中可取消选择所有组。
- 减号表示至少选择了组中的一个项目,但并非选择了组中的所有项目。
- 可通过搜索按名称筛选组件。
- 无论是否应用了过滤器,组件组名称右侧列出的数字都表示这些组中选定组件的总数。
默认组件
在 默认组件 选项卡,您可以定义与给定媒体类型自动关联的组件,以便作者从资产浏览器中拖动资产时,AEM知道要将资产与哪个组件关联。 请注意,只有具有拖放区域的组件才可用于此类配置。
单击或点按 添加映射 添加全新的组件和MIME类型映射。
在列表中选择一个组件,然后单击或点按 添加类型 ,以向已映射的组件添加其他MIME类型。 单击 删除 图标可删除 MIME 类型。
响应式设置
在 响应式设置 选项卡上,您可以配置布局容器的生成网格中的列数。
-
解锁/锁定组件
您可以解锁/锁定组件以定义内容是否可在 初始内容 模式。
解锁组件后:
-
边框中显示一个打开的挂锁指示器。
-
组件工具栏将相应地进行调整。
-
已输入的任何内容将不再显示在 结构 模式。
- 已输入的内容会被视为初始内容,因此仅在 初始内容 模式下可见。
-
无法移动、剪切或删除已解锁组件的父组件。
这包括解锁容器组件,以便在初始内容模式或生成的页面 中添加其他组件 。 如果在解锁容器之前已将组件/内容添加到容器,则这些组件/内容在结构模式下不再显示,但将以初始内容模式 显示 。 在 “结构”模式 下,只会显示容器组件本身,及其 允许的组件 列表。
为了节省空间,布局容器不会扩大以容纳允许的组件列表。 容器而是变为可滚动列表。
可配置的组件会显示一个 策略图标,单击或点按该图标可编辑该组件的策略和属性。
-
-
与现有页面的关系
如果在基于模板创建页面后更新了模板的结构,则这些页面会反映对模板所做的更改。工具栏中会显示一条警告消息,提醒您这一事实,同时还会显示确认对话框。
编辑模板 – 初始内容 – 作者 editing-a-template-initial-content-author
初始内容 模式用于定义在首次基于模板创建页面时显示的内容。 然后,页面作者可以编辑初始内容。
虽然在 结构 模式下创建的所有内容在 初始内容 模式下均可见,但只能选择和编辑已解锁的组件。
-
标记可供编辑的已解锁组件。 选择后,它们将显示蓝色边框:
-
已解锁组件的工具栏允许您编辑和配置内容:
-
如果已将某个容器组件解锁(在 结构 模式下),则您可以将新组件添加到该容器(在 初始内容 模式下)。可以在生成页面上移动或删除在 初始内容 模式下添加的组件。
您可以通过以下两种方式添加组件:使用 将组件拖动到此处 区域,或使用相应容器工具栏中的 插入新组件 选项。
-
如果在基于模板创建页面后更新了模板的初始内容,则对模板的初始内容所做的更改不会影响这些页面。
编辑模板 – 布局 – 模板作者 editing-a-template-layout-template-author
您可以为各种设备定义模板布局。模板的响应式布局与页面创作时的响应式布局功能相同。
编辑模板 — 页面设计 — 模板作者/开发人员 editing-a-template-page-design-template-author-developer
页面设计(包括所需的客户端库和页面策略)在“页面信息”菜单的“页 面设计 ”选项下 进行维护 。
访问 页面设计 对话框:
页面策略 page-policies
您可以将内容策略应用于模板或生成页面。这会为页面上的主要段落系统定义内容策略。
-
您可以从 选择策略 下拉列表中为页面选择现有策略。
此外,也可以通过选择 选择策略 下拉列表旁边的“添加”按钮,来添加新策略。然后,应该在 策略标题 字段中输入一个新标题。
使用 选择策略 下拉列表旁边的“复制”按钮,可复制在此下拉列表中选定的现有策略以将其作为新策略。然后,应该在 策略标题 字段中输入一个新标题。默认情况下,复制的策略的标题将为 X 的副本,其中 X 是被复制的策略的标题。
-
在 策略标题 字段中定义策略的标题。策略需要具有标题,以便能够轻松地在 选择策略 下拉列表中对其进行选择。
-
策略说明 字段中的策略说明是可选的。
-
在 同时使用该选定策略的其他模板 部分中,您可以轻松地查看同时也使用了 选择策略 下拉列表中的选定策略的其他模板。
页面属性 page-properties
使用 页面设计 对话框中的页面属性,您可以定义所需的客户端库。这些客户端库包含要与模板以及使用该模板创建的页面一起加载的样式表和 JavaScript。
-
指定要应用于使用此模板创建的页面的客户端库。 在 客户端库 中。
-
如果需要多个库,请单击“添加”按钮,以添加更多用于填写库名称的文本字段。
为您的客户端库添加所需数量的文本字段。
-
通过使用拖动手柄拖动字段,根据需要定义库的相对位置。
编辑模板 – 初始页面属性 – 作者 editing-a-template-initial-page-properties-author
使用 初始页面属性 选项,您可以定义要在创建生成页面时使用的初始页面属性。
-
在模板编辑器中,从工具栏中选择 页面信息,然后选择 初始页面属性 以打开相应的对话框。
-
在该对话框中,您可以定义要对使用此模板创建的页面应用的属性。
-
通过确认您的定义 完成.
最佳实践 best-practices
在创建模板时,您应考虑:
-
从模板创建页面后对模板所做的更改会对模板产生影响。
以下是对模板可能执行的不同操作的列表,以及这些操作对模板创建的页面有何影响:
-
结构更改:
- 这些值会立即应用于生成的页面。
- 访客仍需要发布已更改的模板才能查看更改。
-
内容策略和设计配置的更改:
- 这些操作会立即应用于生成页面。
- 需要发布更改,访客才能查看更改。
-
对初始内容的更改:
- 这些规则仅适用于在对模板进行更改后创建的页面。
-
布局的更改取决于修改的组件是否属于以下内容的一部分:
- 仅限结构 — 立即应用
- 包含初始内容 — 仅在更改后创建的页面上
在以下情况下请特别注意:
-
锁定或解锁已启用模板上的组件。
-
这可能会产生副作用,因为现有页面可能已在使用它。 通常:
- 解锁组件(已锁定)的组件在现有页面上将丢失。
- 锁定组件(之前可编辑)将隐藏该内容,使其不会显示在页面上。
note note NOTE AEM在不再为草稿的模板上更改组件的锁定状态时会显式发出警告。 -
-
创建您自己的文件夹 ,以访问特定于网站的模板。
-
发布模板 从 模板 控制台。