Page History

...

• class节点里分配的STKPage，定义基本模板定义。
• modelClass节点里分配的STKPageModel，是基本页面模型，提供页面级功能。它扩展了STKPage。
• renderType节点下值为stk时，分配的STK专用绘制器，STKRenderer。所有STK模板（页面和组件）都可以使用这个绘制器。
• i18nBasename节点下分配的国际化关键字，info.magnolia.module.templatingkit.messages。这也是STK翻译的消息包关键字。

• visible属性设置为true，使编辑者在页面应用里可以选择该模板。

  Advanced Tables - Table Plus
  heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false
  节点名 值  pages   stkArticle   areas   mgnl-p bodyID article mgnl-p category content mgnl-p class info.magnolia.module.templatingkit.templates.pages.STKPage mgnl-p dialog standard-templating-kit:pages/article/stkArticleProperties mgnl-p i18nBasename info.magnolia.module.templatingkit.messages mgnl-p modelClass info.magnolia.module.templatingkit.templates.pages.STKPageModel mgnl-p renderType stk mgnl-p subcategory article mgnl-p title templates.stkArticle.title mgnl-p visible true

有两个例外：

• stkGlossary模板使用它自己的modelClass，即GlossaryTemplateModel，这个模型类通过扩展STKPageModel<STKPage>来完成按字母排序的词汇表。

  Advanced Tables - Table Plus
  heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false
  节点名 值  pages   stkGlossary   areas   mgnl-p bodyID glossary mgnl-p category feature mgnl-p class info.magnolia.module.templatingkit.templates.pages.STKPage mgnl-p dialog standard-templating-kit:pages/glossary/stkGlossaryProperties mgnl-p i18nBasename info.magnolia.module.templatingkit.messages mgnl-p modelClass info.magnolia.module.templatingkit.templates.GlossaryTemplateModel mgnl-p renderType stk mgnl-p subcategory glossary mgnl-p title templates.stkGlossary.title mgnl-p visible true

• stkRedirect模板使用它自己的：
• modelClass: RedirectTemplateModel，这个模型类扩展了STKPageModel，并提供3个可选的重定向模式。编辑者可以通过以下方式之一设置path值来选择模式：
• 如果在对话框里输入了内部路径或外部URL，用户将会直接被重定向过去。为避免写入响应，绘制步骤会被跳过。
• 如果没有输入路径，那么页面会重定向至找到的第一个子页面。这有利于直接显示一个在重定向树的二级或三级定义的页面。

• templateScript:redirectMain.ftl，在页面上绘制合适的路径。您可以在STK > 模板 /templating-kit/pages/functional/redirectMain.ftl里查看脚本。

  Advanced Tables - Table Plus
  heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false
  节点名 值  pages   stkRedirect   areas   mgnl-p bodyID redirect mgnl-p category functional mgnl-p class info.magnolia.module.templatingkit.templates.pages.STKPage mgnl-p dialog standard-templating-kit:functional/stkRedirect mgnl-p i18nBasename info.magnolia.module.templatingkit.messages mgnl-p modelClass info.magnolia.module.templatingkit.templates.RedirectTemplateModel mgnl-p renderType stk mgnl-p subcategory redirect mgnl-p templateScript /templating-kit/pages/functional/redirectMain.ftl mgnl-p title templates.stkRedirect.title mgnl-p visible true

在页面编辑器里，页面显示到内部或外部重定向的路径，但在预览里，则显示目标页面。/demo-project/service/m5-campaign页面使用的是stkRedirect模板。

...

• bodyID：这是模板专有样式的CSS表所用的标签。参考Body类和ID以获得更多信息。bodyID和subcategory值常常会一致，但它们彼此之间没有依赖关系。
• category和subcategory：每个模板都会分配到一个类别里，同时大多数模板也会分配到子类。很多场合都使用了类别，参考类别和子类。
• dialog：每个页面模板会连接到它自己的stk<Template name>Properties对话框，这个对话框在STK > 对话框定义 /pages里配置。页面顶部工具栏里的属性按钮可以打开此对话框，控制浏览器标题和导航标题及行为，页面元数据（关键字和描述），变异形式排除和页面依赖性。详细信息参看属性对话框。

• title：在页面应用的模板下拉菜单里显示的模板标题。

  Advanced Tables - Table Plus
  heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false
  节点名 值  pages   stkImageGallery   areas   mgnl-p bodyID image-gallery mgnl-p category feature mgnl-p class info.magnolia.module.templatingkit.templates.pages.STKPage mgnl-p dialog standard-templating-kit:pages/imageGallery/stkImageGalleryProperties mgnl-p i18nBasename info.magnolia.module.templatingkit.messages mgnl-p modelClass info.magnolia.module.templatingkit.templates.pages.STKPageModel mgnl-p renderType stk mgnl-p subcategory imageGallery mgnl-p title templates.stkImageGallery.title mgnl-p visible true

Anchor
页面定义 页面定义

extends属性

...

...

...

使组件可用

...

...

• 该模板不是任何其他模板的扩展。
• /areas/promos/availableComponents节点的添加使Magnolia CMS了解此区域修改了原型。
• /availableComponents/stkPromo/enabled节点禁用了此区域的stkPromo组件。

• /availableComponents/stkExtrasContact节点里使能了stkExtrasContact组件，禁用了stkPromo组件。

  Advanced Tables - Table Plus
  heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false
  节点名 值 stkEventsOverview   areas   promos   availableComponents   stkPromo   mgnl-p enabled false stkExtrasContact   mgnl-p id standard-templating-kit:components/extras/stkExtrasContact

...

• 该模板是stkArticle模板的扩展。这是在/stkNews/extends节点下配置的。
• 添加/areas/content/extends属性并设置为override，就会告诉Magnolia CMS忽略（覆写）stkArticle模板里的/areas/content配置。这个配置使得8个内容组件可用。

• 添加/areas/content/availableComponents节点，使stkNews模板里只有stkTextImage组件可用。

  Advanced Tables - Table Plus
  heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false
  节点名 值 stkNews   areas   main   areas   content   availableComponents   stkTextImage   mgnl-p id standard-templating-kit:components/content/stkTextImage mgnl-p extends override mgnl-p dialog standard-templating-kit:pages/news/stkNewsProperties mgnl-p extends /modules/standard-templating-kit/templates/pages/stkArticle mgnl-p subcategory news mgnl-p title templates.stkNews.title

...

• roles内容节点提醒Magnolia CMS可能有使用限制。

• superuser属性值也设置为superuser，限制了只有superuser角色的用户才能使用组件。详细信息参考角色RolesRoles。

  Advanced Tables - Table Plus
  heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false
  节点名 值 stkArticle   areas   main   areas   content   availableComponents   stkHTML   roles   mgnl-p superuser superuser mgnl-p id standard-templating-kit:components/content/stkHTML stkTextImage   stkQuotedText

...

• 特性模板覆写了默认类型，将其改为single。特性组件在/areas/main/areas/content/autoGeneration/content/singleton节点里添加。参考特色组件和自动生成的组件。

  Advanced Tables - Table Plus
  heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false
  节点名 值 stkImageGallery   areas   main   areas   content   autoGeneration   content   singleton   mgnl-p maxImages 9 mgnl-p nodeType   mgnl:component mgnl-p templateId  standard-templating-kit:components/features/stkImageGallery mgnl-p generatorClass  info.magnolia.rendering.generator.CopyGenerator mgnl-p type single

使能区域

大多数区域在原型里是使能的，因此需要在特定的模板定义里禁用，改变默认设置。您可以将/areas/<area name>内容节点下的enabled属性节点值设置为false来做到。另一方面，类似stage或platform的区域由于很少使用，所以在原型里是不使能的，这种情况就需要设置enabled属性值为true来改变。

...

• 决定整个区域是否绘制，无论区域包含的是组件，自动生成的内容，还是脚本绘制的内容。内容会保留在内容库中，并且在一个被禁用的区域重新使能后，将会再绘制。您可以在stkArticle模板上禁用extras，并在工具 > JCR里查看任意文章页来验证。

  Section

  Column width 33% 模板定义 Advanced Tables - Table Plus heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false 节点名 值 stkArticle   areas   extras   mgnl-p enabled false mgnl-p bodyID article Column width 33% JCR浏览器（网站） Advanced Tables - Table Plus heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false 节点名 值 demo-project   about   subsection-articles   article   extras   extras1   0   00

...

• /areas/main节点：
• 使用它自己的类，SectionMainArea，来定义opener区域属性。
• 由/section/mainArea.ftl脚本绘制。该脚本与默认使用的/global/mainArea.ftl脚本唯一的不同在于，它使用[@cms.area name="opener"/]标签添加了opener区域。
• /areas/main/areas/opener节点：
• 配置opener区域。
• 是一个只能绘制一个组件的single区域。
• 是enabled和optional的，意味着它虽然可用，但编辑者可能会选择删除它。
• 由/section/opener.ftl这个标准的single区域脚本绘制。

• 在availableComponents节点里设置stkTeaserOpener组件可用。

  Advanced Tables - Table Plus
  heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false
  节点名 值 stkSection   areas   main   floating   areas   intro   opener   availableComponents   stkTeaserOpener   mgnl-p id standard-templating-kit:components/teasers/stkTeaserOpener mgnl-p description areas.templates.main.opener.description mgnl-p enabled  true mgnl-p optional true mgnl-p templateScript   /templating-kit/pages/section/opener.ftl mgnl-p title areas.templates.main.opener.title mgnl-p type single content   mgnl-p class info.magnolia.module.templatingkit.templates.SectionMainArea mgnl-p templateScript /templating-kit/pages/section/mainArea.ftl

...

• /areas/main：
• 使用SectionMainArea类定义浮显属性。
• 由section/MainArea.ftl脚本绘制，简单的绘制所有嵌套区域。
• areas/main/floating：
• enabled节点设置为true来使能浮显。您可以将此属性设置为false来禁用。
• columns设置为3，告诉Magnolia CMS在三列中绘制组件。此属性可用的选项有1，2，和3。由于其他嵌套区域都被禁用，只有在/areas/main/areas/content/availableComponents节点下可用的组件会在main区域里绘制。
• areas/main/areas/content：
• 使一些要点组件在/availableComponents节点里可用。这些组件被配置在一个浮显区域内工作（见下表）。
• 由section/contentArea.ftl脚本绘制。该脚本包含绘制teaserCount的代码（见下表）。
• /areas/main/areas/intro，/opener和/breadcrumb被禁用了，意味着在此模板上，浮显只出现在/areas/main/areas/content里。您并不一定需要禁用其他嵌套区域。

• /areas/extras被禁用，以确保此页解析到一个allowedBodyClass里（见下表）。

  Advanced Tables - Table Plus
  heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false
  节点名 值 stkHome   areas   main   floating   mgnl-p columns 3 mgnl-p enabled true areas   content   availableComponents   mgnl-p templateScript /templating-kit/pages/section/contentArea.ftl mgnl-p title templates.stkHome.areas.main.content.title intro   mgnl-p class info.magnolia.module.templatingkit.templates.MainAreaIntro mgnl-p enabled false opener   breadcrumb   mgnl-p class  info.magnolia.module.templatingkit.templates.SectionMainArea mgnl-p templateScript /templating-kit/pages/section/mainArea.ftl extras   inheritance   mgnl-p class  info.magnolia.module.templatingkit.templates.ExtrasArea mgnl-p enabled false

默认情况下，您可以扩展stkHome和stkSection模板来配置一个浮显模板，这是因为它们都使用SectionMainArea类和要点组件。其它的场景则需要定制。STK > 模板定义 /pages/demo-features/stkSectionFloating里的stkSectionFloating模板就是扩展stkSection模板的一个例子，它：

• 在stkSectionFloating/extends节点下扩展stkSection模板。通过扩展：
• 需要的要点组件在/areas/main/content/availableComponents节点下可用。
• SectionMainArea类得到使用。
• 在/areas/main/floating节点，floating被使能且columns设置为2。
• 在/areas/main/areas节点，intro和opener区域被禁用。

• 在/areas/extras节点，extras区域被禁用。

  Advanced Tables - Table Plus
  heading 0 multiple false enableHeadingAttributes false enableSorting false class m5-configuration-tree enableHighlighting false
  节点名 值 pages   demo-features   stkSectionFloating   areas   main   floating   mgnl-p columns 2 mgnl-p enabled true areas   intro   mgnl-p enabled false opener   mgnl-p enabled false extras   inheritance   mgnl-p class info.magnolia.module.templatingkit.templates.ExtrasArea mgnl-p enabled false base   mgnl-p extends /modules/standard-templating-kit/templates/pages/stkSection mgnl-p title Section Floating

这是基于stkSectionFloating模板的demo-features/section-variables/floating页在公共实例上的样子。该页解析到body元素里包含的一个属性（attribute），即allowedBodyClass=nav-col-float2里。main区域的每个要点都包装在一个DIV元素内。

...

如果您在任意基于stkSection模板的页面上，只需将扩展名从.html改为.newsletter，变异形式的内容就出现了。

...

...

以上配置样例中，deletable、moveable和writable属性的配置使组件可编辑，但不可移动或删除。以下为编辑者在页面编辑器里看到的。

...

...

...

...

...

...

...

...

...

...

如果您想要在模板定义中修改一个自动生成组件的默认设置，您需要首先在JCR浏览器中删除这个内容节点（singleton）并刷新该页。系统会使用新的模板定义属性在页面上重新创建该组件。这是一个已知问题，您可以在MAGNOLIA-4482里跟踪进展。