magnolia中文教程Word格式.docx
《magnolia中文教程Word格式.docx》由会员分享，可在线阅读，更多相关《magnolia中文教程Word格式.docx（26页珍藏版）》请在冰豆网上搜索。
该模板或段落脚本指定的运作和模板或段落的设计，或者JSP或FreeMarker的可以用来写剧本。
该对话框有助于此外，修订和内容存储。
内容存储在库中。
在这些过程中，一个新的网页或完成后段呈现。
我们的标准模板工具包（沙头角），形成了木兰超音速模板包的一部分，提供了一个简单的替代方案，以创建自己的模板从头开始。
沙头角是一个模板和功能，它允许您调整和修改现有的模板以满足您的需要，而需要广泛的技术知识，收集。
这是一个最佳实践，出的现成解决方案，旨在加快您的自定义模式的发展。
如需有关沙头角信息，请参阅我们的沙头角文件。
本指南提供了分步说明如何建立一个基本模板。
为了显示的发展道路，我们刻意保持它极其简单。
步骤，我们将遵循如下：
∙创建一个简单的模板，只显示静态文本;
∙添加主酒吧，包含网页的属性，AdminCentral和预览功能按钮;
∙创建一个段落以结构为较小的部分内容;
及
∙创建一个对话框编辑内容。
享受结果！
创建一个简单的模板
有两个步骤来创建一个模板：
∙创建模板定义;
∙创建模板脚本
创建模板定义
那个模板的定义可以识别和木兰使用模板脚本。
这一步使该模板无法使用遗漏。
一旦模板定义设置，模板可使用在其网站pages.The模板定义作者的简单定义模板属性，并通知木兰如何使用模板。
创建一个模板定义包括创建一个新的内容节点（模板定义页），增加了一些用户友好特性的模板脚本，例如标题和描述，并配置模板。
与其试图分配到一个JSP网页，作者可以简单地选择预先设计的模板。
配置模板是添加模板定义玉兰进程。
对于本指南的目的，定义的模板将在模板模块的创建，但理想的，它应该被添加到您自己的模块，使您的木兰customizationsindependent，并升级容易。
至创建模板的定义：
∙打开工作区，扩大配置的模块文件夹;
∙创建一个新文件夹模板/模板子文件夹，命名MyProject的;
∙在新的MyProject的文件夹，创建一个新的内容节点，命名myTemplate;
∙创建7个新的数据节点命名描述，i18Basename，名字，路径，标题，类型和可见根据myTemplates内容节点;
∙进一步的内容创建一个节点，命名subTemplates作为一个子节点的内容myTemplate;
∙进一步的内容创建一个节点，命名打印作为一个子节点的内容subTemplates;
∙创建两个新的数据节点命名扩展和路径根据打印内容节点;
∙设置的所有数据节点相同的值在下面的截图详细;
∙如有需要，适应内容以适应自己的设置。
该模板在我们的例子定义配置JSP的脚本。
如果你喜欢使用Freemarker，更改类型属性Freemarker的和路径属性链接到您的FreeMarker的脚本（。
超长）。
您可以命名新创建的子文件夹和任何你喜欢的内容节点。
然而，数据节点应该被命名为相同的屏幕细节，但在插入值的信息栏，可以调整以适应您的安装程序。
为了组织目的，模板也可以分组分文件夹。
子模板定义其他JSP或用来改进或增加功能模板Servlet的父母。
在结构上，分模板的定义和存储为子节点的父内容模板定义内容节点。
在脚本水平，推出的子模板使用在扩展网址请求。
例如，“。
html的”通常是父母模板和子模板，目的是控制打印功能，可能有扩展名为“。
打印”。
子模板节点的“延伸”和“道路”定义的属性。
如需有关属性，这是为模板定义的资料，请参阅在模板属性的完整列表。
创建模板脚本
虽然最常见的模板语言是JSP（Java服务器页面），对FreeMarker的全力支持模板和段落是同木兰4.0版本中引入的。
FreeMarker的和JSP模板可以结合起来使用。
FreeMarker的都和JSP模板可从类路径中，库或文件系统加载。
请有关FreeMarker的更多细节，请参考模板使用FreeMarker。
该代码在本指南提供的例子包括了FreeMarker的和JSP源代码，所以你可以选择自己偏好的代码。
我们的脚本将创建非常简单，只显示静态文本“Hello木兰世界！
”在网页上。
要创建模板脚本：
∙在桌面上，创建一个webapps文件夹中的新文件夹：
模板/MyProject的/模板
∙创建一个新的JSP或超长脚本文件名为helloworld.jsp/超长并插入下面的代码：
例如使用JSP语法：
<
@pageContentType=％“text/HTML;
字符集=UTF-8的”语言=“java”％>
html>
<
head>
title>
TemplateTitle<
/title>
/head>
body>
HelloMagnoliaWorld!
/body>
/html>
>
例如使用Freemarker的语法：
metahttp-equiv="
Content-Type"
content="
text/html;
charset=utf-8"
/>
这不要紧，你把你的模板脚本，只要是内webapps文件夹中的玉兰实例。
那个路径到脚本文件中配置模板的定义。
在默认安装，你会发现一/模板文件夹/MagnoliaEnterpriseEdition/apache-tomcat-5.5.27/webapps/magnoliaAuthor。
这是模板通常设脚本。
这通常是一个好主意，你的模板文件夹结构，例如：
/模板/MyProject的/模板为脚本和模板/模板/MyProject的/段段的脚本。
创建和测试新的页面模板
一旦已定义的模板和脚本文件创建，模板将供使用。
要查看模板，创建一个新的网页在网站工作区和分配新模板它，通过选择项目：
我的新模板在模板列。
接下来，双击页图标，打开该网页。
其结果可能看起来有点令人失望，但这只是一个很基本的网页。
现在，基础设施（模板定义和脚本）到位，动态内容和到对话框链接可以添加。
这些主题充分讨论，在以下几节。
处理内容
即使我们的网页很简单，只包含静态文本，它已经有几个属性。
为了演示如何处理动态内容，我们将使用系统变量，content.title，以显示内容标题财产。
在木兰，对象的系统提供一些暗示，一个完整的清单中可用模板参考页面。
若要动态显示网页标题在浏览器窗口和/或标签的标题，重新打开您的模板脚本文件，helloworld.jsp/超长，并使其适应如下：
...
的<
标题>
$（content.title）“/标题”
“/头”
Body>
h1>
$（content.title）“/H1基因”
p>
，您好木兰世界！
“/页”
下一步，请刷新您好木兰世界！
在网站页面的工作区，请注意窗口和分页标题现在已改显示那个页面标题网页的。
如果您创建新模板，窗口和标签名称将改变动态地显示在页面标题分配给在网站工作区中的其他页的其他网页。
当网页标题被修改，修改后的网页的标题将显示在页面刷新或重新加载。
页，和一般的节点，可以有任意数量的属性，可在查看浏览器的JCR。
这有助于加深对网页的结构，更好的理解。
全部节点（网页或内容，对象）和属性（节点数据对象），在网站工作区中创建的自动上市在联合委员会的浏览器。
例如，所有属性和段落添加到页面显示。
至打开联合委员会的浏览器，在点击工具按钮在导航窗格中，选择浏览器的JCR（网站）从下拉列表中出现。
我们的新页，您好木兰世界！
（/你好世界），有一个单一财产：
标题，连接到它。
标题财产被自动添加页面时创建对应于该网站工作区的标题栏的信息。
任何额外的网页，新模板的，也有一个附加的标题属性。
作为进一步的页面属性被添加到工作区网站的网页，在浏览器中的JCR属性将自动更新。
添加主酒吧
总的来说，到目前为止，我们已经创建了一个网页，内容是有关如何阅读内容元素。
我们的下一步是添加和编辑网页内容。
那个三添加和编辑内容的要点：
∙工具栏的按钮打开对话框;
∙对话框，允许作者来添加和编辑内容;
∙段，其中提到的对话。
那个主要的编辑栏包含预览，AdminCentral和页面属性按钮。
这些按钮允许作者开放AdminCentral，预览页面并插入页面属性，分别为。
通常情况下，主要栏将被定位在一个页面的顶部。
最简单的方法来添加主栏是使用mainBar标签，载于木兰标签库。
所有可用的标记列表上可以找到的不育系标记库页。
插入mainBar标签到我们的模板脚本涉及二步骤：
∙包括木兰核心标签图书馆本身：
与标签库指令：
“％@标记库乌里=“厘米，标签库”前缀=“厘米”％“
与分配指令：
[＃分配厘米=JspTaglibs[“厘米，标签库”]]
∙使用那个mainBar标签显示主栏：
“厘米：
mainBar
对话=“我页，性能对话”
标签=“网页属性”
adminButtonVisible=“正确的“/“
[@cms.mainBar
adminButtonVisible=正确的/]
至插入那个图书馆和mainBar标签到您的模板脚本，调整的内容helloworld.jsp/超长如下：
“@页面的ContentType=％“文本/HTML;
字符集=UTF-8的”语言=“爪哇”％“
“/体”
“/的HTML”
“元的HTTP-EQUIV=“内容类型”内容=“文本/HTML;
字符=UTF-8的”/“
上面的代码包含了若干属性关于mainBar标签。
这些是：
∙对话：
这个属性定义对话框时使用的网页属性按钮被点击。
我们将创建这在下一节对话框。
请注意，在所有木兰木兰以前版本3.6.2，此属性被称为段。
如果您正在从事的玉兰早期版本，在参数mainBar标签，“对话框=“我的页，性能对话“”应改为“第=“我的页，性能对话“”。
∙标签：
这是按钮标签分配给页面属性对话框。
∙adminButtonVisible：
真：
这包括在编辑栏中AdminCentral按钮。
一旦你适应您的模板脚本文件，刷新在网站工作区和您的网页主酒吧现在将出现在上方的页面。
在这一阶段，主要栏显示在页面上文本的顶部。
该DIV的主要栏中使用导致此标记。
为了解决这个问题，在您的模板脚本文件，只需添加一对夫妇<
br/>
标记后mainBar标记和网页上的文字将再次清晰可见。
当预览按钮按一下，主要栏将被删除，该网页将显示它会在公共实例。
当您单击网页属性按钮，一个错误对话框将打开。
其原因是该网页的属性对话框中，我们的标签是指，不，然而，存在。
这将是建立在下面的部分。
定义页面属性对话框
我们的下一步是定义页面属性对话并让我们的模板，使用它。
为了简单起见，并展示如何利用现有对话可以很容易地使用和调整，我们将复制的样本mainProperties对话，这在包括样品模块。
模块的样品中不包括木兰电子工程标准4.1包，并可以下载这里。
要安装此模块，jar文件复制到你的WEB-INF/lib目录下，然后重新启动木兰。
重新启动后，当您启动玉兰，您将需要更新，其中包括样本模块。
要做到这一点，只需点击开始安装/更新的初始窗口按钮，并在其后的过程将自动发生。
至创建那个我页，属性对话，提到的mainBar标记在模板上面的脚本：
∙在配置工作区，开放/模块/样本/对话;
∙右键点击mainProperties内容节点，并选择“复制”从上下文菜单;
∙位置在副本样品//对话文件夹，重命名我页，性能对话;
∙如果您已经有一个自定义自己的模块对话框设置，只需移动我页，性能对话此文件夹。
下一步在网站工作区，刷新您好木兰世界！
网页，然后在网页属性按钮。
页面属性对话框现在将打开。
此对话框允许作者编辑网页的一般属性。
创建一个段落
总的来说，在本指南中，我们讨论了如何在前面的章节创建一个模板和结构。
内容元素现在可以添加到模板的使用段落，您可以添加您喜欢的许多段落。
那个newBar标签，载于木兰标签库是用来插入一个绿色的编辑栏包含新的按钮为模板。
此按钮允许作者插入新的段落在网页上。
单一段可使用一次，或多次。
我们还可以创建一个多段型系统。
阿多段型系统允许作者选择款型将在内容地区使用，而单一型段，允许只插入预先定义的内容区域段落类型。
随着多段型系统，就今年的新建按钮提交点击，打开一个对话框显示的段落，作者可以选择的选择。
一旦一个段落类型已在第一个对话框，对话框中选择进一步开放，同时，真正的网页内容插入。
与单式段，第二个对话框即对话框到其中的实际内容插入，直接打开时，新建按钮被点击。
那个newBar标签确定是否只有一个，或选段，将提供给作者。
在这一节中，我们将创建一个多段型系统。
我们段将用于简单地添加文本网页。
为了插入或修改内容，一个对话框，要求和我们的第一步是创建文本块对话框。
准备的对话
我们的文本块对话将有一个单独的内容元素。
那个对话框定义是建立在配置区。
理想的话，应该添加到自己的模块，但对于本指南的目的，我们将其插入模板模块。
至创建对话框定义：
∙在配置工作区，打开/模块/模板/对话/并创建一个新的子文件夹名为MyProject的;
∙在新的MyProject的文件夹，添加一个新的内容节点命名tabTextBlock和数据节点命名高度;
∙根据tabTextBlock内容节点，添加两个数据节点命名controlType和标签;
∙添加更多的内容节点命名TextBlock的作为一个子节点tabTextBlock;
∙根据TextBlock的内容节点，增加6个数据节点命名controlType，描述，高度，标签，名字和类型;
∙如有需要，适应对话文本块以适应自己的设置。
对话可分为内的子文件夹组织的目的。
详细定义的对话框这里只是提供证明我们能做些什么的段落。
欲了解更多信息，请参阅创建一个对话框节下面。
创建段的定义
一旦文本块对话已经建立，下一步是要创建那个文本块段本身。
用于创建段的过程是很类似的创建模板涉及第一款的定义，创建，然后是一段脚本。
该段寄存器定义在木兰段。
对于本指南的目的，该段将创建的定义在模板模块，但理想的，它应该被添加到自己的模块。
至创建该段定义：
∙在配置工作区，开放/模块/模板/段并创建一个新的子文件夹名为MyProject的;
∙在新的MyProject的文件夹，添加一个新的内容节点命名myTextBlock;
∙根据myTextBlock内容节点，增加6个数据节点命名描述，对话，名字，templatePath，标题和类型;
∙如有必要，调整的内容myTextBlock以适应自己的设置。
如需有关的属性，这是该段定义的现有资料，请参阅段属性的完整列表。
创建脚本段
一旦该段已创建的定义，下一步是要创建那个脚本段。
该脚本将执行每当文本块段使用。
无论JSP或FreeMarker的可用于创建脚本段。
我们的脚本将创建非常简单，只显示在文本的细节文本块对话窗口。
如案件模板脚本，该段脚本应置于内的任何地方webapps文件夹中的玉兰实例。
此文件夹内的准确位置是无关紧要的，因为到脚本文件的路径配置在该段中定义。
至创建那个脚本段：
模板/MyProject的/段;
∙创建一个新的JSP或超长脚本文件名为myTextBlock.jsp/超长并插入下面的代码：
%@tagliburi="
cms-taglib"
prefix="
cms"
%>
styletype="
text/css"
.myTextBlock{
font-style:
normal;
font-size:
10pt;
text-decoration:
none;
font-family:
Verdana,Helvetica,Arial,sans-serif;
}
/style>
pclass="
myTextBlock"
${content.textBlock}
/p>
例如使用Freemarker的语法:
[#assigncms=JspTaglibs["
]]
添加该段段系统
至添加我们的一段，段系统，我们只需添加到款newBar标签。
木兰会自动创建必要的段落选择对话框。
此对话框允许作者选择从选段类型由可用newBar标签。
我们的新段将纳入我们的模板前面创建本指南。
至纳入那个段到模板，修改模板脚本：
helloworld.jsp/超长如下：
…
${content.title}<
/h1>
HelloMagnoliaWorld!
cms:
contentNodeIteratorcontentNodeCollectionName="
myNewCollection"
includeTemplate/>
/cms:
contentNodeIterator>
newBarcontentNodeCollectionName="
paragraph="
myTextBlock,samplesHowToJSP,samplesHowToFTL,samplesControlsShowRoom,samplesSearchResult"
…
在Freemarker模板，你可以使用一个段落呈现的语法非常类似于JSP的是，在木兰不育系使用标记库：
[@cms.contentNodeIteratorcontentNodeCollectionName="
]
[@cms.includeTemplate/]
[/@cms.contentNodeIterator]
[@cms.newBarcontentNodeCollectionName="
/]
上面的脚本，同时增加我们的TextBlock的段，以及所有段落载样品模块。
为了使该段脚本，我们的页面模板使用includeTemplate标签。
此标记检查templatePath财产段的定义，我们在上一节创建的。
在创建输出，templatePath属性存储的句柄脚本。
一个概念收集是由木兰和转介到newBar标签。
集合好比一个容器，它保存的所有网页的段落。
阿段由段相关的信息，例如在集合序列，实际内容由作者作出了贡献。
添加收藏并不复杂。
只需使用newBar标签，
升级会员 