网站开发手册

网站群智能管理平台

网站开发手册

2011年12月

辽宁软旗科技有限公司

目录

1.引言 ....................................................................................................................... - 3 -

1.1版本说明 (3)

1.2编写目的 (3)

2．标签原理 ................................................................................................................ - 3 -3．标签使用方法 ........................................................................................................ - 3 -4．标签参考 ................................................................................................................ - 3 -5．网站开发以及模板配置........................................................................................ - 7 -5.1新建站点. (7)

5.2新建栏目 (9)

5.3模板及模板所需的相关的文件的上传 (14)

5.4模板的配置编写说明 (15)

1.引言

1.1版本说明

版本作者维护日期内容描述

1.0 吴刚2011-12-13 创建文档

1.2编写目的

为了方便用户进行网站开发，特制订该手册，通过此手册能使用户充分了解CMS的标签使用、模板开发、站点开发等。

2．标签原理

模版使用html、xml作为载体，通过自动义html节点实现标签，在解析时通过html解析器将标签解析，生成html或xml文件。

3．标签使用方法

属性输出表达式：#{exception}

属性格式：Object.property，支持多层次的输出Object.property.property

支持运算函数，格式为：Function(要计算的对象,参数)

函数支持嵌套:Function1(Funtion2(Object1,P1),P2)，参数可为空，但是”,”是必须的。

如果页面中存在对象，并存在属性且没有值，输出为””

如果对象不存在，或不存在属性，原样输出表达式

列表格式:{list id=”id” domain=”类型”属性=”值”}{/list}，类型表示是取数据的范围,空白可以是空格、制表、换行，”}”前不能有空白，{/list}必须这样写

4．标签参考

使用范围属性支持输出对象或属性

页面

就是一个html或其他对象

column 当前栏目site 当前站点

格式的文件parent 上级栏目

或

article 在内容页失效

文章article id 编号

title 标题

subhead 副标题

writeDept 投稿部门

writer 作者

origin 原出处

path 文章路径

link 链接

summary 摘要

inputTime 录入时间

releaseTime ，发布时间

invalidTime 失效时间

image 默认图片id

htmlContent html内容

textContent 文本内容

inputer 录入人

栏目column id 编号

name 名称

displayName 显示名称

layer 层

image 图片id

article 备注

url 地址，首页，列表页(类型为链接的话同link)

link 外链接

path 保存路径

indexPath 首页

listPath 列表页路径

url =(path+indexPath)?(path+listPath)

站点site code 编号

name 名称

domain 域名

https://www.360docs.net/doc/1411269184.html, 管理员姓名

tel 电话

fax 传真

email

address 地址

zip 邮编

department 主办单位

undertack 协办单位

powerBy 技术支持

文章列表{list} id=id

domain=article

id.* 文章属性

no 本页中序号

num=10 取的数

据条数

offset=2 越过数

据量

column=3 输出

列数

order=[asc|desc]

排序方式

page=[true|false]

是否分页

exclude=ids

不取数据的栏目

以,分隔

from=栏目,id,栏

目

取的栏目范围,分

隔

*,#{column.id}当

前栏目

#,#{parent.id}上

级栏目

:id格式

栏目层

withSub=true

是否取子栏目

tag=t,h,b

文章标签,分隔

key=关键字

文章关键字包含

此关键字的

image=[true|false]

是否含有图片

column>1时，list中间代码必须包含 翻页标签#{page}

栏目列表{list} id=id

domain=column

num=10

offset=2

column=3

order=[asc|desc] exclude=ids

from=栏目,id,栏

目

withSub=true

同文章列表

no

广告id=id id 编号

domain= advertisement num=10

offset=2 column=3 order=[asc|desc] from=name title 标题mediaType 类型src 源地址

link 外部链接height 高度width 宽度

友情链接id=id

domain= code

num=10

offset=2

column=3

order=[asc|desc]

from=groupName

组名称id; // 编号

title; // 标题

value; // 代码值

info; // 描述orderNo; // 排序updateTime // 录入时间admin; // 录入人用户名siteCode; // 站点ID

Cut

截取一定长

度字符串，

超出以…省

略

字符串，长度#{Cut(article.title,30)}

FormatDate

转换日期格

式

日期，格式#{FormatDate(article.updateTime,yyyy-MM/dd)}

IfNull

为空输出指

定数据

属性，指定数据#{IfNull(article.writer,无名氏)}

Java

运行java函数要计算的数据

参数二：

类.方法(对数类

型参数值)

方法中多个参数

以,分隔

#1代表要计算的

数据

https://www.360docs.net/doc/1411269184.html,ng中的类，

可省略包名

参数类型是全称

#{Java(test2.no,Math.IEEEremainder(double #1,double 2))}

#{Java(site.webDir,com.capinfo.cms.util.FileUtils.getString(https://www.360docs.net/doc/1411269184.html,ng.String

#1\news\include.html,https://www.360docs.net/doc/1411269184.html,ng.String utf-8))}

Navigate

栏目导航，栏目设为不显示，则导航中不显示栏目id，本栏目

是否显示链接

${Navigate(column.id,1)}演示站点>新闻中心

${Navigate(column.id,0)}演示站点>新闻中心

Attachment 附件id，属性名#{IfNull(Attachment(test2.image,path),dsfdsf/1.jpg)}

取附件信息

属性包括

filename 原始文件名

path 附件路径 filesize 附

件大小

title 名称 info 说明

smallPath 缩略图路径

Equals 判断两个值是否相等

#{Equals(column.id,123456)} HtmlUtil

过滤html 代码 第二个参数为非空

#{ HtmlUtil (article.title,1)}

If 判断str 是否为true ，输出值。第二个参数格式为true 值:false 值

#{ If (Equals(column.id,123456),123:456)}

5．网站开发以及模板配置

5.1新建站点

1、 添加部门：登陆内容管理后单击内容管理功能选项依次展开用户管理右键添加一个

部门如图。

2、 添加用户：在新添加的部门上右键添加用户，权限暂不设置。

3、添加站点：依次展开站点管理中站点管理，添加一个站点将刚刚新建的用户设为管

理员。

点击“添加”按钮

其中站点编号为将来生成整个站点文件夹的名字（eg：sydx）

站点名称即为这个网站的名称

站点域名为当前站点的域名或者为IP加“站点编号/”

管理用户选取刚刚创建的用户。

4、为用户授权：切回到用户管理为刚被设为管理员的账户授权，默认勾选所有权限。

5.2新建栏目

添加子栏目：

根据栏目表添加相应的栏目。

鼠标点击栏目在需要添加新栏目的栏目名字上点击鼠标右键选择添加子栏目，此时界面显示如图1.

图1

点击添加子栏目之后界面显示：如图2.

图2

在以上字段中添加：栏目名称、显示名称、存放目录（存放目录务必填写规范一般为相对站点后的栏目名简拼加/）、是否显示栏目√，如果不打√就是不显示栏目，将是否生产rss 文件选项点空不选，其他选项不必填写。点击保存即可建立一个新的栏目在右侧目录显示。

若修改内容管理后的台栏目名称（一定要把栏目名称和显示名称同时修改）。

也可以右键点击快速添加子栏目选项，快速创建多个平级的子栏目。需要注意填写正确的栏目名与规范的栏目路径。如图3

图3

新建的栏目右键点击编辑栏目显示栏目功能如图4：

图4

常用栏目功能：基本属性、扩展字段、栏目权限、栏目模板。

基本属性为：图2中显示的字段。

栏目权限为：可以对此栏目进行赋权，主要针对用户对栏目的管理，如图5.

“很重要：每次新建一个用户就要给用户分配栏目权限，只有获得更多权限才能对栏目、文章进行更多的操作。”

图5

栏目模板：添加模板文件，针对于栏目所用的模板进行添加、修改、删除等操作。每一个新建的栏目都必须添加相应的模板文件。如图6

图6

*针对于模板文件、图片文件的替换（此处为重点）

模板培训：发布类模板路径：/opt/app/cms6.3/sydx/template

编辑栏目时：点击栏目模板——配置模板文件点击添加模板；

新建栏目添加模板：如图7所示

图7

每个子栏目需要配置一个列表页模板与一个内容页模板。

根据不同的栏目需要进行不同对应的配置。

栏目配置列表页模板，如图8所示：

在类型中选择列表模板。

第二项模板中所要填写的路径为：以/opt/app/cms6.3/sydx/template/为根目录下的需要使用的模板文件名。

第三项路径中所要填写的路径一般为固定写法list.html。指列表页生成的路径名

称。

图8

栏目配置内容页模板：如图9所示.：

在类型中选择内容模板。

第二项模板中所要填写的路径为：以/opt/app/cms6.3/sydx/template/为根目录下的需要使用的模板文件名。

第三项路径中所要填写的路径一般为固定写法content/{id}.html指内容页生成的路径名称。

图9

如果在保存模板中出现错误或者在重发列表页的过程中出现错误信息则说明配置的对应/opt/app/cms6.3/sydx/template/下的模板文件编写错误。

成功添加列表模板与内容模板之后，右键单击右侧目录中对应的栏目名选择发布文章，如图10所示。

图10

出现发布文章选择框后，如图11。选择重发列表页，即列表页创建成功。

图11

然后选择针对于相应的栏目添加文章，之后在栏目上如图11点击发布新文章。

如果更改模板之后需要把文章重新发布一遍，点击“重发已发文章”。如图11.

5.3模板及模板所需的相关的文件的上传

强调警告注意，每次在服务器上更换文件时需要做好严谨的文件备份工作。

1、脚本的替换，根绝模板中标签中引入的，如

language="JavaScript" src="script/all.js">脚本文件的路径和名称，在/opt/app/cms6.3/sydx/script下替换脚本文件。

2、图片的替换

/opt/app/cms6.3/sydx/images路径下有images/gjss文件夹和images文件夹为网站图片文件夹。

gjss文件夹：此文件里面的图片为静态页图片文件夹。

images文件夹：为网站图片文件夹。替换方法为：在原网站上查看图片属性，按照图片路径替换图片即可。

3、样式的替换，根绝模板中标签中引入的，如

rel="stylesheet" type="text/css" />样式文件的路径和名称，在/opt/app/cms6.3/sydx/css 下上传或替换需要更新的样式文件。

4、Flash的替换：

服务器上路径：/opt/app/cms6.3/sydx/flash。在此路径上上传或更新所需flash文件。

5.4模板的配置编写说明

列表格式:{list id=" id" domain="类型" 属性="值"}{/list}

domain，类型表示是取数据的范围,一般只取文章article或则栏目column。

属性之间必须留空白，空白可以是空格、制表、换行，”}”前不能有空白。

必须以{list}开头，以{/list}结束。

例：

{list id="id" domain="article" from=":bc939d973045b3ea01304656677402a7" num="6" withSub="true"}

·

title="#{id.title}">#{Cut(id.title,21)}

{/list}

属性说明：

1、id即为该列表所定义的id名称。

2、domain为列表的显示类型，可以是文章article或者栏目column。

3、from=栏目的id，此id为内容管理系统后台栏目所对应的唯一栏目id。如图12

图12

4、num="xx" 该属性作用为，该列表所要读取显示的条数。数字按效果图或需要填写。

5、withSub= "true" 该属性作用为，读取显示所取栏目下的子栏目文章或子栏目。若不需要显示所取栏目下的子栏目文章或子栏目，则不需要写入该属性。

6、page= "true" 该属性作用为，用于列表页模板中，判断是否在列表页中显示分页翻页，必须配合#{page}标签使用。效果如图13

图13

7、image= "true" 该属性作用为，列表中加入该属性后，仅读取显示有图片录入的文章，其他没有图片录入的文章均不显示。

8、offset-="xx"该属性作用为，越过最新录入的数据，从第xx条开始向下取数据。

列表内常见标签说明：

标签格式统一为#{id.标签名}

标签名作用：

id ——取文章编号id或者为栏目id。

title ——文章标题或者为栏目名称。

subhead ——文章的副标题。

writeDept ——投稿部门

writer ——文章作者

origin ——文章原出处

path ——文章路径

link ——文章链接

summary ——文章摘要

inputTime ——录入时间

releaseTime ——发布时间

invalidTime ——失效时间

image ——默认图片

htmlContent ——html内容

textContent ——纯文本内容

inputer ——录入人

常见的列表编写

编写模板后上传到服务器相应路径后并在内容管理系统发布成功，最后表现形式应与效果页相同如图14所示。

图14

一段列表中，一篇需要显示的文章的效果页页面代码为，如图15所示，需要注意的有三处，超链接，标题，日期。

图15

修改以上代码成为模板所需代码，如图16所示。

图16

如图16中所示，标签中，href="#{id.path}" 为该文章的跳转地址；target="_blank"为该文章链接的跳转方式，_blank为弹出一个新的页面显示；title="#{id.title}"为鼠标指在链接

上的提示名称，为该文章的全部标题名。

在标签组中，#{Cut(id.title,21)}为根据页面情况截取字段后所显示的文章标题名，同样适用于其他标签，形式如，#{Cut(id.标签名,字数)}。

#{FormatDate(id.releaseTime,MM月dd日)} 为时间标签。

更详细的时间标签可以精确到年、月、日、时、分、秒，而年月日的连接方式可以自行定义。#{FormatDate(id.releaseTime,yyyy-MM-dd HH:mm:ss)}

带图片或简介摘要的列表

编写模板后上传到服务器相应路径后并在内容管理系统发布成功，最后表现形式应与效果页相同如图17所示。

图17

该列表中只有一篇文章，该列表的效果页页面代码为，如图18所示，需要注意的有四处，从上至下分别为，所取文章图片的路径，文章标题，文章摘要，详细即为该文章的链接地址。

图18

修改以上代码成为模板所需代码，如图19所示

图19

如图19所示在标签中，src="#{site.domain}#{Attachment(id.image,path)}"为文章中所取的图片的路径。需要注意两点，一是在此列表中{list}中必须加入image="true"属性。一定要保留效果页中图片路径后的宽高设置。

#{Cut(id.title,6)}为文章标题。

#{Cut(id.textContent,38)} 标签为所截取的摘要文字，所截取摘要文字，也可以从文章中文章摘要summary中读取，需要在后台文章再要中录入文字。

href="#{id.path}" 为该文章的跳转地址

列表页内容页模板右侧导航的编写配置

编写模板后上传到服务器相应路径后并在内容管理系统发布成功，最后表现形式应与效果页相同如图20所示。

图20

该列表显示每条栏目名的效果页页面代码为，如图21所示，需要注意是文章链接地址和文章标题。

图21

修改以上代码成为模板所需代码，如图22所示

图22

如图22所示，在列表中domain所取的类型为column栏目，from所取值为“#”，其意为取所有平级栏目。此外在domain类型为column栏目时，from所取值也可以为“*”，其意为取该栏目下所有的子栏目。

href="#{id.url}" 为所取栏目的链接地址。#{https://www.360docs.net/doc/1411269184.html,}为所取栏目的栏目名称。

列表页模板主要位置编写配置

编写模板后上传到服务器相应路径后并在内容管理系统发布成功，最后表现形式应与效果页相同如图23所示。

图23

该页面的效果页的源代码为，如图24所示，从上至下所需要注意是当前位置的导航，栏目名称，列表内的文章标题，和时间，列表翻页。

修改以上代码成为模板所需代码，如图25所示

图25

如图25所示，

${Navigate(column.id,1)}为栏目导航标签。

#{https://www.360docs.net/doc/1411269184.html,}显示该列表页的栏目名称。

{list id="id" domain="article" from="*" num="15" page="true"}{/list}列表中from值取“*”，