Page History

脚本语言和绘制器

Magnolia CMS为FreeMarker和JSP提供可立即使用的绘制器。您可以选择偏好的语言，甚至可以在相同的网站上混合使用，在一些模板里使用FreeMarker而另一些里用JSP。 CMS为FreeMarker和JSP提供可立即使用的绘制程序。您可以选择喜欢的语言，甚至可以在相同的网站上混合使用，在一些模板里使用FreeMarker而另一些里用JSP。 

FreeMarker

在Magnolia里，我们更倾向于使用FreeMarker，因其灵活性，较清晰的语法，更好的错误报告机制，也因为它不依赖于文件系统。模板不需要导出到文件系统，这意味着您可以将它们存储在内容库中，并像其他资源一样获得，随意添加版本控制，以及添加定制的属性和元数据。在Magnolia里，我们更倾向于使用FreeMarker，因其比较灵活，语法较清晰，以及更好的错误报告机制，并且它不依赖于文件系统。模板不需要导出到文件系统，这意味着您可以将它们存储在内容库中，像其他资源一样获得，随意添加版本控制，以及添加定制的属性和元数据。

示例：绘制页面标题，如果没有标题则绘制名字。示例：绘制页面标题，如果没有标题则绘制页面名称。

<h3>${content.title!content.@name}</h3>

这是FreeMarker提供的一些好处：FreeMarker提供的好处有：

• 它是一种通用的模板语言，不束缚于Java环境。
• 提供基本的指令，如[if]，[else]和[list]。
• 有一大套有大量的内建函数。
• 可以调用任何Java对象和返回对象的公共方法。
• 不需要在请求／回复环境中绘制。
• 提供直接获取节点对象（beans）的方法。可直接获取节点对象（beans）。
• 可直接迭代任何扩展一个Java列表的内容集合。
• 严格的由于其严格的null值处理导致稳定的模板。，模板比较稳定。
• 需要的话允许使用JSP标签库。

JSP

JSP代表JavaServer Pages，是Java Servlet技术的一个延伸，用于综合Java服务器端的程序和HTML。Servlet技术的一个延伸，综合了Java服务器端程序和HTML。

示例：绘制页面标题，如果没有标题则绘制名字。示例：绘制页面标题，如果没有标题则绘制名称。

<h3>
<c:choose>
    <c:when test="${not empty content.title}">${content.title}</c:when>
    <c:otherwise>${content['@name']}</c:otherwise>
</c:choose>
</h3>

其他语言

您也可以使用另一模板语言。例如，有一些网站使用您也可以使用其他的模板语言。例如，有一些网站使用Apache Velocity。如果有您使用的语言可用的绘制器，很有可能可以将它合入Magnolia CMS。这就能够让您使用您熟悉的模板语言了。。如果您使用的语言有可用的绘制程序，很大可能您可以将它合入Magnolia CMS，这就能够让您使用您熟悉的模板语言了。

绘制器配置

FreemarkerRenderer和JspRenderer在配置应用的/modules/rendering/renderers/freemarker和/jsp里配置。

...

页面, 区域和组件定义里的renderType属性定义使用的模板绘制器。对STK模板来说，类型是属性可定义使用何种模板绘制程序。对STK模板来说，类型是stk。

加载脚本

系统可以从三个地方加载FreeMarker脚本，以下列顺序：系统可以从三个地方加载FreeMarker脚本，加载顺序如下：

1. 网络应用程序的文件系统。您可以将脚本文件放在Web应用程序的文件系统。您可以将脚本文件放在/<CATALINA_HOME>/webapps/<contextPath>/templates文件夹。
2. templates 工作区。模板需被使能才能被考虑进去。工作区。模板需先被使能才可以使用。
3. 网络应用程序的类路径（classpath）。这是STK模板默认存放的地方。最佳实践是在模块JAR里打包脚本。模块JAR在类路径里好让系统找得到它。Web应用程序的类路径（classpath），这也是默认存放STK模板的地方。一个最佳实践是，在模块JAR里打包脚本（为方便系统找到，模块JAR在类路径里）。

模板加载器

FreeMarker模板加载器在配置应用的/server/rendering/freemarker/jcr和/webapp里配置：

• LazyWebappTemplateLoader默认从webapp文件夹里加载模板。如果没找到匹配的模板，则将会从类路径中加载。
• JcrRepoTemplateLoader允许从内容库中加载模板。加载器包含在In-place Templating模块。允许从内容库中加载模板。这个加载器在原位模板工具模块里。
• LazyFileTemplateLoader允许从文件系统的专有位置中加载模板。允许从文件系统的任意位置加载模板。

需要的话您也可以写下您自己定制的模板加载器。需要的话您也可以编写您自己定制的模板加载器。

开发时，在内容库里编辑脚本有时候很有用。这种方法只对FreeMarker脚本有效。如果您将脚本导入当您在开发时，在内容库里编辑脚本有时很有用，但这种方法只对FreeMarker脚本有效。如果您将脚本导入到templates工作区，它们就会在STK > 模板里可见可用。所有的STK脚本都遵循这个模式。您可以从以上的加载顺序看出，在里可供使用。所有的STK脚本都遵循这个模式。您可以从以上的加载顺序看出，templates工作区里的脚本会覆写从类路径里加载的脚本。一旦被添加或修改，则需要选中工作区里的脚本会覆写从类路径里加载的脚本。所以脚本一旦被添加或修改，就需要选中使能模板复选框来强迫Magnolia CMS从内容库中加载模板。

STK脚本

STK模板脚本在网络应用程序的类路径中。其副本在STK模板脚本在Web应用程序的类路径中，脚本副本在STK > 模板里就可以编辑。STK脚本是用FreeMarker写的。

...

• components包含按照组件类型分类的组件模板。
• pages包含的子文件夹里有main页面脚本，区域脚本在子文件夹里。页面脚本和区域脚本。

此结构遵循模板原型结构。在模板原型里引用的区域模板都被存在。模板原型里引用的区域模板都存在/global文件夹里。文件夹。

main脚本

main是主页面脚本（Git）。它是理解这个系统的一个好起点。它在编写实例上使用），是理解这个系统的一个好起点。它在编写实例上使用@cms.init指令初始化页面编辑器，也包含了设置指令初始化页面编辑器，同时也包含了设置bodyClass和bodyID的逻辑。

main脚本使用@cms.area指令来调用区域绘制它们自身。它使用绘制，并使用#include指令绘制导航。main脚本用三个DIV元件包装区域，建立了一个可调的页面网格。

区域脚本

参考STK区域里关于STK区域脚本的描述。

指令

关键的模板特性以关键的模板工具功能在Magnolia CMS标签库里，以指令（directives）形式在Magnolia CMS标签库里可用。指令输入很快，但会绘制复杂的输出。形式供使用。指令输入起来很快，却可以绘制复杂的输出。

标准FreeMarker指令

这里有一些最有用的FreeMarker指令及其样例代码：

...