网站开发手册.doc

网站群智能管理平台网站群智能管理平台 网站开发手册网站开发手册 20112011 年年 1212 月月 辽宁软旗科技有限公司辽宁软旗科技有限公司 第 2 页 共 23 页 网站群智能管理平台 网站开发手册 目 录 1 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 第 3 页 共 23 页 网站群智能管理平台 网站开发手册 1 1 引言引言 1 11 1 版本说明版本说明 版本版本作者作者维护日期维护日期内容描述内容描述 1 0吴刚2011 12 13创建文档 1 21 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 当前站点 第 4 页 共 23 页 网站群智能管理平台 网站开发手册 格式的文件parent 上级栏目 或 article 在内容页失效 文章文章articleid 编号 title 标题 subhead 副标题 writeDept 投稿部门 writer 作者 origin 原出处 path 文章路径 link 链接 summary 摘要 inputTime 录入时间 releaseTime 发布时间 invalidTime 失效时间 image 默认图片 id htmlContent html 内容 textContent 文本内容 inputer 录入人 栏目栏目columnid 编号 name 名称 displayName 显示名称 layer 层 image 图片 id article 备注 url 地址 首页 列表页 类型为链接的话同 link link 外链接 path 保存路径 indexPath 首页 listPath 列表页路径 url path indexPath path listPath 站点站点sitecode 编号 name 名称 domain 域名 admin name 管理员姓名 tel 电话 fax 传真 email address 地址 zip 邮编 department 主办单位 undertack 协办单位 powerBy 技术支持 文章列表文章列表 list id id domain article id 文章属性 no 本页中序号 第 5 页 共 23 页 网站群智能管理平台 网站开发手册 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 idid 编号 第 6 页 共 23 页 网站群智能管理平台 网站开发手册 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 FormatDat e 转换日期格转换日期格 式式 日期 格式 FormatDate article updateTime yyyy MM dd IfNull 为空输出指为空输出指 定数据定数据 属性 指定数据 IfNull article writer 无名氏 Java 运行运行 java 函函 数数 要计算的数据 参数二 类 方法 对数类 型 参数值 方法中多个参数 以 分隔 1 代表要计算的 数据 java lang 中的类 可省略包名 参数类型是全称 Java test2 no Math IEEEremainder double 1 double 2 Java site webDir com capinfo cms util FileUtils getString java lang Strin g 1 news include html java lang String utf 8 Navigate 栏目导航 栏目导航 栏目设为不栏目设为不 显示 则导显示 则导 航中不显示航中不显示 栏目 id 本栏目 是否显示链接 Navigate column id 1 演示站点 新闻中心 Navigate column id 0 演示站点 新闻中心 第 7 页 共 23 页 网站群智能管理平台 网站开发手册 Attachment 取附件信息取附件信息 附件 id 属性名 属性包括 filename 原始文 件名 path 附件路径 filesize 附件大 小 title 名称 info 说明 smallPath 缩略 图路径 IfNull Attachment test2 image path dsfdsf 1 jpg 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 添加部门 登陆内容管理后单击内容管理功能选项依次展开用户管理右键添加一个 部门如图 第 8 页 共 23 页 网站群智能管理平台 网站开发手册 2 添加用户 在新添加的部门上右键添加用户 权限暂不设置 3 添加站点 依次展开站点管理中站点管理 添加一个站点将刚刚新建的用户设为管 理员 点击 添加 按钮 其中站点编号为将来生成整个站点文件夹的名字 eg sydx 站点名称即为这个网站的名称 站点域名为当前站点的域名或者为 IP 加 站点编号 管理用户选取刚刚创建的用户 4 为用户授权 切回到用户管理为刚被设为管理员的账户授权 默认勾选所有权限 第 9 页 共 23 页 网站群智能管理平台 网站开发手册 5 2 新建栏目新建栏目 添加子栏目 根据栏目表添加相应的栏目 鼠标点击栏目在需要添加新栏目的栏目名字上点击鼠标右键选择添加子栏目 此时界面 显示如图 1 第 10 页 共 23 页 网站群智能管理平台 网站开发手册 图 1 点击添加子栏目之后界面显示 如图 2 图 2 在以上字段中添加 栏目名称 显示名称 存放目录 存放目录务必填写规范一般为相 对站点后的栏目名简拼加 是否显示栏目 如果不打 就是不显示栏目 将是否生产 rss 文件选项点空不选 其他选项不必填写 点击保存即可建立一个新的栏目在右侧目录显示 若修改内容管理后的台栏目名称 一定要把栏目名称和显示名称同时修改 也可以右键点击快速添加子栏目选项 快速创建多个平级的子栏目 需要注意填写正确 的栏目名与规范的栏目路径 如图 3 第 11 页 共 23 页 网站群智能管理平台 网站开发手册 图 3 新建的栏目右键点击编辑栏目显示栏目功能如图 4 图 4 常用栏目功能 基本属性 扩展字段 栏目权限 栏目模板 基本属性为 图 2 中显示的字段 栏目权限为 可以对此栏目进行赋权 主要针对用户对栏目的管理 如图 5 很重要 每次新建一个用户就要给用户分配栏目权限 只有获得更多权限才能对栏目 文章进行更多的操作 图 5 栏目模板 添加模板文件 针对于栏目所用的模板进行添加 修改 删除等操作 每一 个新建的栏目都必须添加相应的模板文件 如图 6 图 6 针对于模板文件 图片文件的替换 此处为重点 模板培训 发布类模板路径 opt app cms6 3 sydx template 编辑栏目时 点击栏目模板 配置模板文件 点击添加模板 新建栏目添加模板 如图 7 所示 第 12 页 共 23 页 网站群智能管理平台 网站开发手册 图 7 每个子栏目需要配置一个列表页模板与一个内容页模板 根据不同的栏目需要进行不同对应的配置 栏目配置列表页模板 如图 8 所示 在类型中选择列表模板 第二项模板中所要填写的路径为 以 opt app cms6 3 sydx template 为根目录下的需 要使用的模板文件名 第三项路径中所要填写的路径一般为固定写法 list html 指列表页生成的路径名称 图 8 栏目配置内容页模板 如图 9 所示 在类型中选择内容模板 第二项模板中所要填写的路径为 以 opt app cms6 3 sydx template 为根目录下的需要使 用的模板文件名 第三项路径中所要填写的路径一般为固定写法 content id html 指内容页生成的路径 名称 第 13 页 共 23 页 网站群智能管理平台 网站开发手册 图 9 如果在保存模板中出现错误或者在重发列表页的过程中出现错误信息则说明配置的对应 opt app cms6 3 sydx template 下的模板文件编写错误 成功添加列表模板与内容模板之后 右键单击右侧目录中对应的栏目名选择发布文章 如图 10 所示 图 10 出现发布文章选择框后 如图 11 选择重发列表页 即列表页创建成功 第 14 页 共 23 页 网站群智能管理平台 网站开发手册 图 11 然后选择针对于相应的栏目添加文章 之后在栏目上如图 11 点击发布新文章 如果更改模板之后需要把文章重新发布一遍 点击 重发已发文章 如图 11 5 3 模板及模板所需的相关的文件的上传模板及模板所需的相关的文件的上传 强调警告注意 每次在服务器上更换文件时需要做好严谨的文件备份工作 1 脚本的替换 根绝模板中标签中引入的 如脚本文件的路径和名称 在 opt app cms6 3 sydx script 下替换脚本文件 2 图片的替换 opt app cms6 3 sydx images 路径下有 images gjss 文件夹和 images 文件夹为网站图片 文件夹 gjss 文件夹 此文件里面的图片为静态页图片文件夹 images 文件夹 为网站图片文件夹 替换方法为 在原网站上查看图片属性 按照 图片路径替换图片即可 3 样式的替换 根绝模板中标签中引入的 如样式文件的路径和名称 在 opt app cms6 3 sydx css 下上传或替换需要更新的样式文件 4 Flash 的替换 服务器上路径 opt app cms6 3 sydx flash 在此路径上上传或更新所需 flash 文件 第 15 页 共 23 页 网站群智能管理平台 网站开发手册 5 4 模板的配置编写说明模板的配置编写说明 列表格式 list id id domain 类型 属性 值 list domain 类型表示是取数据的范围 一般只取文章 article 或则栏目 column 属性之间必须留空白 空白可以是空格 制表 换行 前不能有空白 必须以 list 开头 以 list 结束 例 list id id domain article from bc939d973045b3ea01304656677402a7 num 6 withSub true 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 第 16 页 共 23 页 网站群智能管理平台 网站开发手册 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 为鼠标指在链接 第 17 页 共 23 页 网站群智能管理平台 网站开发手册 上的提示名称 为该文章的全部标题名 在标签组中 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 所示 第 18 页 共 23 页 网站群智能管理平台 网站开发手册 图 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 所示 需要注意是文章链接地址 和文章标题 第 19 页 共 23 页 网站群智能管理平台 网站开发手册 图 21 修改以上代码成为模板所需代码 如图 22 所示 图 22 如图 22 所示 在列表中 domain 所取的类型为 column 栏目 from 所取值为 其意 为取所有平级栏目 此外在 domain 类型为 column 栏目时 from 所取值也可以为 其意 为取该栏目下所有的子栏目 href id url 为所取栏目的链接地址 id name 为所取栏目的栏目名称 列表页模板主要位置编写配置 编写模板后上传到服务器相应路径后并在内容管理系统发布成功 最后表现形式应与效 果页相同如图 23 所示 图 23 该页面的效果页的源代码为 如图 24 所示 从上至下所需要注意是当前位置的导航 栏目名称 列表内的文章标题 和时间 列表翻页 第 20 页 共 23 页 网站群智能管理平台 网站开发手册 图 24 修改以上代码成为模板所需代码 如图 25 所示 图 25 如图 25 所示 Navigate column id 1 为栏目导航标签 column name 显示该列表页的栏目名称 list id id domain article from num 15 page true list 列表中 from 值取 第 21 页 共 23 页 网站群智能管理平台 网站开发手册 为该栏目下的文章 若取该栏目下子栏目的文章需加入 withSub true 属性 Num 值为该列 表页中一页内所取的条数 page 属性如果需要显示翻页必须加入 将效果页中的翻页代码全部替换成 page 内容页模板主要位置编写配置 编写模板后上传到服务器相应路径后并在内容管理系统发布成功 最后表现形式应与效 果页相同如图 26 所示 图 26 该页面显示的效果图的源代码为 如图 27 所示 从上至下所需要注意是当前位置的导 航 栏目名称 该内容页的文章标题 文章发布人 发布时间 文章正文内容 第 22 页 共 23 页 网站群智能管理平台 网站开发手册 图 27 修改以上代码成为模板所需代码 如图 28 所示 图 28 如图 25 所示 Navigate column id 1 为栏目导航标签 column name 显示该列表页的栏目名称 需要强调注意的是 内容页中有关文章的标签均用 article 标