网站内容管理系统建设手册.doc

Lerx网站内容管理系统 模板建设手册 Lerx网络科技 2012-11-12 一、概述 利用Lerx网站内容管理系统（以下简称：Lerx）建立的网站展现的内容其实都是模板的内容。Lerx本身并不主动输出HTML代码，这是Lerx的基本原则之一，即网页右键查看到的网站源代码全是模板代码即是用户自已的代码，包括Javascript代码。因此，模板对于Lerx来说至关重要，设计一份精致的模板会直接影响到网站的美观与性能。 Lerx可以很方便的将模板导入导出，导出时Lerx模板将被写入XML文件。当系统出现重大升级时，模板与系统可能出现冲突，可根据经验修改XML文件来修复模板文件。 Lerx采用标签来定义变量，模板的设计应以常变化的数据用标签来替代，一些不常变化的数据如导航菜单等等则应直接用HTML来展示，在V2版本中，一些不必要的功能被直接抛弃，如上面所提的导航菜单，这样做的目的是为了加快网站执行速度，不让系统去处理那些并不一定需要处理的功能。 Lerx内置了大量数据接口，可以在网页用利用AJAX或JS来调用。 二、操作方法 1.后台选择相应的风格模板 2.点击需要修改的风格模板右边的编辑。 3.在模板的变量列表中选择需要修改的变量，点击右边的详情进行查看或编辑。 4.修改变量后，点击提交即可。 注意：修改后将立即生效。请注意做好模板的备份工作，以防无法恢复。在操作大容量代码时，建议将变量内容复制进其它文本编辑软件如记事本、EditPlus或UltraEdit等软件进行处理完毕后再粘贴进来进行提交。 二、约定 Lerx以{$$data$$}的格式来存储标签。data是标签名称，中间可能有英文半角逗号（,）或其它一些特定字符。据此，我们进行以下约定： 标签：指类似于{$$data$$}形式的字符串，该字符串在系统执行时会被相应的数据取代。 模块变量：指各模块中的存储的各键的名称，如下图。 三、建议 1.应使用现有的模板复制为新模板后再修改，以免一些模块变量被漏写。 2.在修改模板之前，应将模板复制一份或导出，以防修改错误无法还原。 3.可以参考现有模板的代码来改写新模板。 4.应首先设计通用部分及Public子模块的代码 四、模板说明及执行顺序 V2版本模板一般分为通用模块和各子类模块（抽奖系统由于较简单，未设定子模块）。 以下说明以门户模板为例。 1.执行顺序 前台系统执行时，除play.action及上传和附件修改这几个独立页面外，其它页面均首先会读取public模块的htmlTemplate模块变量。这一模块如果为空，将输出为空白，所以这一模块变量内容至少包含标签{$$htmlBody$$}。大多数网站有html首尾都差不多，所以官方发布的模板为了减少模板代码，将{$$htmlBody$$}定义为html的< body >< /body >中的内容。 然后根据页面的不同，会读取相应的子类模块。比如，首页会读取index模块，文章页会读取article模块等等。 在子模块中，如果未定义模块变量，将自动读取public模板的模块变量及通用设置中的模块变量。比如：如果网站的css是相同的，那就可以放置在public的css标签中，所有页面将都读取这个css。 执行流程见下图。 s 2.每个子模块设立了specialCode1-4四个标签，用于放置该页面的特殊代码。 例：网站设计时大体css是相同的，但首页、分类页、文章页的css会有自己独特的部分。利用specialCode1-4可以轻松解决这个问题。解决方法：将完全公用的css代码放置在public的css区域，再在这css代码中插入{$$specialCode1$$}标签，然后在相应的页面的specialCode1变量中输入特有的css代码。比如首页就在index模块的specialCode1中输出首页特有的css代码。 3.通用设置中设定了publicCode1-4，可以在任何子模块中进行引用。如，上例中的可以反过来进行，或者其它一些通用的代码。 五、模块变量及标签详义 系统性标签 {$$charset$$} 字符集，从配置文件resourcesApplication_zh_CN.properties中获取 {$$fullSiteName$$} 站点全称 {$$shortSiteName$$} 站点简称 {$$siteName$$} 站点名称，智能标签，以简称优先获取 {$$welcomeStr$$} 站点欢迎词 {$$siteUrl$$} 站点Url，不含http前缀 {$$keyWord$$} 网站关键字 {$$description$$} 网站说明性文字 {$$actio