WCM 5.2 发布置标附录
页面发布工作原理
传统上,人们建立一个Web站点主要是靠手工维护HTML页面的方式进行的,这就要求维护人员不但要熟悉HTML技术,同
时也需要人工维护大量的页面链接,这样不仅
导致大量的死链接产生,同时也往往会严重影
响网站内容的更新速度。
TRS WCM 的发布功能为解决上述问题,
提供了一套强大的站点建立、管理工具,同时
能够实现一定的权限控制和流程控制,保证系
统的安全。在页面发布过程中,TRS WCM 的
发布功能正是依靠程序自动结合HTML模板和
数据库中的数据,生成最终的HTML页面的,同时可以自动生成页面的链接而不需要手工干预。其静态页面的工作原理见上图。
HTML 和 TRS 置标
每个页面都必须遵循Web页面标准,才能被浏览器很好的解释和显示,TRS置标本身也是符合HTML标准的附加置标方式,TRS置标和HTML、XML标准兼容。含有TRS置标的Web页面,它可以被任意可视化的Web编辑器(如:DreamWeaver、FrontPage)或非可视化的文本编辑器编辑。在频道定义时需要指定所使用的模板文件,分别控制概览页面和细览页面的表现。
TRS置标说明
置标的主要作用是控制数据在模板中的表现形式,将数据与表现分开。主要思路是TRS置标处理数据的内容,存放的位置以及如何存放等,数据的表现形式则由标准的html语言描述,例如:
其中:第二行是TRS置标,其它部分是标准的HTML置标。TRS置标表明要
在该位置放置字段名为“标题”的字段内容。
根据系统的需要和使用方便,在TRS WCM系统的置标中主要采用了四种类型
的置标,即:
?概览置标
主要用于表示一个循环的属性,例如TRS_DOCUMENTS、TRS_CHANNELS、TRS_RELNEWS等。
?TRS_RECORD
只能在概览置标内部使用;一个概览置标内可以放置多个TRS_RECORD,用来
控制文档不同显示风格。语法如下:
……
一般可以用来作为不同风格显示的控制标记,也可以实现特殊效果,比如实现
一行多列的效果。
?细览置标
主要用于引用某个具体的数据库字段,例如TRS_DOCUMENT、TRS_CHANNEL等。
?TRS_TEMPLATE
用来实现模板的嵌套,嵌套模板支持多级。语法如下:
模板的问题。
TRS置标统一以“
与 应成对出现,其中细览置标可以这样撰写
据库的输出内容所替代。每个置标都可以有多个置标属性,以实现不同的控制目的。XXX表示当前所取的对象类型,比如文档置标就是DOCUMENT;最后的字母为S表
示是一个概览置标,获取的是一个循环。
其中ID属性表示当前置标所代表的对象从哪个地方获取;例如TRS_DOCUMENTS中的ID表示的是从哪个频道获取文档集合;FIELD属性表示当
前置标获取的是对象的那个属性,和数据库字段一一对应;例如 FIELD=”DOCTITLE”/>表示获取的是当前文档的标题属性。 详细说明: 约定: 下面置标语法中所提及的 属性的详细说明中的斜体表示自定义的项,粗体表示默认,普通表示可选项 TRS_DOCUMENTS: 文档列表 语法 描述 显示文档列表,顺序与频道“文档列表”页面相同。显示的内容由相应的细览置标 属性 属性 属性描述 类型 取值 说明 频道名称 当前站点存在的频道名称 PARENT 当前频道的父频道 ID 表示当前的文档集合从那个频道获取 字符串 OWNER 当前频道 -1 表示为当前频道 CHILDIND EX 设置从指定频道(ID )的哪个子频道获取文档 数字 ≥0的整数 表示为第几个子频道 CHANNELT 频道类型 数字 普通频道 1 图片新闻,获取指定频道的图片新闻的文档 YPE 2 头条新闻,获取指定频道的头条新闻的文档 STARTPOS 设置从哪个位置 读取记录 数字 ≥0的整数默认为0 NUM 设置显示的最大 记录条数 数字>0的整数 默认为系统设定的最 大数目 PAGESIZE 使用分页显示,每 一页显示的记录 数目 数字>0的整数 默认表示不进行分页 显示 WHERE 额外的检索条件, 对指定频道的记 录进行再检索 字符串 SQL检索表 达式 默认不检索 ORDER 额外的排序条件, 对指定频道的记 录进行再排序 字符串 SQL排序表 达式 默认不排序 true 如果存在更多,产生 更多链接 AUTOMORE 设置是否产生更 多 字符串 false 即使存在更多,不产 生更多链接 BEGINMOR E 更多链接的HTML 开始部分(A元素 之前) 字符串HTML代码默认不产生 ENDMORE 更多链接的HTML 结束部分(A元素 之后) 字符串HTML代码默认不产生 MORETEXT 设置更多链接的 描述文字 字符串Text 更多的描述文字,默 认为:“更多内容…” MOREEXTR A 链接元素上扩展 的HTML内容 字符串HTMLAttr扩展的HTML内容 Name 目标窗口的名称 _blank新开一个窗口 _parent在父窗口打开 MORETARG ET 设置更多打开后 的窗口目标 字符串 _self在当前窗口打开 _top在顶级窗口打开 例子 显示当前频道前10条文档 显示当前频道前10条文档,同时定义更多的方式 按照一页20条显示当前频道的前500篇文档 显示“国际新闻”频道前10条文档 显示“新闻中心”第一个子频道的前10条文档 显示“新闻中心”头条新闻 TRS_RELNEWS: 相关新闻 语法 描述 检索设置的关键词及手工设置的相关文档并显示相关的新闻内容。利用MODE属性,可以获得三种不同的相关新闻集合,发布时,如果MODE没有设置,则系统默认取值为USERDEF,表示只检索手工设置的相关文档并显示。只能应用到细览模板 属性 属性 属性描述 类型 取值 说明 NUM 设置显示的最大 记录条数 数字≥0的整数 默认为系统设定的最 大数目 STARTP OS 设置从哪个位置 读取记录 数字≥0的整数默认为0 MODE 相关新闻提取的 方式 字符串USERDEF 只提取用户手工设置 的相关文档 KEYWORDS 表示从站点所有文档中提取包含当前文档设置的关键词的所有文档 ALL 表示提取USERDEF 和KEYWORDS 两种方式可以获得的所有相关新闻,并且剔除编号相同的文档 例子 人工相关,必须手动指定 自动相关,按照关键词自动进行检索 获取所有相关文档 TRS_CHANNELS: 频道列表 语法 描述 显示指定父频道的所有子频道链接。需要系统能够自动产生一个频道列表的时候,使用此项。目的在于使系统自动产生一个带有链接的频道列表,并放置在置标所在的页面中。 属性 属性 属性描述 类型 取值 说明 频道名称 当前站点存在的频道名称 PARENT 当前频道的父频道 ID 表示从那个频道获取频道集合 字符串 OWNER 当前频道 -1 表示为当前频道(ID) CHILDIN DEX 设置从指定频道(ID )的哪个子频道获取频道集合 数字 ≥0的整数 表示为第几个子频道 STARTPO S 设置从哪个位置读取子频道 数字 ≥0的整数 默认为0 NUM 设置显示的最大子频道数 数字 ≥0的整数 默认为系统设定的最大数目 CHILDTY PE 所取子频道的类型 数字 -1、0、 1、2 -1为取所有类型的子频道,0为普通频道,1为图片新闻,2为头条新闻, 例子 显示当前频道的子频道列表(从第2个子频道开始) TRS_CHANNEL: 获取指定频道信息 语法 描述 显示指定频道(ID,ChildIndex)指定字段(Field)的信息。 属性 属性 属性描述 类型 取值 说明 频道名称 当前站点存在的频道名称 PARENT 当前频道的父频道 ID 指定的频道 字符串 OWNER 当前频道 -1 表示为当前频道 CHILDIN DEX 设置指定频道的子频道数字 ≥0的整数 表示为第几个子频道 FIELD 频道属性名称 字符串 频道字段 名称 在数据字典中定义,默认为CHNLDESC (频道显示名称) NUM 设置显示的最大长度 数字 >0的整数 默认不限制,必须大于“TRUNCATEDFLAG ”字 符串的长度,否则不会截断。 DATEFOR MAT 设置日期的显示格式 字符串 日期格式字符串 区别大小写(y:年 M:月 d:日 H:时 m: 分s:秒),默认为yyyy-MM-dd HH:mm:ss ;仅仅对于日期属性有效 true 需要格式化 AUTOFOR MAT 是否按照指定方式格式化当前数据 字符串 false 不需要格式化 HTML 按照HTML 方式格式化代码(回车? 按照HTML 元素属性的方式转义数据(&?& "?" 等等) JAVASCRI PT 按照JavaScript 数据规则转义数据("?\” \?\\等等) AUTOFOR MATTYPE 格式化类型 字符串 XML 按照XML 元素属性的方式转义数据(&?& "?" 等等) AUTOLIN 是否产生链 字符串 true 产生当前频道的链接 K 接,应用于CHNLNAME CHNLDESC false 不产生链接 Name 目标窗口的名称 _blank 新开一个窗口 _parent 在父窗口打开 _self 在当前窗口打开 TARGET 链接打开后的窗口目标 字符串 _top 在顶级窗口打开 EXTRA 链接元素上扩展的HTML 内容 字符串 HTMLAttr 扩展的HTML 内容 true 产生链接内容提示 LINKALT 是否产生链接的内容提示 字符串 false 不产生 LINKALT TEXT 设置链接的内容提示文字 字符串 Text 链接的内容提示文字,默认为当前属性值 TRUNCAT EDFLAG 频道名称被截断后,附 加在后面的字符串 字符串 Text 默认”...”,即三个半角省略号 例子 显示科教新闻频道的名称,并且产生链接 显示新闻中心第一个子频道的信息,并且产生链接 TRS_DOCUMENT:文档详细信息 语法 [EXTRA=”A元素上扩展的HTML内容”] [TARGET=”窗口目标”] [LINKALT=”链接是否显示提示”] [LINKALTTEXT=”链接提示内容”] >通用细览 描述 从文档提取指定属性[FIELD],按照指定的方式生成内容替换当前的置标内容。 属性 属性 属性描述 类型 取值 说明 文档字段名称在数据字典中定义, 默认为DOCTITLE(文档标题) DOCSOURC E 文档来源 DOCFROM文档来源FIELD文档属性名称字符串 DOCSECUR ITY 文档安全级别 NUM 设置显示的最大 长度 数字>0的整数默认不限制 DATEFORM AT 设置日期的显示 格式 字符串 日期格式 字符串 区别大小写(y:年 M:月 d:日 H:时 m: 分s: 秒),默认为 yyyy-MM-dd HH:mm:ss;仅仅对于日 期属性有效 true需要格式化 AUTOFORM AT 是否按照指定方 式格式化当前数 据 字符串 false不需要格式化 AUTOFORM ATTYPE 格式化类型字符串HTML 按照HTML方式格式化代 码(回车? ? 等等) HTMLValu e 按照HTML元素属性的方式转义数据(&?& "?"等等) JAVASCRI PT 按照JavaScript数据规则转义数据("?\”\?\\等等) XML 按照XML元素属性的方式转义数据(&?& "?"等等) true 产生当前文档的链接,对于来源为来源链接。对于DocTitle,默认为true,但在细览页面AUTOLINK无效。 AUTOLINK 是否产生链接,不 允许AUTOLINK 的字段有: DOCHTMLCON,D OCHTMLCONTEN T,DOCPUBHTML CON,DOCPUBTI ME,DOCSECURI TY 字符串 false 不产生链接;对于其它属 性默认为false。 Name目标窗口的名称 _blank 新开一个窗口 _parent 在父窗口打开 _self 在当前窗口打开 TARGET 链接打开后的窗 口目标 字符串 _top 在顶级窗口打开 EXTRA 链接元素上扩展 的HTML内容 字符串HTMLAttr扩展的HTML内容 true 产生链接内容提示 LINKALT 是否产生链接的 内容提示 字符串 false不产生 LINKALTT EXT 设置链接的内容 提示文字 字符串Text 链接的内容提示文字,默 认为当前属性值 例子 显示标题字段的内容,不设定长度 显示标题字段的内容,并设定长度为50显示日期字段的内容,并且格式化日期显示摘要,并且格式化 显示文档来源 TRS_APPENDIX:文档附件 语法 描述 在细览中显示当前文档的附件内容。 属性 属性 属性描述 类型 取值 说明 PIC 图片 FILE 文件 LINK 链接 MODE 附件类型 字符串 ALL 所有附件 FIELD 附件属性名称 字符串字段名称 WCMAppendix 的字段名称 -1 表示获取所有的附件 INDEX 获取指定序号的附件 数字 ≥0的整数 指定的序号 true 产生当前附件的链接 AUTOLIN K 是否产生链接 字符串false 不产生链接 EXTRA 链接元素上扩展的HTML 内容字符串HTMLAttr 扩展的HTML 内容 BEGINHT M L 附件前面额外HTML 代码 字符串HTMLAttr 附件前面额外HTML 代码 ENDHTML 附件后面额外HTML 代码 字符串 HTMLAttr 附件后面额外HTML 代码 true 产生图片说明 MEMO 是否产生图片说明。此属性只对图片附件有效 字符串 false 不产生图片说明 BEGINHT ML 图片说明前面 额外HTML代 码。此属性只对 图片附件有效 字符串HTMLAttr 附件前面额外HTML 代 码 ENDHTML 图片说明后面 额外HTML代 码。此属性只对 图片附件有效 字符串HTMLAttr 附件后面额外HTML代 码 如果没有设置FIELD,默 认为 SEPERAT OR 多个附件之间 的分隔符 字符串 \n 如果设置了Field,默认 \n 例子 显示文档的第一个图片附件 显示文档的第一个文件附件 显示文档的第一个链接附件 TRS_CURPAGE:当前位置 语法 描述 显示该页面在当前站点中的地图,可以显示自己或包含自己和所有父节点的层次关系,可以应用到概览模板和细览模板中。 属性 属性 属性描述 类型 取值 说明 VALUE路径中频道字符串Separato频道名称之间的分隔符 名称之间的分隔符 r 默认为 “>” true 仅仅显示自己 ONLY 仅仅显示当前频道 字符串 false 显示完整的路径 true 路径中每一个节点产生链接 AUTOLINK 是否产生链 接 字符串 false 不产生链接 Name 目标窗口的名称 _blank 新开一个窗口 _parent 在父窗口打开 _self 在当前窗口打开 TARGET 链接打开后的窗口目标 字符串 _top 在顶级窗口打开 EXTRA 链接元素上扩展的HTML 内容 字符串HTMLAttr 扩展的HTML 内容 例子 显示当前所在的频道路径 TRS_DATETIME:发布日期 语法 描述 显示发布该页面的发布日期 细览置标;独立使用;可以应用到概览模板和细览模板 属性 DATEFORMAT 说明 z DATEFORMAT字符串,设置日期的显示格式。 日期格式字符串,区别大小写(y:年 M:月 d:日 H:时 m: 分s:秒) 默认为yyyy-MM-dd HH:mm:ss; 仅仅对于日期属性有效 例子 显示当前的发布时间 TRS_REPLACE:替换内容 语法 描述 根据名称显示在频道中定义替换内容的内容。独立使用,可以应用到概览模板和细览模板。 属性 VALUE 说明 VALUE="替换名称"属性是必须要设置的。 例子 如果在频道A和B中都定义了替换内容DEMO,并分别给他们赋值https://www.doczj.com/doc/1310123412.html,和https://www.doczj.com/doc/1310123412.html,。同时在他们使用的共同模板C中使用 href=https://www.doczj.com/doc/1310123412.html,>https://www.doczj.com/doc/1310123412.html, 在模板中替换已定义内容 TRS_RECPATH:记录路径 语法 描述 显示当前记录的绝对路径,可应用到概览模板和细览模板中。 属性 说明 例子 …… TRS_RECORD:分组显示置标 语法 描述 获取指定记录数的数据并结合column_block中定义的内容显示 不能独立使用;必须结合概览置标才能使用 属性 NUM 说明 z NUM 数字设置显示的最大记录条数 >0的整数,默认为1 例子 多行显示文档,一行显示三篇文档 TRS_TEMPLATE:嵌套模板 语法 描述 指定当前的位置使用嵌套模板的内容 属性 说明 例子 指定当前位置使用[页面头部嵌套模板]的内容 置标撰写样例: 显示当前频道前10条文档 Code:
, 空格? 等等) HTMLValu e
空格标题 入库时间
发布结果:
标题 | 入库时间 |
文档1(标题根据实际情况而变]) | 2005-01-01 13:20:31 |
文档2(标题根据实际情况而变) | 2005-01-02 13:20:31 |
文档3(标题根据实际情况而定) | 2005-01-03 13:20:31 |
显示当前频道前10条文档,同时定义更多的方式
Code:
标题 | 入库时间 |
发布结果:
标题 | 入库时间 |
文档1(标题根据实际情况而变]) | 2005-01-01 13:20:31 |
文档2(标题根据实际情况而变) | 2005-01-02 13:20:31 |
文档3(标题根据实际情况而定) | 2005-01-03 13:20:31 |
按照一页20条显示当前频道前500篇文档
Code:
标题 | 入库时间 |