Z-BLOG V1.8 模块文件及标签变量说明

声明：本文章早前来源于网络，笔者进行编辑修改和完善部分内容！
一、Z-blog模板说明（目录名：TEMPLATE）

编号	文件名	用途说明
1	default.html	首页展示模板。 引用b_article-istop.html显示置顶文章； 引用b_article-multi.html显示日志摘要； 引用b_pagebar.html显示分页条；
2	single.html	日志页显示模板。 引用b_article-single.html显示日志
3	catalog.html	分类目录页展示模板
4	search.html	搜索页模板
5	tags.html	标签页模板，展示TagCloud
6	b_article-guestbook.html	用户留言页模板
7	b_pagebar.html	页脚模板，可改为分页条样式
8	b_article-multi.html	首页摘要文章模板
9	b_article-single.html	日志页文章模板。 分别引用 b_article_trackback.html、b_article_mutuality.html、b_article_comment.html、b_article_commentpost.html 显示日志后的引用列表，相关文章，评论内容，评论发表框。
10	b_article-istop.html	置顶文章模板
11	b_article_nvabar_l.html	日志页面文章导航，显示“上一篇”日志链接
12	b_article_nvabar_r.html	日志页面文章导航，显示“下一篇”日志链接
13	b_article_tag.html	每个tag 的显示样式
14	b_article_trackback.html	引用通告显示模板
15	b_article_mutuality.html	相关文章显示模板
16	b_article_comment.html	评论内容显示模板
17	b_article_commentpost.html	评论发表框模板
18	b_article_commentpost-verify.html	评论验证码显示样式

二、Z-blog标签说明
1.系统常量区(c_custom.asp,c_option.asp)

编号	标签	说明
1	<#ZC_BLOG_VERSION#>	当前博客系统的版本号
2	<#ZC_BLOG_LANGUAGE#>	博客页面语言 (默认为zh-CN)
3	<#ZC_BLOG_HOST#>	博客网址
4	<#ZC_BLOG_TITLE#>	博客标题(用于显示于浏览器标题栏)
5	<#ZC_BLOG_SUBTITLE#>	博客简介
6	<#ZC_BLOG_NAME#>	博客名称 (显示于页面中)
7	<#ZC_BLOG_SUB_NAME#>	博客副标题
8	<#ZC_BLOG_CSS#>	CSS界面样式名称
9	<#ZC_BLOG_COPYRIGHT#>	版权说明
10	<#ZC_BLOG_MASTER#>	博客主人名
11	<#ZC_CONTENT_MAX#>	留言最长字数
12	<#ZC_EMOTICONS_FILENAME#>	表情字符串
13	<#ZC_EMOTICONS_FILESIZE#>	表情图片大小
14	<#ZC_GUESTBOOK_CONTENT#>	留言本正文内容
15	<#ZC_BLOG_CLSID#>	博客唯一标识号 (更改该标识可能对防机器spam有效)
16	<#ZC_TIME_ZONE#>	博客时区 (默认为+0800 ,即北京时间)
17	<#ZC_IMAGE_WIDTH#>	图片自动缩小尺寸，分别引用 c_custom.asp及c_option.asp 中相应数据，如<#ZC_BLOG_VERSION#> 引用：ZC_BLOG_VERSION (c_option.asp),可于后台网站设置中更改其内容.

2.语言资源区(LANGUAGE/SimpChinese.asp)
ZC_MSG001-ZC_MSGxxx
引用：<#ZC_MSGxxx#>
这里xxx就要引用的字符串资源的最后3位数字代号

3.文件缓存区
分别引用程序INCLUDE目录下的文件内容

编号	标签	说明
1	<#CACHE_INCLUDE_CATALOG#>	分类目录:
2	<#CACHE_INCLUDE_AUTHORS#>	用户目录:
3	<#CACHE_INCLUDE_TAGS#>	tags
4	<#CACHE_INCLUDE_STATISTICS#>	站点统计:
5	<#CACHE_INCLUDE_PREVIOUS#>	最近发表:
6	<#CACHE_INCLUDE_NAVBAR#>	导 航 条:
7	<#CACHE_INCLUDE_MISC#>	图标汇集:
8	<#CACHE_INCLUDE_LINK#>	友情链接:
9	<#CACHE_INCLUDE_FAVORITE#>	网站收藏:
10	<#CACHE_INCLUDE_COMMENTS#>	最新评论:
11	<#CACHE_INCLUDE_GUESTCOMMENTS#>	最近留言:
12	<#CACHE_INCLUDE_TRACKBACKS#>	最近引用:
13	<#CACHE_INCLUDE_CALENDAR#>	日      历:
14	<#CACHE_INCLUDE_ARCHIVES#>	文章归档:
15	补充：V1.7中可以引用INCLUDE下的任意文件，使用<#CACHE_INCLUDE_文件名（全大写且不要后缀）#>

4.文章区
文章基本数据：

编号	标签	说明
1	<#article/id#>	编号
2	<#article/url#>	链接
3	<#article/level#>	权限
4	<#article/title#>	标题
5	<#article/intro#>	摘要
6	<#article/content#>	内容
7	<#article/posttime#>	时间
8	<#article/commnums#>	评论数
9	<#article/viewnums#>	浏览数
10	<#article/trackbacknums#>	引用数
11	<#article/trackback_url#>	引用链接
12	<#article/commentrss#>  <#article/commentposturl#>               <#article/pretrackback_url#>               <#article/trackbackkey#>  <#article/commentkey#>	评论RSS
13	<#article/staticname#>	别名
14	<#article/tagtoname#>  <#article/firsttagname#>  <#article/firsttagid#>	tags(非链接)

文章分类数据：

编号	标签	说明
1	<#article/category/id#>	编号
2	<#article/category/name#>	名称
3	<#article/category/order#>	序号
4	<#article/category/count#>	文章数
5	<#article/category/url#>	链接
6	<#article/category/staticname#>	别名

文章作者数据：

编号	标签	说明
1	<#article/author/id#>	编号
2	<#article/author/name#>	名称
3	<#article/author/level#>	权限
4	<#article/author/email#>	Email
5	<#article/author/homepage#>	主页
6	<#article/author/count#>	文章数
7	<#article/author/url#>	链接
8	<#article/author/staticname#>	别名

文章Tag数据(b_article_tag.html)：

编号	标签	说明
1	<#article/tag/id#>	编号
2	<#article/tag/name#>	名称
3	<#article/tag/intro#>	摘要
4	<#article/tag/count#>	文章数
5	<#article/tag/url#>	链接
6	<#article/tag/encodename#>	Encode

文章评论数据(b_article_comment.html)：

编号	标签	说明
1	<#article/comment/id#>	编号
2	<#article/comment/name#>	名称
3	<#article/comment/url#> <#article/comment/urlencoder#>	网址（下面的是干扰处理过的URL，防spam）
4	<#article/comment/email#>	Email
5	<#article/comment/posttime#>	时间
6	<#article/comment/content#>	内容
7	<#article/comment/count#>	序号
8	<#article/comment/authorid#>	作者编号
9	<#article/comment/firstcontact#>	第一联系(网址优先)
10	<#article/comment/emailmd5#>	Email的MD5

引用文章数据(b_article_trackback.html)：

编号	标签	说明
1	<#article/trackback/id#>	编号
2	<#article/trackback/name#>	名称
3	<#article/trackback/url#>	网址
4	<#article/trackback/tile#>	标题
5	<#article/trackback/posttime#>	时间
6	<#article/trackback/content#>	内容
7	<#article/trackback/count#>	序号

相关文章数据(b_article_mutuality.html)：

编号	标签	说明
1	<#article/mutuality/id#>	编号
2	<#article/mutuality/url#>	网址
3	<#article/mutuality/posttime#>	时间
4	<#article/mutuality/name#>	名称

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

编号	标签	说明
1	<#article/nav_l/url#>
2	<#article/nav_l/name#>
3	<#article/nav_r/url#>
4	<#article/nav_r/name#>

文章生成时间：

编号	标签	样式说明
1	<#article/posttime/longdate#>	2007年1月13日
2	<#article/posttime/shortdate#>	2007-1-13
3	<#article/posttime/longtime#>	15:31:13
4	<#article/posttime/shorttime#>	15:31
5	<#article/posttime/year#>	2007
6	<#article/posttime/month#>	1
7	<#article/posttime/monthname#>	Jan  //LANGUAGE文件中对应 ZVA_Month_Abbr（12）
8	<#article/posttime/day#>	13
9	<#article/posttime/weekday#>	7
10	<#article/posttime/weekdayname#>	Sat  //LANGUAGE文件中对应 ZVA_Week_Abbr（7）
11	<#article/posttime/hour#>	15
12	<#article/posttime/minute#>	31
13	<#article/posttime/second#>	13

5.文章列表区
多页排列的分页条：
<#template:pagebar#>:由default.html和catalog.html引用
<#pagebar/page/url#>:在b_pagebar.html中定义和修改
<#pagebar/page/number#>:在b_pagebar.html中定义和修改

只有“前一页”和“后一页”的分页条：
<#template:pagebar_next#>:由default.html和catalog.html引用
<#template:pagebar_previous#>:由default.html和catalog.html引用

只由catalog.html使用的标签：
<#articlelist/author/id#>
<#articlelist/tags/id#>
<#articlelist/category/id#>
<#articlelist/date/year#>
<#articlelist/date/month#>
<#articlelist/date/day#>
<#articlelist/date/shortdate#>

由default.html和catalog.html使用的标签：
<#articlelist/page/now#>
<#articlelist/page/all#>

6.特殊的标签
<#BLOG_CREATE_TIME#>:文件生成时的当前时间(格式为2009-05-27 22:36:10)，可以放在default.html,single.html等页
<#BlogTitle#>:当前页的标题， 如放在default.html就是Blog的子标题，放在single.html就是文章的标题，放在catalog.html就是相关分类等的名称，等等
其他类.
Const ZC_CONTENT_MAX=1000                         '留言最长字数
Const ZC_TB_EXCERPT_MAX=250                       '自动截取摘要的字数(当摘要为空时有效)
Const ZC_RECENT_COMMENT_WORD_MAX=16 '侧边栏中留言,评论,引用每条显示字数,超过则截前14(16-2)字+"..."
Const ZC_TEMPLATE_DIRECTORY="template"      '模板文件的目录,默认为TEMPLATE(不分大小写)
Const ZC_UPLOAD_DIRECTORY="upload"             '上传附件的目录
 

三、常用Z-blog示例代码及补充说明
<!--日历
<div class="function" id="divCalendar">
<h3><#ZC_MSG050#></h3>
<#CACHE_INCLUDE_CALENDAR#>
</div>
-->
<!--控制面板
<div class="function" id="divContorPanel">
<h3><#ZC_MSG025#></h3>
<ul>
<li><a href="cmd.asp?act=login">[<#ZC_MSG009#>]</a> <a href="cmd.asp?act=vrs">[<#ZC_MSG021#>]</a></li>
</ul>
</div>
-->
<!--网站目录
<div class="function" id="divCatalog">
<h3><#ZC_MSG026#></h3>
<ul>
<#CACHE_INCLUDE_CATALOG#>
</ul>
</div>
-->
<!--最新留言
<div class="function" id="divComments">
<h3><#ZC_MSG027#></h3>
<ul>
<#CACHE_INCLUDE_COMMENTS#>
</ul>
</div>
-->
<!--最近引用
<div class="function" id="divTrackbacks">
<h3><#ZC_MSG154#></h3>
<ul>
<#CACHE_INCLUDE_TRACKBACKS#>
</ul>
</div>
-->
<!--文章归档
<div class="function" id="divArchives">
<h3><#ZC_MSG028#></h3>
<ul>
<#CACHE_INCLUDE_ARCHIVES#>
</ul>
</div>
-->
<!--搜索
<div class="function" id="divSearchPanel">
<h3><#ZC_MSG085#></h3>
<ul>
<li>
<form method="post" action="<#ZC_BLOG_HOST#>cmd.asp?act=Search">
<input type="text" name="edtSearch" id="edtSearch" size="12" />
<input type="submit" value="<#ZC_MSG087#>" name="btnPost" id="btnPost" />
</form>
</li>
</ul>
</div>
-->
<!--站点统计
<div class="function" id="divStatistics">
<h3><#ZC_MSG029#></h3>
<ul>
<#CACHE_INCLUDE_STATISTICS#>
</ul>
</div>
-->
<!--网站收藏
<div class="function" id="divFavorites">
<h3><#ZC_MSG030#></h3>
<ul>
<#CACHE_INCLUDE_FAVORITE#>
</ul>
</div>
-->
<!--友情连接
<div class="function" id="divLinkage">
<h3><#ZC_MSG031#></h3>
<ul>
<#CACHE_INCLUDE_LINK#>
</ul>
</div>
-->
<!--图标汇集也是RSS什么的
<div class="function" id="divMisc">
<h3><#ZC_MSG039#></h3>
<ul>
<#CACHE_INCLUDE_MISC#>
</ul>
</div>
-->
<!--最近发表
<div class="function" id="divPrevious">
<h3><#ZC_MSG032#></h3>
<ul id="ulPrevious">
<script language="JavaScript" type="text/javascript">strBatchInculde+="ulPrevious=previous,"</script>
</ul>
</div>
-->
<!--TAGs
<div class="function" id="divTags">
<h3><#ZC_MSG138#></h3>
<ul>
<#CACHE_INCLUDE_TAGS#>
</ul>
</div>
-->
<!--自定义的标签-->
<!--AD
<div class="function" id="divZAD">
<script language="JavaScript" src=\'#\'" /flashview.js" type="text/javascript"></script>
</div>
-->
<!--TOP10Article
<div class="function">
<h3><#ZC_MSG265#></h3>
<ul>
<script language="JavaScript" src=\'#\'" /TopArticle.js" type="text/javascript"></script>
</ul>
</div>
-->

b1.日历的CSS定义说明
日历的CSS定义是系统设置的，不随模板变化而变化。日历整体是被两个div标签嵌套，每个日期和星期都是由p标签组成。
其中：
年和月的标签是p class="y"
星期的标签是p class="w"
日期的标签是p class="d"
有文章的日期标签是 p class="yd"
填充日历空白部分的标签是 p class="nd"
是当前日的会在class中加入"cd"

b2.关于“网站目录”块左边的RSS图标的定义
小RSS是被<span class="feed-icon">包围的，可以在CSS定义 span.feed-cion{display:none;}将它隐藏
网站目录右边的文章数目是用<span class="article-nums">包围的，也可用CSS隐藏

b3.关于“最近发表”块左边的日期的定义
“月/日”是被<span class="article-date">包围的

b4.简洁翻页条的CSS定义
其中“更早的文章”和“之后的文章”分别由span标签的pagebar-previous和pagebar-next类定义，你可以用CSS方式隐藏文字，用图片代替。

b5.如何得到中文的星期标签呢？将 LANGUAGE\SimpChinese.asp 中 ZVA_Week_Abbr(1...7) 值对应改成中文（一至七），以" 星期<#article/posttime/weekdayname#> "格式调用即可。

b6. b_article-guestbook.html是1.7新增的模板,用于显示留言.如果你用的主题没有b_article-guestbook.html文件的话,系统会自动采用b_article-single.html的.

b7. b_article-guestbook.html中使用<#article/content#>和使用<#article/intro#>效果不同，<#article/content#>带有留言板的正文和分页条而<#article/intro#>只有留言板的正文.

b8. 如何加入新的留言分页条呢?对于默认的模板,加入如下代码即可,其它模板适当修改。
<div class="post pagebar"><#ZC_MSG042#>:<#template:pagebar#></div>

b9. guestbook.asp会读取single.html做为页面的外框架模板,如果你要建立一个全新的留言板模板,可以修改guestbook.asp文件让其读取你指定的外框架模板即可。

b10. 在首页中引用“最近留言：
在首页模板default.html加入“<#CACHE_INCLUDE_GUESTCOMMENTS#>”即可。