Z-Blog2.0模板文件与模板标签

Z-blog2.0版本对模板结构进行了优化，增加了若干新特性：

文件组成

首页与列表页相关模板

default.html 首页主模板文件
catalog.html 列表页模板文件¹⁾
b_article-multi.html 摘要文章模板
b_article-istop.html 置顶文章模板²⁾
b_pagebar.html 页面底部分页条模板，可以改分页条样式

2.0新增模板文件

page.html 独立页面模板，默认tags、search均用该模板
b_function.html 侧栏模块模板（更多...）
b_article-search-content.html 搜索结果内文模板
b_article_comment_pagebar.html 评论分页条模板

日志页相关模板

single.html 日志页主模板文件
b_article-single.html 日志页文章模板
b_article_mutuality.html 每条相关文章显示模板
b_article_comment.html 每条评论内容显示模板³⁾
b_article_commentpost.html 评论发送表单模板⁴⁾
b_article_commentpost-verify.html 评论验证码显示模板⁵⁾
b_article_tag.html 每个tag 的显示样式

其它可选模板文件

search.html 搜索页模板，显示搜索页面，为可选模板
tags.html 标签页模板，显示TagCloud，为可选模板

模板标签

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

1.系统常量

(c_option.asp)

标签	含义	备注
<#ZC_BLOG_VERSION#>	版本号	Z-Blog 2.0 Beta2 Build 121028
<#ZC_BLOG_LANGUAGE#>	博客页面语言	默认为zh-CN
<#ZC_BLOG_HOST#>	博客网址
<#ZC_BLOG_TITLE#>	博客标题	显示于浏览器标题栏
<#ZC_BLOG_SUBTITLE#>	博客简介
<#ZC_BLOG_COPYRIGHT#>	版权说明
<#ZC_BLOG_MASTER#>	博客站长名
<#ZC_CONTENT_MAX#>	留言最长字数
<#ZC_BLOG_CLSID#>	博客唯一标识号
<#ZC_TIME_ZONE#>	博客时区	默认为+0800 ,即北京时间
<#ZC_BLOG_THEME#>	主题名称

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

2.语言资源

(LANGUAGE/SimpChinese.asp)

<#ZC_MSGxxx#> 引用内容自：ZC_MSG001-ZC_MSG300

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

3.文章数据

文章基本数据：

相关模板文件：b_article-istop.html，b_article-multi.html，b_article-single.html，b_article-page.html（:!:2.0新增）

其中，b_article-istop.html无引用标签，而是根据是否存在置顶文章自动显示在首页。
b_article-multi.html引用标签为<#template:article-multi#>，可于default.html、catalog.html模板中引用。
b_article-single.html引用标签为<#template:article-single#>，可于single.html模板中引用。
b_article-page.html引用标签为<#template:article-page#>，可于page.html模板中引用。
还可参考Z-Blog 2.0模板新特性。

标签	含义	备注
<#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

文章Tag数据：

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

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

文章评论数据：

相关模板文件：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优先使用

2.0新增

标签	含义	备注
<#article/comment/parentid#>	父评论ID
<#article/comment/avatar#>	头像

文章发布时间：

以“2007年1月13日 15:31:13”时间为例说明。

标签	含义	备注
<#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

评论发布时间：

2.0版本新增

以“2007年1月13日 15:31:13”时间为例说明。

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

4.文章列表

列表页相关信息：

只能在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#>	下一页	<a href=NextUrl>« 更早的文章 </a>
<#template:pagebar_previous#>	上一页	<a href=PrevUrl>之后的文章 » </a>
<#articlelist/page/now#>	当前页码
<#articlelist/page/all#>	总页数

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

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

5.侧栏模块

相关模板文件：b_function.html （:!:2.0新增）

Z-Blog 1.8是通过在模板文件中引用文件缓存模块的方式呈现侧栏的，这种方式对于初学者来说编排有些复杂。

Z-Blog 2.0改进侧栏模块管理方式，将模块信息写入数据库，可在博客管理后台很方便的进行编辑或者排序。更多详情参考：Z-Blog 2.0主题侧栏使用说明

需要注意的是，Z-Blog 2.0保留1.8版本的引用文件缓存的方式，如需制作高自定化的主题仍可使用。

默认可用调用标签

标签	含义	备注
<#function/id#>	模块ID
<#function/htmlid#>	模块HTML ID
<#function/name#>	模块名
<#function/content#>	模块内容
<#function/filename#>	模块引用文件名	指文件缓存目录下保存模块内容的文件名

6.文件缓存

使用<#CACHE_INCLUDE_文件名（全大写且不要后缀）#>，可以引用系统目录⁶⁾INCLUDE文件夹下的文本文件内容
使用<#CACHE_INCLUDE_文件名_HTML#>，表示强制引用系统目录INCLUDE文件夹下的文件内容
使用<#CACHE_INCLUDE_文件名_JS#>，表示强制JS方式动态引用系统目录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#>	图标汇集

7.特殊的标签

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

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

¹⁾

指由catalog.asp展现的页面。

²⁾

置顶文章会自动显示于首页及列表页中，无须标签调用

³⁾

“私人文章”不显示评论及评论发送表单

⁴⁾

“关闭评论”不显示评论发送表单

⁵⁾

启用“验证码”功能选项才显示

⁶⁾

“系统目录”在1.8版中指根目录，在2.0版中指zb_system目录

⁷⁾

“主题目录”在1.8版中指THEMES目录，在2.0版中指zb_users/THEME目录

目录

Z-Blog2.0模板文件与模板标签

文件组成

首页与列表页相关模板

2.0新增模板文件

日志页相关模板

其它可选模板文件

模板标签

1.系统常量

2.语言资源

3.文章数据

文章基本数据：

文章分类数据：

文章作者数据：

文章块级标签：

文章Tag数据：

相关文章数据：

文章评论数据：

2.0新增

文章发布时间：

评论发布时间：

4.文章列表

列表页相关信息：

多页排列的分页条：

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

5.侧栏模块

默认可用调用标签

6.文件缓存

默认可用调用标签

7.特殊的标签