创建页面模板 creating-page-templates
创建页面时,您必须选择一个模板,以用作创建新页面的基础。模板可定义生成页面的结构、任何初始内容以及可使用的组件。
使用模 板编辑器,创建和维护模板不再只是开发人员的任务。高级用户(称为模板作者 )也可能。开发人员仍需要设置环境、创建客户端库和创建要使用的组件,但是,在这些基础知识到位后,模板作者就可以灵活地创建和配置模板,而无需开发项目。
在 “模板”控制台 中,模板作者可以执行以下操作:
- 创建新模板,或复制现有模板。
- 管理模板的生命周期。
在 模板编辑器 中,模板作者可以执行以下操作:
- 将组件添加到模板并将它们置于响应式网格上。
- 预先配置组件。
- 定义可在使用模板创建的页面上编辑的组件。
本文档将介绍 模板作者 如何使用“模板”控制台和模板编辑器来创建和管理可编辑的模板。
有关如何在技术层面使用可编辑模板的详细信息,请参阅开发人员文档页面模板以了解更多信息。
开始之前 before-you-start
在开始之前,请务必考虑创建模板需要协作。 因此,为每项任务指明了对应的角色。这并不会影响您使用模板来创建页面的实际操作方式,但却会影响页面与模板之间的关系。
角色 roles
使用 “模板”控制台 和 模板编辑器 创建新模板需要以下角色之间的协作:
-
管理员:
- 创建新的模板文件夹需要
admin
权限。 - 此类任务通常可由开发人员完成。
- 创建新的模板文件夹需要
-
开发人员:
- 专注于技术/内部细节。
- 需要具有开发环境方面的经验。
- 为模板作者提供必要信息。
-
模板作者:
-
特定的作者,
template-authors
组中的一个成员。- 可分配所需的权限和许可。
-
可配置组件的使用及其他高级详细信息,因而需要掌握以下内容:
- 一些技术知识。
- 例如,会在定义路径时使用模式。
- 由开发人员提供的技术信息。
- 一些技术知识。
-
鉴于某些任务(例如创建文件夹)的特定性质,需要用到开发环境,这又需要具备一定的知识/经验。
本文档详细介绍的任务列有负责执行这些任务的角色。
创建和管理模板 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
创建或编辑模板时,您可以定义模板的多个方面。编辑模板类似于页面创作。
使用工具栏中的 模式 选择器,可以选择并编辑模板的相应方面:
而使用 页面信息 菜单中的 页面策略 选项,可以选择所需的页面策略:
模板属性 template-attributes
可以编辑模板的以下属性:
结构 template-structure
页面作者不能从生成页面中移动/删除添加到结构的组件。如果要使页面作者能够在生成页面中添加和删除组件,则需要在模板中添加段落系统。
将组件锁定后,您可以添加页面作者无法编辑的内容。您可以解锁组件,以便能够定义初始内容。
初始内容 template-initial-content
解锁组件后,您可以定义复制到生成页面(使用模板创建)的初始内容。可以在生成页面上编辑这些已解锁的组件。
布局 template-layout
通过布局,您可以预定义所需设备格式的模板布局。模板创作的 布局 模式与页面创作的布局 模式具有相同的功能。
页面策略 template-page-policies
页面策略可以将预定义的页面策略关联到页面。这些页面策略可定义各种设计配置。
样式 template-styles
样式系统允许模板作者在组件的内容策略中定义样式类,以便内容作者在页面上编辑组件时能够选择这些类。这些样式可以作为组件的替代可视化变量,从而使组件变得更加灵活。
有关详细信息,请参阅样式系统文档。
编辑模板 – 结构 – 模板作者 editing-a-template-structure-template-author
在 结构 模式下,您可以为模板定义组件和内容,并为模板及其组件定义策略。
- 不能在生成页面上移动在模板结构中定义的组件,也不能从任何生成页面中删除这些组件。
- 如果要使页面作者能够添加和删除组件,请在模板中添加段落系统。
- 可以解锁组件,然后再将其锁定,以便定义初始内容。
- 可为组件和页面定义设计策略。
在模板编辑器的 结构 模式下,您可以执行一些操作,并且可以使用一些功能来帮助您:
添加组件 add-components
可使用以下几种方法将组件添加到模板:
- 从侧面板中的 组件 浏览器添加。
- 使用模板中现有组件的工具栏上的 插入组件 选项,或使用 将组件拖动到此处 框。
- 将资源(从侧面板中的 资源 浏览器)直接拖动到模板,以就地生成相应的组件。
添加后,每个组件会带有以下标记:
- 边框
- 显示组件类型的标记
- 组件解锁后显示的标记
组件操作 component-actions
将组件添加到模板后,可以对其执行一些操作。每个实例都有其各自的工具栏,以供您访问可用的操作。显示的工具栏取决于组件类型。
显示的工具栏还会取决于执行的操作,例如将策略与组件关联后,便会显示设计配置图标。
编辑和配置 edit-and-configure
通过这两项操作,您可以在组件中添加内容。
指示结构的边框 border-to-indicate-structure
在 结构 模式下工作时,橙色边框指示当前选定的组件。虚线指示父组件。
策略和属性(常规) policy-and-properties-general
内容(或设计)策略可定义组件的设计属性。例如,可用的组件或最小/最大尺寸。这些属性适用于模板(和使用模板创建的页面)。
可为组件创建内容策略或选择现有策略。
这让您定义设计详细信息。
配置窗口分为两个部分。
- 在对话框左侧的 策略 下,您可以选择现有策略或选择现有策略。
- 在对话框右侧的 属性 下,您可以设置特定于组件类型的属性。
可用的属性取决于选定的组件。例如,对于文本组件,属性定义的是复制和粘贴选项、格式选项以及段落样式,等等。
策略 policy
内容(或设计)策略可定义组件的设计属性。例如,可用的组件或最小/最大尺寸。这些属性适用于模板(和使用模板创建的页面)。
在 策略 下,您可以通过下拉列表选择要应用于该组件的现有策略。
通过选择 选择策略 下拉列表旁边的“添加”按钮,可以添加新策略。 在 策略标题 字段中提供一个新标题。
可以使用 选择策略 下拉列表旁边的“复制”按钮,复制该下拉列表中选定的现有策略以将其作为新策略。 在 策略标题 字段中提供一个新标题。 默认情况下,复制的策略的标题为 X 的副本,其中 X 是被复制的策略的标题。
策略说明 字段中的策略说明是可选的。
在 同时使用选定策略 的其他模板部分中,您可以轻松地查看哪些其他模板使用了 选择策略 下拉列表中的选定策略。
属性 properties
在 属性 标题下方,您可以定义组件的设置。该标题包含两个选项卡:
- 主要
- 功能
主要 main
在 主要 选项卡上,可定义最重要的组件设置。
例如,对于图像组件,可定义允许的宽度,并启用延迟加载。
如果某个设置允许多个配置,请选择 添加 按钮以添加其他配置。
要删除配置,请选择位于配置右侧的 删除 按钮。
要删除配置,请选择 删除 按钮。
功能 features
功能 选项卡让您启用或禁用组件的其他功能。
例如,对于图像组件,您可以定义裁剪比例、允许的图像方向,以及是否允许上传。
策略和属性(布局容器) policy-and-properties-layout-container
布局容器的策略和属性设置与常规用法类似,只存在些许不同之处。
配置窗口分为两个部分,其使用方式与该窗口的常规用法相同。
策略 policy-layout
内容(或设计)策略可定义组件的设计属性。例如,可用的组件或最小/最大尺寸。这些属性适用于模板(和使用模板创建的页面)。
在 策略 下方,您可以通过下拉列表选择要应用于组件的现有策略。此操作方式与该窗口的常规用法相同。
属性 properties-layout
在 属性 标题下方,您可以选择可用于布局容器的组件,并定义其设置。该标题包含三个选项卡:
- 允许的组件
- 默认组件
- 响应式设置
允许的组件 allowed-components
在 允许的组件 选项卡上,您可以定义可用于布局容器的组件。
- 这些组件按其组件组分组,各组可以展开和折叠。
- 可以通过选中组名称选择整个组,通过取消选中全部取消选择。
- 减号表示至少选中了组中的一个而并非所有项目。
- 可按名称进行搜索来筛选组件。
- 无论是否应用了过滤器,组件组名称右侧列出的数字都表示这些组中选定组件的总数。
默认组件 default-components
在 默认组件 选项卡上,您可以定义要自动与给定媒体类型关联的组件,以便作者从资源浏览器中拖动资源时,AEM 知道要将其与哪个组件关联。只有具有放置区域的组件才可用于此类配置。
选择 添加映射 以添加全新的组件和MIME类型映射。
在列表中选择一个组件并选择 添加类型 以向已映射的组件添加其他MIME类型。 单击 删除 图标可删除 MIME 类型。
响应式设置 responsive-settings
在 响应式设置 选项卡上,您可以配置布局容器的生成网格中的列数。
解锁和锁定组件 unlock-and-lock-components
通过解锁/锁定组件,您可以定义内容是否可在 初始内容 模式下进行更改。
解锁组件后:
- 边框中会显示一个打开的挂锁指示符。
- 组件工具栏会相应地做出调整。
- 结构 模式将不再显示任何已输入的内容。
- 已输入的内容会被视为初始内容,因此仅在 初始内容 模式下可见。
- 无法移动、剪切或删除已解锁组件的父组件。
这包括解锁容器组件,以便在 初始内容 模式或生成的页面中添加其他组件。如果在解锁容器之前已将组件/内容添加到容器,则这些组组件/内容在 结构 模式下不再显示,但会以 初始内容 模式显示。在 “结构”模式 下,只会显示容器组件本身,及其 允许的组件 列表。
为了节省空间,布局容器不会扩大来容纳允许的组件列表。容器而是会变为一个可滚动的列表。
可配置的组件会显示一个 策略图标,单击或点按该图标可编辑该组件的策略和属性。
与现有页面的关系 relationship-to-existing-pages
如果在基于模板创建页面后更新了模板的结构,则这些页面会反映对模板所做的更改。工具栏中会显示一条警告消息,提醒您这一事实,同时还会显示确认对话框。
编辑模板 – 初始内容 – 作者 editing-a-template-initial-content-author
初始内容 模式可用于定义最初基于模板创建页面后将显示的内容。页面作者随后可以编辑初始内容。
虽然在 结构 模式下创建的所有内容在 初始内容 模式下均可见,但只能选择和编辑已解锁的组件。
-
可编辑的已解锁组件带有标记。选定此类组件后,它们会显示一个蓝色边框:
-
已解锁组件的工具栏允许您编辑和配置内容:
-
如果已将某个容器组件解锁(在 结构 模式下),则您可以将新组件添加到该容器(在 初始内容 模式下)。可以在生成页面上移动或删除在 初始内容 模式下添加的组件。
您可以通过以下两种方式添加组件:使用 将组件拖动到此处 区域,或使用相应容器工具栏中的 插入新组件 选项。
-
如果在基于模板创建页面后更新了模板的初始内容,则对模板的初始内容所做的更改不会影响这些页面。
编辑模板 – 布局 – 模板作者 editing-a-template-layout-template-author
您可以为各种设备定义模板布局。模板的响应式布局与页面创作时的响应式布局功能相同。
编辑模板 – 页面策略 – 模板作者/开发人员 editing-a-template-page-policy-template-author-developer
将在 页面信息 菜单的 页面策略 选项下维护包含所需客户端库的页面策略。
要访问 页面策略 对话框,请执行以下操作:
页面策略 page-policies
您可以将内容策略应用于模板或生成页面。这会为页面上的主要段落系统定义内容策略。
-
您可以从 选择策略 下拉列表中为页面选择现有策略。
通过选择 选择策略 下拉列表旁边的“添加”按钮,可以添加新策略。 在 策略标题 字段中提供一个新标题。
可以使用 选择策略 下拉列表旁边的“复制”按钮,复制该下拉列表中选定的现有策略以将其作为新策略。 在 策略标题 字段中提供一个新标题。 默认情况下,复制的策略的标题为 X 的副本,其中 X 是被复制的策略的标题。
-
在 策略标题 字段中定义策略的标题。策略必须具有标题,以便能够在 选择策略 下拉列表中轻松选择它。
-
策略说明 字段中的策略说明是可选的。
-
在 同时使用选定策略 的其他模板部分中,您可以轻松地查看哪些其他模板使用了 选择策略 下拉列表中的选定策略。
页面属性 page-properties
使用 页面设计 对话框中的页面属性,您可以定义所需的客户端库。这些客户端库包含要与模板以及使用该模板创建的页面一起加载的样式表和 JavaScript。
-
指定要对使用此模板创建的页面应用的客户端库。在 客户端库 部分的文本字段中输入库的名称。
-
如果需要多个库,请单击“添加”按钮,以添加更多用于填写库名称的文本字段。
为您的客户端库添加所需数量的文本字段。
-
通过使用拖动手柄拖动字段,根据需要定义库的相对位置。
编辑模板 – 初始页面属性 – 作者 editing-a-template-initial-page-properties-author
使用 初始页面属性 选项,您可以定义要在创建生成页面时使用的初始页面属性。
-
在模板编辑器中,从工具栏中选择 页面信息,然后选择 初始页面属性 以打开相应的对话框。
-
在该对话框中,您可以定义要对使用此模板创建的页面应用的属性。
-
单击 完成 以确认您的定义。
最佳实践 best-practices
创建模板时,您应该考虑以下事项:
-
使用模板创建页面后,对模板所做的更改会影响这些页面。
下面列出了可以对模板执行的不同操作,以及这些操作对使用模板创建的页面有何影响:
-
更改结构:
- 此类更改会立即应用于生成页面。
- 还需要发布已更改的模板,之后访客才能看见所做的更改。
-
更改内容策略和设计配置:
- 此类更改会立即应用于生成页面。
- 需要发布所做的更改,之后访客才能看见这些更改。
-
更改初始内容:
- 此类更改只会应用于对模板进行更改后创建的页面。
-
更改布局,具体影响取决于修改的组件属于以下哪种情况:
- 仅属于结构 - 立即应用
- 包含初始内容 - 仅应用于在更改后创建的页面
在执行以下操作时,请务必要特别小心:
-
在已启用的模板上锁定或解锁组件。
-
这可能会产生不良后果,因为现有页面可能已在使用该组件。通常:
- 现有页面上缺少解锁组件(已锁定)。
- 锁定组件(之前可编辑)会隐藏相关内容,使其不在页面上显示。
note note NOTE 在已不再是草稿的模板上更改组件的锁定状态时,AEM 会显示明确的警告消息。 -
-
为特定于站点的模板创建您自己的文件夹。
-
从 模板 控制台发布您的模板。