Keep on going, never give up.

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

本文章汇总Z-blog(V1.8)版本的全部模板文件和标签变量的注释说明,方便以后参考使用。本文部分来源于网络,部分参考Z-BLOG官方修正,天缘只是进行编辑整理和完善部分内容,非天缘原创

一、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/firsttagintro#>
<#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="<#ZC_BLOG_HOST#>script/flashview.js" type="text/javascript"></script>
</div>
-->
<!--TOP10Article
<div class="function">
<h3><#ZC_MSG265#></h3>
<ul>
<script language="JavaScript" src="<#ZC_BLOG_HOST#>script/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#>”即可。

相关评论(0):  

发表评论:

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

订阅博客

最新文章

本站采用创作共用版权协议, 要求署名、非商业用途和保持一致. 转载也必须遵循“署名-非商业用途-保持一致”的创作共用协议. 返回顶部
Copyright@2005-2016 Metsky.com, All rights Reserved.