模板文件与模板标签

2012-5-2 16:35:35 | tags | views

模板文件与模板标签

 

 

文件组成

首页与列表页相关模板

  1. default.html 首页主模板文件
  2. catalog.html 列表页模板文件1)
  3. b_article-multi.html 摘要文章模板
  4. b_article-istop.html 置顶文章模板2)
  5. b_pagebar.html 页面底部分页条模板,可以改分页条样式

日志页相关模板

  1. single.html 日志页主模板文件
  2. b_article-single.html 日志页文章模板
  3. b_article_nvabar_l.html 日志页面文章导航,显示“上一篇”日志链接3)
  4. b_article_nvabar_r.html 日志页面文章导航,显示“下一篇”日志链接
  5. b_article_trackback.html 每条引用通告显示模板
  6. b_article_mutuality.html 每条相关文章显示模板
  7. b_article_comment.html 每条评论内容显示模板4)
  8. b_article_commentpost.html 评论发送表单模板5)
  9. b_article_commentpost-verify.html 评论验证码显示模板6)
  10. b_article_tag.html 每个tag 的显示样式

留言本相关模板

留言本所用模板为可选项,如不存在则会使用日志页模板。

  1. b_article-guestbook.html 留言页正文模板,若不存在则调用 b_article-single.html 模板
  2. guestbook.html 留言页主模板文件(默认主题无此文件),若不存在则调用 single.html 模板

其它模板文件

  1. search.html 搜索页模板,显示搜索页面
  2. tags.html 标签页模板,显示TagCloud

模板标签

Z-Blog模版标签库及相关说明

1.系统常量

(c_option.asp)

标签 含义 备注
<#ZC_BLOG_VERSION#> 版本号  
<#ZC_BLOG_LANGUAGE#> 博客页面语言 默认为zh-CN
<#ZC_BLOG_HOST#> 博客网址  
<#ZC_BLOG_TITLE#> 博客标题 显示于浏览器标题栏
<#ZC_BLOG_SUBTITLE#> 博客简介  
<#ZC_BLOG_NAME#> 博客名称 显示于页面中
<#ZC_BLOG_SUB_NAME#> 博客副标题  
<#ZC_BLOG_COPYRIGHT#> 版权说明  
<#ZC_BLOG_MASTER#> 博客主人名  
<#ZC_CONTENT_MAX#> 留言最长字数  
<#ZC_EMOTICONS_FILENAME#> 表情字符串  
<#ZC_EMOTICONS_FILESIZE#> 表情图片-高、宽  
<#ZC_GUESTBOOK_CONTENT#> 留言本正文内容  
<#ZC_BLOG_CLSID#> 博客唯一标识号 不定期更改该标识对防spam机器人有效
<#ZC_TIME_ZONE#> 博客时区 默认为+0800 ,即北京时间
<#ZC_IMAGE_WIDTH#> 图片自动缩小尺寸  
<#ZC_BLOG_THEME#> 主题名称  
<#ZC_VERIFYCODE_WIDTH#> 验证码图片-宽  
<#ZC_VERIFYCODE_HEIGHT#> 验证码图片-高  

以上标签所表示的参数大多可在后台的网站设置中进行修改。

2.语言资源

(LANGUAGE/SimpChinese.asp)

<#ZC_MSGxxx#> 引用内容自:ZC_MSG001-ZC_MSG230

这里xxx是指引用的字符串资源的最后3位数字。

3.文件缓存

  • 使用<#CACHE_INCLUDE_文件名(全大写且不要后缀)#>,可以引用根目录INCLUDE文件夹下的文本文件内容
  • 使用<#TEMPLATE_INCLUDE_文件名(全大写且不要后缀)#>,可以引用主题目录INCLUDE文件夹下的文本文件内容

更多引用方式请看如何在模板中引用include目录内文件

默认可用调用标签

标签 含义 备注
<#CACHE_INCLUDE_CATALOG#> 分类目录  
<#CACHE_INCLUDE_AUTHORS#> 用户列表  
<#CACHE_INCLUDE_TAGS#> Tags 从使用数多到少排列,最多显示50个
<#CACHE_INCLUDE_STATISTICS#> 站点统计  
<#CACHE_INCLUDE_PREVIOUS#> 最近发表  
<#CACHE_INCLUDE_COMMENTS#> 最新评论  
<#CACHE_INCLUDE_GUESTCOMMENTS#> 最近留言 指留言本中的最新留言
<#CACHE_INCLUDE_TRACKBACKS#> 最近引用  
<#CACHE_INCLUDE_CALENDAR#> 日 历  
<#CACHE_INCLUDE_CALENDAR_NOW#> 当前日历 catalog.html中引用这个日历标签才能显示当前日期
<#CACHE_INCLUDE_ARCHIVES#> 文章归档  
以上标签所引用文件内容均为系统自动生成,不要手动修改;以下标签所引用内容可在后台链接管理中修改
<#CACHE_INCLUDE_NAVBAR#> 导 航 条  
<#CACHE_INCLUDE_LINK#> 友情链接  
<#CACHE_INCLUDE_FAVORITE#> 网站收藏  
<#CACHE_INCLUDE_MISC#> 图标汇集  
  • 使用<#CACHE_INCLUDE_文件名(全大写且不要后缀)_HTML#>,表示强制引用根目录INCLUDE文件夹下的文件内容
  • 使用<#CACHE_INCLUDE_文件名(全大写且不要后缀)_JS#>,表示强制javascript引用根目录INCLUDE文件夹下的文件

4.文章数据

 

文章基本数据:

相关模板文件:b_article-istop.html,b_article-multi.html,b_article-single.html

标签 含义 备注
<#article/id#> 编号  
<#article/url#> 链接  
<#article/level#> 权限  
<#article/title#> 标题  
<#article/staticname#> 别名  
<#article/intro#> 摘要  
<#article/content#> 全文  
<#article/posttime#> 时间 更多时间格式请看文章生成时间
<#article/commnums#> 评论数  
<#article/viewnums#> 浏览数 推荐使用JS显示浏览数 详细...
<#article/trackbacknums#> 引用数  
<#article/trackback_url#> 引用链接 点击之后通过验证才能取得完整链接
<#article/pretrackback_url#>    
<#article/trackbackkey#>    
<#article/commentposturl#>    
<#article/commentkey#>    
<#article/commentrss#> 评论RSS  
<#article/tagtoname#> tags 文本形式,可用于<head>区内作为关键词
<#article/firsttagintro#> 第一个tag摘要 将摘要设置图片链接,可做自动图文混排

文章分类数据:

标签 含义
<#article/category/id#> 编号
<#article/category/order#> 序号
<#article/category/name#> 名称
<#article/category/staticname#> 别名
<#article/category/url#> 链接
<#article/category/count#> 该分类下文章数

文章作者数据:

标签 含义
<#article/author/id#> 编号
<#article/author/name#> 名称
<#article/author/staticname#> 别名
<#article/author/level#> 等级
<#article/author/email#> Email
<#article/author/homepage#> 网站链接
<#article/author/count#> 文章数
<#article/author/url#> 链接

文章块级标签:

有些文章相关数据模块也有自己的模板,我们且称其为“块级标签”

标签 含义 备注
<#template:article_tag#> tags 链接形式,其定制模板为 b_article_tag.html
<#template:article_mutuality#> 相关文章 b_article_mutuality.html
<#template:article_trackback#> 引用列表 article_trackback.html
<#template:article_comment#> 文章评论 article_comment.html
<#template:article_commentpost#> 评论发送表单 article_commentpost.html
<#template:article_navbar_l#> 上一篇文章 article_navbar_l.html
<#template:article_navbar_r#> 下一篇文章 article_navbar_r.html

文章Tag数据:

相关模板文件:b_article_tag.html

标签 含义
<#article/tag/id#> 编号
<#article/tag/name#> 名称
<#article/tag/intro#> 摘要
<#article/tag/count#> 文章数
<#article/tag/url#> 链接
<#article/tag/encodename#>  

相关文章数据:

相关模板文件:b_article_mutuality.html

标签 含义
<#article/mutuality/id#> 编号
<#article/mutuality/url#> 链接
<#article/mutuality/posttime#> 时间
<#article/mutuality/name#> 文章名

文章引用数据:

相关模板文件:b_article_trackback.html

标签 含义
<#article/trackback/id#> 编号
<#article/trackback/count#> 序号
<#article/trackback/name#> 名称
<#article/trackback/url#> 网址
<#article/trackback/tile#> 标题
<#article/trackback/posttime#> 时间
<#article/trackback/content#> 内容

文章评论数据:

相关模板文件:b_article_comment.html

标签 含义 备注
<#article/comment/id#> 编号  
<#article/comment/count#> 序号  
<#article/comment/name#> 名称 评论者名称,下同
<#article/comment/url#> 网址  
<#article/comment/email#> Email  
<#article/comment/posttime#> 时间  
<#article/comment/content#> 内容  
<#article/comment/authorid#> 作者编号  
<#article/comment/firstcontact#> 首要联系 网址优先
<#article/comment/emailmd5#> Email的MD5码 应用参考
<#article/comment/urlencoder#> 经过加扰的URL链接 防SPAM优先使用

文章页“前后篇文章导航条”数据:

相关模板文件:b_article_nvabar_l.html,b_article_nvabar_r.html

标签 含义
<#article/nav_l/url#> 上一篇文章链接
<#article/nav_l/name#> 上一篇文章标题
<#article/nav_r/url#> 下一篇文章链接
<#article/nav_r/name#> 下一篇文章标题

文章生成时间:

标签 含义 备注
<#article/posttime/longdate#> 2007年1月13日  
<#article/posttime/shortdate#> 2007-1-13  
<#article/posttime/longtime#> 15:31:13  
<#article/posttime/shorttime#> 15:31  
<#article/posttime/year#> 2007  
<#article/posttime/month#> 1  
<#article/posttime/monthname#> January LANGUAGE文件中对应 ZVA_Month(1~12)全称
<#article/posttime/monthnameabbr#> Jan LANGUAGE文件中对应 ZVA_Month_Abbr(1~12)
<#article/posttime/day#> 13  
<#article/posttime/weekday#> 7  
<#article/posttime/weekdayname#> Saturday LANGUAGE文件中对应 ZVA_Week(1~7)全称
<#article/posttime/weekdaynameabbr#> sat LANGUAGE文件中对应 ZVA_Week_Abbr(1~7)
<#article/posttime/hour#> 15  
<#article/posttime/minute#> 31  
<#article/posttime/second#> 13  

5.文章列表

 

列表页相关信息:

只能在catalog.html及其相关模板中引用

标签 含义
<#articlelist/author/id#> 作者编号
<#articlelist/tags/id#> 标签编号
<#articlelist/category/id#> 分类编号
<#articlelist/date/year#> (年)2007
<#articlelist/date/month#> (月)1
<#articlelist/date/day#> (日)4
<#articlelist/date/shortdate#> 2007-1-4

以上标签只在与其相关的列表页面显示,如“catalog.asp?date=2007-1-4”页面只会显示<#articlelist/date/shortdate#>标签,其它为空。

多页排列的分页条:

只能在default.html和catalog.html中引用

标签 含义 备注
<#template:pagebar#> 分页条 完整的分页条,后台设置显示条数
<#template:pagebar_next#> 下一页 <span class=“pagebar-next”><a href=NextUrl><span>« 更早的文章
</span></a></span>
<#template:pagebar_previous#> 上一页 <span class=“pagebar-previous”><a href=PrevUrl><span>之后的文章 »
</span></a></span>
<#articlelist/page/now#> 当前页码  
<#articlelist/page/all#> 总分页数  

分页条样式在b_pagebar.html定制:

标签 含义
<#pagebar/page/url#> 分页链接
<#pagebar/page/number#> 分页码

6.特殊的标签

<#CUSTOM_TAGS#>:只能用在tags.html,显示博客内的所有tags。

<#BLOG_CREATE_TIME#>:页面文件生成的时间,可以放在default.html,single.html等页

<#BlogTitle#>:当前页的标题, 如果在default.html就是BLOG的子标题,在single.html就是文章的标题,在catalog.html就是相关分类等的名称,等等

以上标签列表为有限集合,超出以上列表系统将不会替换。

1) 指由catalog.asp显示的页面。
2) 置顶文章会自动显示于首页及列表页中,无须标签调用
3) 文章导航功能启用时才可以调用
4) 私人文章不显示评论及评论发送表单
5) 锁定文章不显示评论发送表单
6) 打开验证码选项才显示
    相关文章:

发表评论:

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。