创建页面时,您必须选择一个模板,该模板将用作创建新页面的基础。 模板定义了生成页面的结构、任何初始内容以及可以使用的组件。
使用模 板编辑器,创建和维护模板不再只是开发人员的任务。 高级用户(称为模板作者 )也可能。 开发人员仍需要设置环境、创建客户端库和创建要使用的组件,但是,在这些基础知识到位后,模板作者就可以灵活地创建和配置模板,而无需开发项目。
此 模板控制台 允许模板作者:
此 模板编辑器 允许模板作者:
本文档说明如何 模板作者 可以使用“模板”控制台和编辑器创建和管理可编辑模板。
有关如何在技术层面使用可编辑模板的详细信息,请参阅开发人员文档 页面模板 — 可编辑 了解更多信息。
模板 编辑器不支持直接在模板级别进行定位。 可以定位基于可编辑模板创建的页面,但不能定位模板本身。
使用创建的页面和模板 模板控制台 不能与经典UI一起使用,并且不支持此类使用。
管理员必须在配置浏览器中配置一个模板文件夹,并应用适当的权限,之后模板作者才能在该文件夹中创建模板。
在开始之前,请务必注意以下几点:
创建新模板需要协作。 因此,为每项任务指明了对应的角色。
根据实例的配置方式,请注意AEM现在提供的 两种基本类型的模板. 这不会影响您实际的 使用模板创建页面,但它确实会影响您可以创建的模板类型以及页面与其模板的关系。
使用“模板”控制台和模板编辑器创建新模板需要以下角色之间的协作:
管理员:
创建新的模板文件夹需要 admin
权限。
此类任务通常也可以由开发人员完成
开发人员:
模板作者:
特定的作者,template-authors
组中的一个成员。
可以配置组件的使用和其他高级详细信息,这些详细信息需要:
一些技术知识
由开发人员提供的技术信息。
由于某些任务(如创建文件夹)的性质,需要开发环境,而这需要知识/经验。
本文档中详细列出的任务以及负责执行这些任务的角色。
AEM现在提供两种基本类型的模板:
静态模板
根据定义,模板控制台和模板编辑器仅允许创建和编辑可编辑模板。 因此,本文档仅侧重于可编辑的模板。
将模板用于 创建新页面 静态模板与可编辑模板之间没有可见的区别和指示。 对于页面作者,该过程是透明的。
在创建新的可编辑模板时,您可以:
使用 模板 控制台。 此页面位于 常规 部分 工具 控制台。
如有必要,可以创建模板文件夹
创建新模板,新模板最初是空的
定义其他属性 模板(如果需要)
编辑模板 要定义,请执行以下操作:
启用模板 创建页面时使用
允许模板 所需的页面或网站分支
发布模板 以使其在发布环境中可用
通常,在最初设置您的网站时便会预定义允许的模板。
切勿输入任何需要的信息 国际化 放入模板。 出于内部化目的, 核心组件的本地化功能 建议使用。
您应该为项目创建模板文件夹,以保存特定于项目的模板。这是一项管理员任务,在文档中进行了描述 页面模板 — 可编辑.
打开“模板”控制台(通过工具 -> 常规),然后导航到所需的文件夹。
在标准 AEM 实例中,“模板”控制台中已存在全局文件夹。此文件夹会保存默认模板,如果在当前文件夹中没有找到策略和/或模板类型,则此文件夹可以充当备用。
建议最好使用 为您的项目创建的模板文件夹.
选择创建,然后选择创建模板以打开向导。
选取 模板类型,然后选择 下一个.
模板类型是预定义的模板布局,可以将其视为模板的模板。 这些权限由开发人员或系统管理员预定义。 有关详细信息,请参阅开发人员文档 页面模板 — 可编辑.
完成 模板详细信息:
选择创建。随即会显示确认对话框,选择打开🔗以开始编辑模板,或选择完成以返回到“模板”控制台。
创建新模板后,会在控制台中将其标记为草稿,这表示页面作者还不能使用此模板。
模板可以具有以下属性:
图像
要用作的图像 模板的缩略图 以帮助进行选择,例如在“创建页面”向导中选择。
标题
描述
要查看和/或编辑属性,请执行以下操作:
模板是简化页面创建工作流的强大工具。不过,太多的模板会让作者不知所措,并使页面创建变得混乱。一个好的经验法则是将模板的数量保持在 100 个以内。
由于潜在的性能影响,Adobe 建议不要使用超过 1000 个模板。
控制台中会指示模板的状态(“草稿”、“已启用”或“已禁用”)。
要定义模板缩略图,请执行以下操作:
编辑模板属性。
选择要上传缩略图还是从模板内容生成缩略图。
对于这两种方法,将显示缩略图预览。
如果不满意,请单击或点按 清除 上传其他图像或重新生成缩略图。
如果您对缩略图满意,请单击或点按 保存并关闭.
为了能够在创建页面时使用模板,您需要执行以下操作:
可以启用或禁用模板,使其在 创建页面 向导。
启用模板后,当模板作者开始进一步更新模板时,将显示警告。 这是为了告知用户可能会引用该模板,因此任何更改都可能影响引用该模板的页面。
控制台中会指示模板的状态(“草稿”、“已启用”或“已禁用”)。
可以使模板可用于或不可用于某些页面分支。
对于希望可在其中使用模板的分支,打开其根页面的页面属性。
打开高级选项卡。
在模板设置下方,使用添加字段指定模板的路径。
路径可以是显式路径或使用模式。 例如:
/conf/<your-folder>/settings/wcm/templates/.*
路径的顺序无关,将扫描所有路径并检索任何模板。
如果 允许的模板 列表留空,树将提升,直到找到值/列表。
请参阅模板可用性 – 对允许的模板适用的原则与此相同。
单击保存,以保存对页面属性所做的更改。
通常,在设置您的网站时便会为整个网站预定义允许的模板。
由于渲染页面时会引用模板,因此模板在完全配置后需要进行发布,才能用于发布环境。
在模板控制台中,选择相应的模板。
从工具栏中选择发布以打开向导。
选择要一同发布的内容策略。
选择 Publish ,以完成操作。
创建或编辑模板时,您可以定义多个方面。 编辑模板与页面创作类似。
可以编辑模板的以下方面:
页面作者不能从生成页面中移动/移除在此处添加的组件。 如果您希望页面作者能够在生成页面中添加和删除组件,则需要将段落系统添加到模板。
锁定组件后,您可以添加页面作者无法编辑的内容。 您可以解锁组件,以便定义 初始内容.
在结构模式下,任何作为已解锁元件的父元件的元件均无法移动、剪切或删除。
解锁组件后,您可以定义要复制到生成页面(使用模板创建)的初始内容。可以在生成页面上编辑这些已解锁的组件。
在初始内容模式下以及在生成页面上,可以删除任何具有可访问父项的已解锁组件(即,布局容器内的组件)。
您可以在此处预定义所需设备格式的模板布局。 模板创作的布局模式与页面创作的布局模式具有相同的功能。
在页面策略下,您可以将预定义的页面策略连接到页面。 这些页面策略可定义各种设计配置。
样式系统允许模板作者在组件的内容策略中定义样式类,以便内容作者在页面上编辑组件时能够选择这些类。这些样式可以作为组件的替代可视化变量,从而使组件变得更加灵活。
有关更多信息,请参阅样式系统文档。
使用工具栏中的模式选择器,可以选择并编辑模板的相应方面:
而使用页面信息菜单中的页面策略选项,可以选择所需的页面策略:
如果作者开始编辑已启用的模板,将显示警告。 这是为了告知用户可能会引用该模板,因此任何更改都可能影响引用该模板的页面。
在结构模式下,您可以为模板定义组件和内容,并为模板及其组件定义策略。
不能在生成的页面上移动模板结构中定义的组件,也不能从任何生成的页面中删除这些组件。
如果您希望页面作者能够添加和删除组件,请向模板中添加一个段落系统。
可以解锁组件,然后再将其锁定,以便定义初始内容。
可为组件和页面定义设计策略。
In 结构 模板编辑器的模式:
添加组件
向模板中添加组件有多种机制:
从 组件 浏览器中。
通过使用 插入组件 选项(+ 图标)的工具栏上提供的页面加载项,或者 将组件拖动到此处 盒子。
通过拖动资产(从 资产 浏览器中)直接加载到模板上以就地生成相应的组件。
添加后,每个组件都标有:
将现成的标题组件添加到模板后,该组件会包含默认的文本结构。
如果更改此文本,并添加自己的文本,则在使用该模板创建页面时,将会使用更新的文本。
如果您保留默认文本(“结构”),则标题会默认使用后续生成页面的名称。
将组件和资产添加到模板的操作与在页面创作时执行的类似操作虽然并不完全相同,但也存在许多相似之处。
组件操作
将组件添加到模板后,对组件执行操作。 每个实例都有一个用于访问可用操作的工具栏,该工具栏取决于组件类型。
显示的工具栏还会取决于执行的操作,例如将策略与组件关联后,便会显示设计配置图标。
编辑和配置
通过这两项操作,您可以在组件中添加内容。
指示结构的边框
在中工作时 结构 模式橙色边框表示当前选择的组件。 虚线还指示父组件。
例如,在下面的屏幕快照中 文本 组件已选取,位于 布局容器 (响应网格)。
策略和属性(常规)
内容(或设计)策略定义组件的设计属性。 例如,可用元件或最小/最大尺寸。 这些选项适用于模板(以及使用模板创建的页面)。
可为组件创建内容策略或选择现有策略。这允许您定义设计详细信息。
配置窗口分为两个部分。
可用的属性取决于所选的组件。 例如,对于文本组件,属性定义了复制和粘贴选项、格式设置选项以及段落样式等选项。
策略
内容(或设计)策略定义组件的设计属性。 例如,可用元件或最小/最大尺寸。 这些选项适用于模板(以及使用模板创建的页面)。
在策略下方,您可以通过下拉列表选择要应用于组件的现有策略。
此外,也可以通过选择选择策略下拉列表旁边的“添加”按钮,来添加新策略。然后,应该在策略标题字段中输入一个新标题。
使用选择策略下拉列表旁边的“复制”按钮,可复制在此下拉列表中选定的现有策略以将其作为新策略。然后,应该在策略标题字段中输入一个新标题。默认情况下,复制的策略的标题将为 X 的副本,其中 X 是被复制的策略的标题。
策略说明字段中的策略说明是可选的。
在同时使用该选定策略的其他模板部分中,您可以轻松地查看同时也使用了选择策略下拉列表中的选定策略的其他模板。
如果将同一类型的多个组件添加为初始内容,则同一策略适用于所有这些组件。这会镜像中的相同限制 设计模式 用于静态模板.
属性
在 属性 标题可定义组件的设置。 标题包含两个选项卡:
主要
在 主要 选项卡中,定义了组件最重要的设置。
例如,对于图像组件,可以定义允许的宽度并启用延迟加载。
如果某个设置允许多项配置,请单击或点按 添加 按钮以添加其他配置。
要删除配置,请单击或点按位于配置右侧的删除按钮。
要删除配置,请单击或点按删除按钮。
功能
此 功能 选项卡允许您启用或禁用组件的其他功能。
例如,对于图像组件,您可以定义裁剪比例、允许的图像方向以及允许上载的情况。
请注意,在 AEM 中,裁剪比例被定义为高宽比。这与常见的宽高比的定义不同,这样做是出于对旧版兼容性的考虑。只要您清楚地定义名称,页面创作用户便不会察觉到任何差异,因为您定义的名称才是 UI 中显示的内容。
策略和属性(布局容器)
布局容器的策略和属性设置与常规用法相似,但存在一些差异。
对于容器组件而言,必须配置策略,因为它允许您定义将在容器中可用的组件。
配置窗口分为两部分,就像在窗口的常规用法中一样。
策略
内容(或设计)策略定义组件的设计属性。 例如,可用元件或最小/最大尺寸。 这些选项适用于模板(以及使用模板创建的页面)。
在策略下方,您可以通过下拉列表选择要应用于组件的现有策略。此操作方式与该窗口的常规用法相同。
属性
在 属性 标题您可以选择可用于布局容器的组件并定义其设置。 标题有三个选项卡:
允许的组件
在 允许的组件 选项卡中,您可以定义哪些组件可用于布局容器。
默认组件
在 默认组件 选项卡,您可以定义哪些组件自动与给定媒体类型关联,以便作者从资产浏览器拖动资产时,AEM知道要将资产与哪个组件关联。 请注意,只有具有拖放区域的组件才可用于此类配置。
单击或点按 添加映射 添加全新的组件和MIME类型映射。
在列表中选择一个组件,然后单击或点按 添加类型 ,以向已映射的组件添加其他MIME类型。 单击删除图标可删除 MIME 类型。
响应式设置
在响应式设置选项卡上,您可以配置布局容器的生成网格中的列数。
解锁/锁定组件
您可以解锁/锁定组件,以定义内容是否可用于更改 初始内容 模式。
解锁组件后:
打开的挂锁指示器显示在边框中。
相应地对组件工具栏进行调整。
任何已输入的内容将不再显示于 结构 模式。
无法移动、剪切或删除已解锁组件的父组件。
这包括解锁容器组件,以便在初始内容模式或生成的页面 中添加其他组件 。 如果在解锁容器之前已将组件/内容添加到容器,则这些组件/内容在结构模式下不再显示,但将以初始内容模式 显示 。 在“结构”模式下,只会显示容器组件本身,及其允许的组件列表。
为了节省空间,布局容器不会扩大来容纳允许的组件列表。相反,容器会变成一个可滚动的列表。
可配置的组件会显示一个 策略图标,单击或点按该图标可编辑该组件的策略和属性。
与现有页面的关系
如果在基于模板创建页面后更新了模板的结构,则这些页面会反映对模板所做的更改。工具栏中会显示一条警告消息,提醒您这一事实,同时还会显示确认对话框。
初始内容 模式用于定义首次根据模板创建页面时显示的内容。 随后,页面作者可以编辑初始内容。
虽然在结构模式下创建的所有内容在初始内容模式下均可见,但只能选择和编辑已解锁的组件。
可以将初始内容模式视为使用模板创建的页面的编辑模式。因此,策略不是在初始内容模式下定义的,而是在结构模式下定义的。
可编辑的已解锁组件将被标记。 选中后,它们具有蓝色边框:
已解锁组件的工具栏允许您编辑和配置内容:
如果已将某个容器组件解锁(在结构模式下),则您可以将新组件添加到该容器(在初始内容模式下)。可以在生成页面上移动或删除在初始内容模式下添加的组件。
您可以通过以下两种方式添加组件:使用将组件拖动到此处区域,或使用相应容器工具栏中的插入新组件选项。
如果在基于模板创建页面后更新了模板的初始内容,则对模板的初始内容所做的更改不会影响这些页面。
初始内容用于准备用作创建内容起点的组件和页面布局。 它不是将保持原样的实际内容。 因此,无法翻译初始内容。
如果需要在模板中包括可翻译文本(如在页眉或页脚中),则可以使用核心组件的本地化功能。
您可以为各种设备定义模板布局。模板的响应式布局与页面创作时的响应式布局功能相同。
初始内容模式会反映布局更改,而结构模式则不会反映任何布局更改。
页面设计(包括所需的客户端库和页面策略)在“页面信息”菜单的“页 面设计 ”选项下 进行维护 。
要访问 页面设计 对话框:
您可以将内容策略应用于模板或生成页面。这会为页面上的主要段落系统定义内容策略。
您可以从选择策略下拉列表中为页面选择现有策略。
此外,也可以通过选择选择策略下拉列表旁边的“添加”按钮,来添加新策略。然后,应该在策略标题字段中输入一个新标题。
使用选择策略下拉列表旁边的“复制”按钮,可复制在此下拉列表中选定的现有策略以将其作为新策略。然后,应该在策略标题字段中输入一个新标题。默认情况下,复制的策略的标题将为 X 的副本,其中 X 是被复制的策略的标题。
在策略标题字段中定义策略的标题。策略需要具有标题,以便能够轻松地在选择策略下拉列表中对其进行选择。
策略说明字段中的策略说明是可选的。
在同时使用该选定策略的其他模板部分中,您可以轻松地查看同时也使用了选择策略下拉列表中的选定策略的其他模板。
使用页面设计对话框中的页面属性,您可以定义所需的客户端库。这些客户端库包含要与模板以及使用该模板创建的页面一起加载的样式表和 JavaScript。
指定要应用于使用此模板创建的页面的客户端库。 在的文本字段中输入库的名称 客户端库 部分。
如果需要多个库,请单击“添加”按钮,以添加更多用于填写库名称的文本字段。
为您的客户端库添加所需数量的文本字段。
通过使用拖动手柄拖动字段,根据需要定义库的相对位置。
虽然模板作者可以在模板上指定页面策略,但是他们需要从开发人员处获取相应客户端库的详细信息。
使用初始页面属性选项,您可以定义要在创建生成页面时使用的初始页面属性。
在模板编辑器中,从工具栏中选择页面信息,然后选择初始页面属性以打开相应的对话框。
在该对话框中,您可以定义要对使用此模板创建的页面应用的属性。
通过以下方式确认您的定义 完成.
在创建模板时,您应该考虑:
从模板创建页面后对模板进行更改的影响。
下面列出了对模板可能执行的不同操作,以及这些操作对根据这些操作创建的页面有何影响:
对结构的更改:
对内容策略和设计配置的更改:
对初始内容的更改:
布局更改取决于修改的组件是否属于以下组件:
在下列情况下,请特别注意:
在启用的模板上锁定或解锁组件。
这会带来一些副作用,因为现有页面已可以使用该功能。 通常:
在不再是草稿的模板上更改组件的锁定状态时,AEM会给出显式警告。
创建您自己的文件夹 特定站点模板的位置。
发布模板 从 模板 控制台。