====== 模板文件与模板标签 ======
Z-blog [[zblogasp:theme|主题]]下 **TEMPLATE** 文件夹是专门放置模板文件的。1.8版本推荐新手安装**[[http://bbs.rainbowsoft.org/thread-20317-1-2.html|主题修改助手]]**插件。（:!:**2.0以上版本中的文件管理插件已附带该功能**）
* 相关参考：
- [[model|默认模板页面结构分析]]
- [[sidebarhtml|默认模板侧栏代码整理和注释]]
- [[tips|主题制作技巧]]
* **Z-blog2**.x 版本对模板结构进行了优化，增加了若干新特性：
* [[..:zblog20:sidebar2.0]]
* [[..:zblog20:newfeatureof2.0]]
===== 文件组成 =====
:!: [[模板文件图解参考]]
:!: [[默认模板各文件内容说明]]
==== 首页与列表页相关模板 ====
- default.html 首页主模板文件
- catalog.html 列表页模板文件((指由catalog.asp展现的页面。))
- b_article-multi.html 摘要文章模板
- b_article-istop.html 置顶文章模板((置顶文章会自动显示于首页及列表页中，无须标签调用))
- b_pagebar.html 页面底部分页条模板，可以改分页条样式
==== 2.0新增模板文件 ====
- page.html 独立页面模板，默认tags、search均用该模板
- b_function.html 侧栏模块模板（[[..:zblog20:sidebar2.0|更多...]]）
- b_article-search-content.html 搜索结果内文模板
- b_article_comment_pagebar.html 评论分页条模板
==== 日志页相关模板 ====
- single.html 日志页主模板文件
- b_article-single.html 日志页文章模板
- b_article_navbar_l.html 日志页面文章导航，显示“上一篇”日志链接((文章导航功能启用时才可以调用)) // （Z-Blog 2.0默认删除，改为可选模板）//
- b_article_navbar_r.html 日志页面文章导航，显示“下一篇”日志链接 // （Z-Blog 2.0默认删除，改为可选模板）//
- 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 的显示样式
==== 留言本相关模板 ====
留言本所用模板为可选项，如不存在则会使用**日志页**模板。// （Z-Blog 2.0已删除该项，改为以页面实现）//
- b_article-guestbook.html 留言页正文模板，若不存在则调用 b_article-single.html 模板
- guestbook.html 留言页主模板文件（默认主题无此文件），若不存在则调用 single.html 模板
==== 其它模板文件 ====
- search.html 搜索页模板，显示搜索页面 // （Z-Blog 2.0默认删除，改为可选模板）//
- tags.html 标签页模板，显示TagCloud // （Z-Blog 2.0默认删除，改为可选模板）//
===== 模板标签 =====
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#> |博客名称 |显示于页面中，2.0改与<#ZC_BLOG_TITLE#>合并 |
| <#ZC_BLOG_SUB_NAME#> |博客副标题 |2.0改与<#ZC_BLOG_SUBTITLE#>合并 |
| <#ZC_BLOG_COPYRIGHT#> |版权说明 | |
| <#ZC_BLOG_MASTER#> |博客站长名 | |
| <#ZC_CONTENT_MAX#> |留言最长字数 | |
| <#ZC_EMOTICONS_FILENAME#> |表情字符串 | //（2.0中已弃用）// |
| <#ZC_EMOTICONS_FILESIZE#> |表情图片－高、宽 | //（2.0中已弃用）// |
| <#ZC_GUESTBOOK_CONTENT#> |留言本正文内容 | //（2.0中已弃用）// |
| <#ZC_BLOG_CLSID#> |博客唯一标识号 |不定期更改该标识对防spam机器人有效 |
| <#ZC_TIME_ZONE#> |博客时区 |默认为+0800 ,即北京时间 |
| <#ZC_IMAGE_WIDTH#> |图片自动缩小尺寸 | //2.0中已弃用// |
| <#ZC_BLOG_THEME#> |主题名称 | |
| <#ZC_VERIFYCODE_WIDTH#> |验证码图片－宽 | //（2.0中已弃用）// |
| <#ZC_VERIFYCODE_HEIGHT#> |验证码图片－高 | //（2.0中已弃用）// |
以上标签所表示的参数大多可在后台的网站设置中进行修改。
==== 2.语言资源====
语言文件位于LANGUAGE目录（1.8版本）或 ZB_USER/LANGUAGE（2.X版本），引用标签如下：
''<#ZC_MSGxxx#>'' 引用内容为文件中的参数对应字符串：''ZC_MSG001''-''ZC_MSG230'' （:!: 2.0中扩展到''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，还可参考[[..:zblog20:newfeatureof2.0]]。
^ 标签 ^ 含义 ^ 备注 ^
|<#article/id#> |编号 | |
|<#article/url#> |链接 | |
|<#article/level#> |权限 | |
|<#article/title#> |标题 | |
|<#article/staticname#> |别名 | |
|<#article/intro#> |摘要 | |
|<#article/content#> |全文 | |
|<#article/posttime#> |时间 |更多时间格式请看[[#文章发布时间]]|
|<#article/commnums#> |评论数 | |
|<#article/viewnums#> |浏览数 |推荐使用JS显示浏览数 [[tips#如何刷新和显示浏览计数|详细...]]|
|<#article/trackbacknums#> |引用数 | |
|<#article/trackback_url#> |引用链接 |点击之后通过验证才能取得完整链接|
|<#article/pretrackback_url#> | | |
|<#article/trackbackkey#> | | |
|<#article/commentposturl#> | | |
|<#article/commentkey#> | | |
|<#article/commentrss#> |评论RSS | |
|<#article/tagtoname#> |tags |文本形式，可用于区内作为关键词|
|<#article/firsttagintro#> |第一个tag摘要 |将摘要设置图片链接，可做自动图文混排|
=== 文章分类数据： ===
^ 标签 ^ 含义 ^
|<#article/category/id#> |编号|
|<#article/category/name#> |名称|
|<#article/category/order#> |序号|
|<#article/category/count#> |该分类下文章数|
|<#article/category/url#> |链接|
|<#article/category/staticname#> |别名|
== 2.2新增 ==
^ 标签 ^ 含义 ^
|<#article/category/parent/id#> |父分类编号|
|<#article/category/parent/name#> |父分类名称|
|<#article/category/parent/order#> |父分类序号|
|<#article/category/parent/count#> |父分类下文章数|
|<#article/category/parent/url#> |父分类链接|
|<#article/category/parent/staticname#> |父分类别名|
=== 文章作者数据： ===
^ 标签 ^ 含义^
|<#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#> |链接|
== 2.2新增 ==
^ 标签 ^ 含义 ^ 备注^
|<#article/author/avatar#> |作者头像地址 |BlogHost/zb_users/avatar/AuthorID.png|
|<#article/author/levelname#> |作者等级名 |如管理员、网站编辑等|
=== 文章块级标签： ===
有些文章相关数据模块也有自己的模板，我们且称其为“块级标签”
^ 标签 ^ 含义 ^ 备注^
|<#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#> |文章名|
=== 文章引用数据： ===
:!://2.0版本默认删除了引用功能，相关模板文件也已一并删除，以下标签仅为1.8用户参考//
相关模板文件：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#> |首要联系 |优先显示网址，若无网址则显示邮箱地址|
|<#article/comment/emailmd5#> |Email的MD5码 |[[http://wiki.rainbowsoft.org/doku.php?id=themes:tips#%E7%BB%99%E8%AF%84%E8%AE%BA%E5%8A%A0%E5%85%A5gravatar%E5%A4%B4%E5%83%8F%E5%8A%9F%E8%83%BD|应用参考]]|
|<#article/comment/urlencoder#> |经过加扰的URL链接|防SPAM优先使用|
== 2.0新增 ==
^ 标签 ^ 含义 ^ 备注^
|<#article/comment/parentid#> |父评论ID| |
|<#article/comment/avatar#> |头像 |格式为blogsite/zb_users/AVATAR/UserID.png，非注册用户的userID为0 |
== 2.1新增 ==
^ 标签 ^ 含义 ^ 备注^
|<#article/loadviewcount#> |加载阅读数，用于列表页展示 | |
|<#article/addviewcount#> |记录并显示阅读数，用于文章页 | |
=== 文章页“前后篇文章导航条”数据： ===
相关模板文件：b_article_navbar_l.html，b_article_navbar_r.html
^ 标签 ^ 含义 ^
|<#article/nav_l/url#> |上一篇文章链接|
|<#article/nav_l/name#> |上一篇文章标题|
|<#article/nav_r/url#> |下一篇文章链接|
|<#article/nav_r/name#> |下一篇文章标题|
=== 文章发布时间： ===
以“2007年1月13日 15:31:13”时间为例说明。
^ 标签 ^ 含义 ^ 备注 ^
|<#article/posttime#> |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#> |01 |两位数，1~9将补0 |
|<#article/posttime/monthname#> |一月 |LANGUAGE文件中对应 ZVA_Month（1~12）全称|
|<#article/posttime/monthnameabbr#> |1月 |LANGUAGE文件中对应 ZVA_Month_Abbr（1~12）|
|<#article/posttime/day#> |13 |两位数，1~9将补0 |
|<#article/posttime/weekday#> |7 | |
|<#article/posttime/weekdayname#> |星期六 |LANGUAGE文件中对应 ZVA_Week（1~7）全称|
|<#article/posttime/weekdaynameabbr#> |六 |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#> |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#> |01 |两位数，1~9将补0 |
|<#article/comment/posttime/monthname#> |一月 |LANGUAGE文件中对应 ZVA_Month（1~12）全称|
|<#article/comment/posttime/monthnameabbr#> |1月 |LANGUAGE文件中对应 ZVA_Month_Abbr（1~12）|
|<#article/comment/posttime/day#> |13 |两位数，1~9将补0 |
|<#article/comment/posttime/weekday#> |7 | |
|<#article/comment/posttime/weekdayname#> |星期六 |LANGUAGE文件中对应 ZVA_Week（1~7）全称|
|<#article/comment/posttime/weekdaynameabbr#> |六 |LANGUAGE文件中对应 ZVA_Week_Abbr（1~7）|
|<#article/comment/posttime/hour#> |15 | |
|<#article/comment/posttime/minute#> |31 | |
|<#article/comment/posttime/second#> |13 | |
==== 4.文章列表 ====
=== 列表页相关信息： ===
只能在catalog.html及其相关模板中引用，以下标签在特定页之将替换为空。 \\
:!://**本节下述除ID及日期数据外，均为2.0版本新增标签**//
== 分类数据 ==
CATEGORY即显示分类页面替换以下标签
^ 标签 ^ 含义 ^
|<#articlelist/category/id#> |分类ID|
|<#articlelist/category/name#> |分类名|
|<#articlelist/category/order#> |分类序号|
|<#articlelist/category/count#> |分类下文章数|
|<#articlelist/category/url#> |分类链接|
|<#articlelist/category/staticname#> |分类静态别名，默认为分类别名，别名为空时则为分类名|
2.2新增
^ 标签 ^ 含义 ^
|<#articlelist/category/parent/id#> |父分类ID|
|<#articlelist/category/parent/name#> |父分类名|
|<#articlelist/category/parent/order#> |父分类序号|
|<#articlelist/category/parent/count#> |父分类下文章数|
|<#articlelist/category/parent/url#> |父分类链接|
|<#articlelist/category/parent/staticname#> |父分类静态别名，默认为分类别名，别名为空时则为分类名|
== 作者数据 ==
USER即显示作者页面替换以下标签（作者即对应后台“用户管理”中的用户）
^ 标签 ^ 含义 ^
|<#articlelist/author/id#> |作者ID|
|<#articlelist/author/name#> |作者名|
|<#articlelist/author/level#> |作者等级|
|<#articlelist/author/email#> |作者邮箱|
|<#articlelist/author/homepage#> |作者网址|
|<#articlelist/author/count#> |作者下文章数|
|<#articlelist/author/url#> |作者页面地址|
|<#articlelist/author/staticname#> |作者静态别名，默认为作者别名，别名为空时则为作者名|
|<#articlelist/author/intro#> |作者简介|
2.2新增
^ 标签 ^ 含义 ^ 备注^
|<#articlelist/author/avatar#> |作者头像地址 |BlogHost/zb_users/avatar/AuthorID.png|
|<#articlelist/author/levelname#> |作者等级 |如管理员、网站编辑等|
== 标签数据 ==
TAGS即显示TAGS页面替换以下标签
^ 标签 ^ 含义 ^
|<#articlelist/tag/id#> |标签编号|
|<#articlelist/tag/name#> |标签名|
|<#articlelist/tag/intro#> |标签摘要|
|<#articlelist/tag/count#> |标签下文章数|
|<#articlelist/tag/url#> |标签页面地址|
|<#articlelist/tag/encodename#> |URL编码后的标签名|
== 日期数据 ==
^ 标签 ^ 含义 ^
|<#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#> |下一页 |« 更早的文章 \\ |
|<#template:pagebar_previous#> |上一页 |之后的文章 » \\ |
|<#articlelist/page/now#> |当前页码 | |
|<#articlelist/page/all#> |总页数| |
|<#articlelist/page/count#> |每页显示条数|*2.0 |
=== 分页条样式在b_pagebar.html定制: ===
^ 标签 ^ 含义 ^
|<#pagebar/page/url#> |分页链接|
|<#pagebar/page/number#> |分页码|
==== 5.侧栏模块 ====
相关模板文件：b_function.html （//:!:2.0新增//）
Z-Blog 1.8是通过在模板文件中引用[[#文件缓存]]模块的方式呈现侧栏的，这种方式对于初学者来说编排有些复杂。
Z-Blog 2.0改进侧栏模块管理方式，将模块信息写入数据库，可在博客管理后台很方便的进行编辑或者排序。更多详情参考：[[..:zblog20:sidebar2.0]]
需要注意的是，Z-Blog 2.0保留1.8版本的引用[[#文件缓存]]的方式，如需制作高自定化的主题仍可使用。
=== 默认可用调用标签 ===
^ 标签 ^ 含义 ^ 备注^
|<#function/id#> |模块ID| |
|<#function/htmlid#> |模块HTML ID| |
|<#function/name#> |模块名 | |
|<#function/content#> |模块内容 | |
|<#function/filename#> |模块引用文件名 |指[[#文件缓存]]目录下保存模块内容的文件名 |
==== 6.文件缓存 ====
* 使用<#**CACHE**_INCLUDE_文件名（全大写且不要后缀）#>，可以引用**系统目录**((“系统目录”在1.8版中指根目录，在2.0版中指zb_system目录))INCLUDE文件夹下的文本文件内容
* 使用<#**CACHE**_INCLUDE_文件名_**HT****ML**#>，表示强制引用**系统目录**INCLUDE文件夹下的文件内容
* 使用<#**CACHE**_INCLUDE_文件名_**J****S**#>，表示强制JS方式动态引用**系统目录**INCLUDE文件夹下的文件
* 使用<#**TEMPLATE**_INCLUDE_文件名（全大写且不要后缀）#>，可以引用**主题目录((“主题目录”在1.8版中指THEMES目录，在2.0版中指zb_users/THEME目录))**INCLUDE文件夹下的文本文件内容
:!:更多引用方式请看[[tips#模板中引用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.特殊的标签 ====
<#CUSTOM_TAGS#>:只能用在tags.html，显示博客内的所有tags。//（:!: 2.0已弃用）//
<#BLOG_CREATE_TIME#>:页面文件生成的时间，可以放在default.html,single.html等页
<#BlogTitle#>:当前页的标题，
如果在default.html就是BLOG的子标题，在single.html就是文章的标题，在catalog.html就是相关分类等的名称，等等