声明:本文章早前来源于网络,笔者进行编辑修改和完善部分内容!
一、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位数字代号
ZC_MSG001-ZC_MSGxxx
引用:<#ZC_MSGxxx#>
这里xxx就要引用的字符串资源的最后3位数字代号
3.文件缓存区
分别引用程序INCLUDE目录下的文件内容
分别引用程序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#> | |
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#> | |
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#>:由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引用
<#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#>
<#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#>
<#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" '上传附件的目录
<#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>
-->
<!--日历
<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"
日历的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隐藏
小RSS是被<span class="feed-icon">包围的,可以在CSS定义 span.feed-cion{display:none;}将它隐藏
网站目录右边的文章数目是用<span class="article-nums">包围的,也可用CSS隐藏
b3.关于“最近发表”块左边的日期的定义
“月/日”是被<span class="article-date">包围的
“月/日”是被<span class="article-date">包围的
b4.简洁翻页条的CSS定义
其中“更早的文章”和“之后的文章”分别由span标签的pagebar-previous和pagebar-next类定义,你可以用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>
<div class="post pagebar"><#ZC_MSG042#>:<#template:pagebar#></div>
b9. guestbook.asp会读取single.html做为页面的外框架模板,如果你要建立一个全新的留言板模板,可以修改guestbook.asp文件让其读取你指定的外框架模板即可。
b10. 在首页中引用“最近留言:
在首页模板default.html加入“<#CACHE_INCLUDE_GUESTCOMMENTS#>”即可。
在首页模板default.html加入“<#CACHE_INCLUDE_GUESTCOMMENTS#>”即可。