magnolia模板编写上传发布文档.doc

精品文档应用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处，修改语言类型。在下拉框里选择Chines（China）2. 如何使用模板Magnolia模板制作分为两大部分：模板定义和站点配置及预览。2.1. 模板定义模板定义包括三步：模板内容编辑 可视化对话框编辑 页面模板定义。需要按照以上三步逐一配置完成后，才能进行第二大部分站点配置和发布。2.1.1. 模板内容编辑a) 创建模板文件夹，在左边菜单打开Templating Kit Tempaltes，在后边的主界面中点开templating-kit目录下pages文件夹中新建indiaNews文件夹 b) 创建FTL模板文件，注意在magnolia中创建ftl文件，不需要带ftl后缀。Helloword.ftl文件内容如下 cms.init /hellowordthis is Hellowordedit:$content.editlink:$content.linkc) 将上述ftl内容粘贴到helloword.ftl中后，一定要勾选上下图中d) 勾选后，保存，在列表上能看到Enabled属性为true不带ftl后缀e) 至此模板内容编辑完成。2.1.2. 可视化对话框编辑a) 创建对话框文件夹：完成模板内容编辑后，进入对话框编辑，在左边菜单打开Templating Kit Dialog Definitions，在后边的主界面中点开templating-kit目录下pages文件夹中新建indiaNews文件夹。b) 创建对话框：在indiaNews文件夹下，可以创建一个内容节点helloword，同时创建两个数据节点：i18nBasename、label，属性值配置见图二（该属性是否必须目前不清楚）具体如该数据节点在展现形式上即对应一个对话框。如下图：c) 创建对话框中tab页面：在b步骤中创建的helloword内容节点下，再创建一个内容节点tab1,同时创建三个数据节点：controlType、description、label（label和controlType为必须的）。其中controlType为Tab，该类型为magnolia内置节点类型，详见以下网址/reference/controls.html#link，该内容节点在具体表现上即对话框中的一个tab页面，如下图：Tab节点d) 创建对话框中tab页面的元素：在c步骤中创建的tab1内容节点下，再创建两个内容节点edit（类似于HTML中的input框）和link（类似于HTML中标签），再分别创建三个节点数据：controlType、description、label，余下配置与c步骤中tab配置相同。这两个内容节点在具体表现上即对话框中的edit编辑框和link链接地址配置框，如下图：Link编辑框Edit编辑框e) 最后对话框创建完成后，应该如下图所示 图二2.1.3. 页面模板定义页面模板定义主要是建立模板内容和可视化对话框之间的关联关系。创建步骤类似对话框创建，首先在左边菜单打开Templating Kit Template Definitions，在后边的主界面中点开pages目录下在先创建indianews文件夹，再创建helloword内容节点，最后创建helloword下的节点数据。节点数据属性值的要求：bodyId 、title最后配置成一样的，并且是具有业务意义的名称，方便最后模板与页面关联时查找。category的属性值有很多种，目前我了解的是三种home、functional、section，这三种的区别：home类型模板只能被发布网站中的一级页面使用、functional类型模板可以被发布网站中的任意一级页面使用、section类型模板只能在非一级页面使用。dialog属性值：standard-templating-kit:indianews/helloword，该值前半部standard-templating-kit:固定不变，根据我们要使用2.1.2中定义的dialog路径修改后半部分：indianews/hellowordmodelClass属性值：此值为空templateScript属性值：此处配置ftl模板的相对路径，但是需要在文件名后加上ftl，本文档中：/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/indianews/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相关的模板、