创建页面模板 creating-page-templates
创建页面时,必须选择一个模板,该模板用作创建新页面的基础。 模板可定义生成页面的结构、任何初始内容以及可使用的组件。
使用模 板编辑器,创建和维护模板不再只是开发人员的任务。高级用户(称为模板作者 )也可能。开发人员仍需要设置环境、创建客户端库和创建要使用的组件,但是,在这些基础知识到位后,模板作者就可以灵活地创建和配置模板,而无需开发项目。
在 “模板”控制台 中,模板作者可以执行以下操作:
- 创建模板或复制现有模板。
- 管理模板的生命周期。
在 模板编辑器 中,模板作者可以执行以下操作:
- 将组件添加到模板并将它们置于响应式网格上。
- 预先配置组件。
- 定义可在使用模板创建的页面上编辑的组件。
本文档将介绍 模板作者 如何使用“模板”控制台和模板编辑器来创建和管理可编辑的模板。
有关如何在技术层面使用可编辑模板的详细信息,请参阅开发人员文档页面模板 — 可编辑以了解更多信息。
开始之前 before-you-start
在开始之前,请务必考虑以下几点:
-
创建模板需要协作。 因此,为每项任务指明了角色。
-
根据实例的配置方式,AEM现在提供了两种基本类型的模板。 这不会影响您实际如何使用模板创建页面,但会影响您可以创建的模板类型以及页面与其模板的关系。
角色 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 将组件和资源添加到模板的操作与在页面创作时执行的类似操作虽然并不完全相同,但也存在许多相似之处。 -
-
组件操作
将组件添加到模板后,可以对其执行一些操作。每个实例都有其各自的工具栏,以供您访问可用的操作。显示的工具栏取决于组件类型。
显示的工具栏还会取决于执行的操作,例如将策略与组件关联后,便会显示设计配置图标。
-
编辑和配置
通过这两项操作,您可以在组件中添加内容。
-
边框表示结构
在 结构 模式下工作时,橙色边框指示当前选定的组件。虚线指示父组件。
例如,在 Text 组件下面的屏幕快照中,在 布局容器 (responsivegrid)中选择了。
-
策略和属性(常规)
内容(或设计)策略可定义组件的设计属性。例如,可用的组件或最小/最大尺寸。这些属性适用于模板(和使用模板创建的页面)。
为组件创建内容策略或选择现有策略。 这让您定义设计详细信息。
配置窗口分为两个部分。
- 在对话框左侧的 策略 下方,您能够创建新策略或选择现有策略。
- 在对话框右侧的 属性 下方,您可以设置特定于组件类型的属性。
可用的属性取决于选定的组件。例如,对于文本组件,属性定义了复制和粘贴选项、格式设置选项以及段落样式等选项。
策略
内容(或设计)策略可定义组件的设计属性。例如,可用的组件或最小/最大尺寸。这些属性适用于模板(和使用模板创建的页面)。
在 策略 下方,您可以通过下拉列表选择要应用于组件的现有策略。
此外,也可以通过选择 选择策略 下拉列表旁边的“添加”按钮,来添加新策略。然后,应该在 策略标题 字段中输入一个新标题。
使用 选择策略 下拉列表旁边的“复制”按钮,可复制在此下拉列表中选定的现有策略以将其作为新策略。然后,应该在 策略标题 字段中输入一个新标题。默认情况下,复制的策略的标题将为 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 会显示明确的警告消息。 -
-
为特定于站点的模板创建您自己的文件夹。
-
从 模板 控制台发布您的模板。