Z-Blog Wiki Z-Blog Wiki

Z-Blog官方文库

用户工具

站点工具

您在这里: Z-Blog & Z-BlogPHP » Z-Blog(ASP) » 主题 » 模板文件与模板标签
zblogasp:theme:template

目录

模板文件与模板标签

Z-blog 主题下 TEMPLATE 文件夹是专门放置模板文件的。1.8版本推荐新手安装主题修改助手插件。（:!:2.0以上版本中的文件管理插件已附带该功能）

文件组成

:!: 模板文件图解参考 :!: 默认模板里各文件内容说明

首页与列表页相关模板

  1. default.html 首页主模板文件
  2. catalog.html 列表页模板文件1)
  3. b_article-multi.html 摘要文章模板
  4. b_article-istop.html 置顶文章模板2)
  5. b_pagebar.html 页面底部分页条模板，可以改分页条样式

2.0新增模板文件

  1. page.html 独立页面模板，默认tags、search均用该模板
  2. b_function.html 侧栏模块模板（更多...）
  3. b_article-search-content.html 搜索结果内文模板
  4. b_article_comment_pagebar.html 评论分页条模板

日志页相关模板

  1. single.html 日志页主模板文件
  2. b_article-single.html 日志页文章模板
  3. b_article_navbar_l.html 日志页面文章导航，显示“上一篇”日志链接3) （Z-Blog 2.0默认删除，改为可选模板）
  4. b_article_navbar_r.html 日志页面文章导航，显示“下一篇”日志链接 （Z-Blog 2.0默认删除，改为可选模板）
  5. b_article_trackback.html 每条引用通告显示模板
  6. b_article_mutuality.html 每条相关文章显示模板
  7. b_article_comment.html 每条评论内容显示模板4)
  8. b_article_commentpost.html 评论发送表单模板5)
  9. b_article_commentpost-verify.html 评论验证码显示模板6)
  10. b_article_tag.html 每个tag 的显示样式

留言本相关模板

留言本所用模板为可选项，如不存在则会使用日志页模板。 （Z-Blog 2.0已删除该项，改为以页面实现）

  1. b_article-guestbook.html 留言页正文模板，若不存在则调用 b_article-single.html 模板
  2. guestbook.html 留言页主模板文件（默认主题无此文件），若不存在则调用 single.html 模板

其它模板文件

  1. search.html 搜索页模板，显示搜索页面 （Z-Blog 2.0默认删除，改为可选模板）
  2. 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，还可参考Z-Blog 2.0模板新特性。
标签 含义 备注
<#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/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码 应用参考
<#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#> 加载阅读数，用于列表页展示 <script type=“text/javascript”>LoadViewCount(ID)</script>
<#article/addviewcount#> 记录并显示阅读数，用于文章页 <script type=“text/javascript”>AddViewCount(ID)</script>

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

相关模板文件：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#> 下一页 <a href=NextUrl>« 更早的文章
</a>
<#template:pagebar_previous#> 上一页 <a href=PrevUrl>之后的文章 »
</a>
<#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改进侧栏模块管理方式，将模块信息写入数据库，可在博客管理后台很方便的进行编辑或者排序。更多详情参考：Z-Blog 2.0主题侧栏使用说明

需要注意的是，Z-Blog 2.0保留1.8版本的引用文件缓存的方式，如需制作高自定化的主题仍可使用。

默认可用调用标签

标签 含义 备注
<#function/id#> 模块ID
<#function/htmlid#> 模块HTML ID
<#function/name#> 模块名
<#function/content#> 模块内容
<#function/filename#> 模块引用文件名 指文件缓存目录下保存模块内容的文件名

6.文件缓存

  • 使用<#CACHE_INCLUDE_文件名（全大写且不要后缀）#>，可以引用系统目录7)INCLUDE文件夹下的文本文件内容
  • 使用<#CACHE_INCLUDE_文件名_HTML#>，表示强制引用系统目录INCLUDE文件夹下的文件内容
  • 使用<#CACHE_INCLUDE_文件名_JS#>，表示强制JS方式动态引用系统目录INCLUDE文件夹下的文件
  • 使用<#TEMPLATE_INCLUDE_文件名（全大写且不要后缀）#>，可以引用主题目录8)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就是相关分类等的名称，等等

1)
指由catalog.asp展现的页面。
2)
置顶文章会自动显示于首页及列表页中，无须标签调用
3)
文章导航功能启用时才可以调用
4)
“私人文章”不显示评论及评论发送表单
5)
“锁定文章”不显示评论发送表单
6)
启用“验证码”功能选项才显示
7)
“系统目录”在1.8版中指根目录，在2.0版中指zb_system目录
8)
“主题目录”在1.8版中指THEMES目录，在2.0版中指zb_users/THEME目录
zblogasp/theme/template.txt · 最后更改: 2016/06/21 15:02 (外部编辑)

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： CC Attribution-Noncommercial-Share Alike 4.0 International
CC Attribution-Noncommercial-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki