TurboCMS.Java模板制作指南.doc
《TurboCMS.Java模板制作指南.doc》由会员分享,可在线阅读,更多相关《TurboCMS.Java模板制作指南.doc(35页珍藏版)》请在得力文库 - 分享文档赚钱的网站上搜索。
1、.TurboCMS内容管理系统(Java 版本)模 板 制 作 指 南北京泰得文通科技有限公司修订时间:2010 年 7 月.TurboCMS2009的模板制作(频道部分)一、概述TurboCMS 是一个基于模板的内容管理系统,整个系统的使用流程如下图:表单数据库录入保存 生成模板 用户通过 WEB 表单录入信息 表单中的信息被保存在数据库中的一条记录中 某一个频道的所有信息构成了一张表,有多个频道,则数据库中可能有多个表存在。 内容中的数据结合模板生成 HTML 文件。从上面的过程可以看出,每个频道需要定义一个表单,以及一个模板。模板定义了数据呈现的形式,模板中定义的字段通常同表单中的字段是
2、一一对应的。表单数据库中的表模板三者间的关系如下图:表单 模板数据库中的表XxXxXxHTML 文件xxxxxxxxxxxxXxXxXxxxxxxxxxxxxx.频道的表单可以使用系统提供的表单定义工具生成,而模板则必须要手工制作,本文主要介绍模板的制作。1、从什么地方定义模板所谓模板,在 TurboCMS 中其实是一个普通的 HTML 文件,它定义了所有用这个模板生成的 HTML 文件的大致表现形式,包括布局、字体、颜色、风格等信息。以管理员身份登陆 TurboCMS,将会看到一个“模板”视图,其中保存的就是网站的模板文件。 “模板”视图其实是“文件夹”视图的一个快截方式,专门管理/temp
3、lates 目录。我们建议将所有的模板文件都保存在这里,如果一定要放在其他目录的话,也是允许的。如果要编辑模板文件,请首先选中某个模板文件,然后鼠标右键,选择“Notepad ”,以源代码的方式编辑模板文件。.在这个非常类似于 Windows 的 Notepad 的环境中,可以以源代码的方式编辑模板文件,并在其中插入定义模板专用的脚本。最后将文件保存下来便成为模板。2、模板和模板脚本模板一方面定义了最终的 HTML 文件的形式和风格,另一方面还定义了数据如何呈现在最终的 HTML 文件中。模板中的 HTML 定义的是形式和风格,而其中的脚本则定义了数据的呈现。当站点中的一个频道的所有信息被发布
4、时,系统构造了一个数据环境,然后将频道中的一条记录取出来,并放到数据环境中去,接下来将模板放到数据环境中去,解释执行其中的脚本,最后将所有的输出写入到 HTML 文件。系统依次处理所有的记录,每处理一条记录就执行一遍上面的这个过程。我们引入一种新的语言(TDL,Template Define Language)来定义模板中的数据输出。它是一种脚本语言,使用 Java 作为运行脚本,暴露了若干对象供脚本访问,以实现脚本中的灵活控制。模板中的 TDL 脚本用两个特殊符号分隔:。这两个符号之间的内容被当成 TDL 脚本处理,其他的内容原样地输出到 HTML 文件中去。请注意这里的分隔符与 Java
5、中的分隔符的区别。一段模板中的 TDL 脚本例:也支持表达式直接输出,等同于。模板中的 TDL 脚本是 Java 脚本,任何合法的 Java 代码都是被允许的。关于 Java 的语法基础,可以参考 Java 技术部分。在 TDL 脚本中,除了可以使用标准的 Java 代码之外,还可以访问系统提供的几个固有对象,用其同数据环境打交道,取出需要的数据。这几个对象分别是:System, ThisDocument,ThisChannel,ThisSite,ThisPage,ThisPageColumn ,ThisColumn,ThisMagazine,ThisIssue, Response。本文中对这
6、几个对象将进行详细的说明。.二、TDL 编程1、网站规划在讲解 TDL 编程前我们先来介绍一下网站规划的步骤,以便理解模板的作用。站点首页inc 文件频道一首页 频道二首页 频道三首页子频道一首页 子频道二首页.目录页(可能分页)当前频道top 5导航栏hotnewshotnewshotnewshotnews某栏目的最新几条(头条信息)带摘要的 top 10 带摘要的 top 10带摘要的 top 10子栏目导航栏文章 1 文章 n 带摘要的 top 10 带摘要的 top 10文章标题列表.文章 1文章 2 文章 3.由上图可以看出,当一篇文章提交到某个频道后,有三种文件需要生成或修改:1、
7、文章本身的 HTML 页面(文章内容页)2、频道的封面页3、上级频道以及首页中的 top 列表(通过 inc 文件体现)因此,有三种模板脚本存在:1、文章内容页模板2、封面页模板3、附带发布的模板也即是说,对每一个频道,需要制作三个模板文件,其中的附带发布模板是可选的。2、文章内容页模板制作前面我们说过,TDL 的脚本中可以访问若干个内置对象。所谓内置对象,是指不需要申明就可以直接访问的 Class 对象。文章内容页的模板制作需要访问的两个主要的内置对象是 Response 和 Document。Response 对象的目的在于从 TDL 中输出,Document 对象的主要作用是访问上下文中
8、当前处理的文章的各字段的值。Document 对象是最主要的对象,脚本通过它来取得当前数据环境中的数据,它只有三个方法.2.1 Document 对象的方法 Item(field Name)获取字段 fieldName 的值,返回字段值,是一个对象例:String Name,Sex,Age;Name = (String)ThisDocument.Item(“Name”);Sex = (String)ThisDocument.Item(“Sex”);Age = (String)ThisDocument.Item(“Age”);如果确信调用会返回的是一个对象,则应该申明相应的对象来进行调用,例:j
9、ava.util.Vector pageall = (java.util.Vector)ThisDocument.Item(“pages“);参数 fieldName 表示字段名,他们同频道的表单定义中为字段取的名字是一样的。推荐全部使用英文做字段名。在使用 Document 的 Item 方法返回字段值时应当确信字段名是在频道的表单定义中确实定义好了的,并且名称拼写没有错误。除了可以访问表单定义时定义的字段以外,有几个字段是始终可以访问的,他们是: Id,当前数据环境中的那条记录在整个系统中的唯一编号 Title,内容的标题 Author,提交这条内容的用户的用户名 SubmitDate,这
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- TurboCMS Java 模板 制作 指南
限制150内