Z-Blog Wiki Z-Blog Wiki

Z-Blog官方文库

用户工具

站点工具


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 (外部编辑)