1、应用 Magnolia 模板发布网站1. 入门首先直接拷贝 magnolia-4.5.8 工程包,直接启动 magnolia-4.5.8 apache-tomcat-6.0.32binstartup.sh 文件启动。1.1.网站登录1. 首先,在浏览器上输入 http:/localhost:8080/2. 其次,选择 Author instance 登陆,如下图:1.2. 语言设置Mognlia 支持多国语言,首先我们先来将转变为中文开发者登录网站发布后登录入口点击 User:superuser 处,修改语言类型。2. 如何使用模板Magnolia 模板制作分为两大部分:模板定义和站点配置及预
2、览 。点击此处在下拉框里选择Chines(China)2.1. 模板定义模板定义包括三步:模板内容编辑 可视化对话框编辑 页面模板定义。需要按照以上三步逐一配置完成后,才能进行第二大部分站点配置和发布。2.1.1. 模板内容编辑a) 创建模板文件夹,在左边菜单打开 Templating Kit Tempaltes,在后边的主界面中点开 templating-kit 目录下 pages 文件夹中新建 indiaNews 文件夹 b) 创建 FTL 模板文件,注意在 magnolia 中创建 ftl 文件,不需要带 ftl 后缀。Helloword.ftl 文件内容如下cms.init /hell
3、oword this is Hellowordedit:$content.edit link:$content.link c) 将上述 ftl 内容粘贴到 helloword.ftl 中后,一定要勾选上下图中d) 勾选后,保存,在列表上能看到 Enabled 属性为 truee) 至此模板内容编辑完成。不带 ftl 后缀2.1.2. 可视化对话框编辑a) 创建对话框文件夹:完成模板内容编辑后,进入对话框编辑,在左边菜单打开 Templating Kit Dialog Definitions,在后边的主界面中点开templating-kit 目录下 pages 文件夹中新建 indiaNews
4、文件夹。b) 创建对话框:在 indiaNews 文件夹下,可以创建一个内容节点helloword,同时创建两个数据节点:i18nBasename、label,属性值配置见图二(该属性是否必须目前不清楚)具体如该数据节点在展现形式上即对应一个对话框。如下图:c) 创建对话框中 tab 页面:在 b 步骤中创建的 helloword 内容节点下,再创建一个内容节点 tab1,同时创建三个数据节点:controlType、description、label (label 和 controlType 为必须的) 。其中controlType 为 Tab,该类型为 magnolia 内置节点类型,详见
5、以下网址http:/documentation.magnolia- tab 页面,如下图:d) 创建对话框中 tab 页面的元素:在 c 步骤中创建的 tab1 内容节点下,再创建两个内容节点 edit(类似于 HTML 中的 input 框)和 link(类似于HTML 中标签) ,再分别创建三个节点数据:controlType、description、label ,余下配置与 c 步骤中 tab 配置相同。Tab 节点这两个内容节点在具体表现上即对话框中的 edit 编辑框和 link 链接地址配置框,如下图:e) 最后对话框创建完成后,应该如下图所示图二2.1.3. 页面模板定义页面模板
6、定义主要是建立模板内容和可视化对话框之间的关联关系。创建步骤类似对话框创建,首先在左边菜单打开 Templating Kit Template Definitions,在后边的主界面中点开 pages 目录下在先创建 indianews 文件夹,再创建 helloword 内容节点,最后创建 helloword 下的节点数据。节点数据属性值的要求:bodyId 、title 最后配置成一样的,并且是具有业务意义的名称,方便最后模板与页面关联时查找。category 的属性值有很多种,目前我了解的是三种home、functional、section,这三种的区别:home 类型模板只能被发布网站
7、中的一级页面使用、Edit 编辑框Link 编辑框functional 类型模板可以被发布网站中的任意一级页面使用、section 类型模板只能在非一级页面使用。dialog 属性值:standard-templating-kit:indianews/helloword,该值前半部 standard-templating-kit:固定不变,根据我们要使用 2.1.2 中定义的dialog 路径修改后半部分:indianews/hellowordmodelClass 属性值:此值为空templateScript 属性值:此处配置 ftl 模板的相对路径,但是需要在文件名后加上 ftl,本文档中:
8、/templating-kit/pages/indiaNews/helloword.ftl 具体配置见下图:2.2. 站点配置预览站点配置及预览包括两步骤:站点设置 站点预览编辑2.2.1. 站点设置a) 首先在左边菜单打开 Templating Kit Site Configuration,在后边的主界面中点开 templates availability templates,在 templates 节点下复制一个其他节点并修改名称为 helloword,该内容节点只有一个节点数据idb) 修改节点数据 id 的值: standard-templating-kit:pages/indiane
9、ws/helloword前半部 standard-templating-kit:为固定的路径标识不需要修改,后半部pages/indianews/helloword 为 2.1.3 章节中定义的 helloword 的相对路径。具体见下图:2.2.2. 站点预览编辑至此目模板定义工作已经完成,接下来我们可以在站点中创建自己的网站了。a) 首先在左边菜单打开站点菜单项,在后边空白处点击右键,创建一个新的页面修改其名字为 HelloWorldb) 其次修改该页面的模板为我们之前定义的模板 helloword, (此处默认为 Home) 。c) 最后我们在页面上右键打开页面,可以看到如下图所示:d) 点击上图中右上角红色出可以进行对页面内容进行编辑3. 如何发布网站完成本文档中上述步骤后,我们只差最后一步,正式发布网站3.1. 激活网站所有控件我们需要对 2.1、2.2 中我们所有定义的 indianews 相关的模板、对话框、站点配置、页面等进行激活操作。此处只描述模板激活,其他类似。在下图中红色圈处 indiaNews 处右键点击,在弹出的菜单上,选择激活该节点及其包括的所有子节点3.2. 查看发布的网站查看 1.1 章节中图示:网站发布后登陆入口,登录后看到如下页面直接访问 helloword