====== 模板文件与模板标签 ======
Z-blog （themes|主题）下TEMPLATE 文件夹是专门放置模板文件的。推荐新人安装**主题修改助手插件：http://bbs.rainbowsoft.org/thread-20317-1-2.html
===== 文件组成 =====
==== 首页与列表页相关模板 ====
- default.html 首页主模板文件
- catalog.html 列表页模板文件(指由catalog.asp显示的页面。)
- b_article-multi.html 摘要文章模板
- b_article-istop.html 置顶文章模板(置顶文章会自动显示于首页及列表页中，无须标签调用)
- b_pagebar.html 页面底部分页条模板，可以改分页条样式
==== 日志页相关模板 ====
- single.html 日志页主模板文件
- b_article-single.html 日志页文章模板
- b_article_nvabar_l.html 日志页面文章导航，显示“上一篇”日志链接(文章导航功能启用时才可以调用)
- b_article_nvabar_r.html 日志页面文章导航，显示“下一篇”日志链接
- b_article_trackback.html 每条引用通告显示模板
- b_article_mutuality.html 每条相关文章显示模板
- b_article_comment.html 每条评论内容显示模板(私人文章不显示评论及评论发表框)
- b_article_commentpost.html 评论发表框模板(锁定文章不显示评论发表框)
- b_article_commentpost-verify.html 评论验证码显示模板(打开验证码选项才显示)
- b_article_tag.html 每个tag 的显示样式
==== 留言本相关模板 ====
留言本所用模板为可选项，如不存在则会使用**日志页**模板。
- b_article-guestbook.html 留言页正文模板，若不存在则调用 b_article-single.html 模板
- guestbook.html 留言页主模板文件（默认模板无此文件），若不存在则调用 single.html 模板
==== 其它模板文件 ====
- search.html 搜索页模板，显示搜索页面
- 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_MSGxxx
这里xxx是指引用的字符串资源的最后3位数字。
==== 3.文件缓存 ====
使用<#CACHE_INCLUDE_文件名（全大写且不要后缀）#>，可以引用根目录INCLUDE文件夹下的asp后缀的文件
使用<#TEMPLATE_INCLUDE_文件名（全大写且不要后缀）#>，可以引用主题目录INCLUDE文件夹下的asp后缀的文件
=== 默认可用调用标签 ===
|<#CACHE_INCLUDE_CATALOG#> |分类目录|
|<#CACHE_INCLUDE_AUTHORS#> |用户目录|
|<#CACHE_INCLUDE_TAGS#> |Tags|
|<#CACHE_INCLUDE_STATISTICS#> |站点统计|
|<#CACHE_INCLUDE_PREVIOUS#> |最近发表|
|<#CACHE_INCLUDE_NAVBAR#> |导 航 条|
|<#CACHE_INCLUDE_MISC#> |图标汇集|
|<#CACHE_INCLUDE_LINK#> |友情链接|
|<#CACHE_INCLUDE_FAVORITE#> |网站收藏|
|<#CACHE_INCLUDE_COMMENTS#> |最新评论|
|<#CACHE_INCLUDE_GUESTCOMMENTS#> |最近留言|
|<#CACHE_INCLUDE_TRACKBACKS#> |最近引用|
|<#CACHE_INCLUDE_CALENDAR#> |日 历|
|<#CACHE_INCLUDE_CALENDAR_NOW#> |历史日历|
|<#CACHE_INCLUDE_ARCHIVES#> |文章归档|
==== 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#> |首要联系 |网址优先|
=== 文章页“前后篇文章导航条”数据： ===
相关模板文件：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就是相关分类等的名称，等等
以上标签列表为有限集合，超出以上列表系统将不会替换。
本文来源 http://wiki.rainbowsoft.org/doku.php?do=show&id=themes%3Atemplate
音乐吧 相册 搜搜猎奇 站长日记 万年历 评论本文 给我留言
