Z-Blog Wiki Z-Blog Wiki

Z-Blog官方文库

用户工具

站点工具

您在这里: Z-Blog & Z-BlogPHP » Z-Blog(ASP) » Z-Blog 2.0新特性 » Z-Blog2.0模板文件与模板标签
zblogasp:zblog20:template2.0

目录

Z-Blog2.0模板文件与模板标签

Z-blog2.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_mutuality.html 每条相关文章显示模板
  4. b_article_comment.html 每条评论内容显示模板3)
  5. b_article_commentpost.html 评论发送表单模板4)
  6. b_article_commentpost-verify.html 评论验证码显示模板5)
  7. b_article_tag.html 每个tag 的显示样式

其它可选模板文件

  1. search.html 搜索页模板，显示搜索页面，为可选模板
  2. tags.html 标签页模板，显示TagCloud，为可选模板

模板标签

Z-Blog模版标签库及相关说明

1.系统常量

(c_option.asp)

标签 含义 备注
<#ZC_BLOG_VERSION#> 版本号 Z-Blog 2.0 Beta2 Build 121028
<#ZC_BLOG_LANGUAGE#> 博客页面语言 默认为zh-CN
<#ZC_BLOG_HOST#> 博客网址
<#ZC_BLOG_TITLE#> 博客标题 显示于浏览器标题栏
<#ZC_BLOG_SUBTITLE#> 博客简介
<#ZC_BLOG_COPYRIGHT#> 版权说明
<#ZC_BLOG_MASTER#> 博客站长名
<#ZC_CONTENT_MAX#> 留言最长字数
<#ZC_BLOG_CLSID#> 博客唯一标识号
<#ZC_TIME_ZONE#> 博客时区 默认为+0800 ,即北京时间
<#ZC_BLOG_THEME#> 主题名称

以上标签所表示的参数大多可在后台的网站设置中进行修改。

2.语言资源

(LANGUAGE/SimpChinese.asp)

<#ZC_MSGxxx#> 引用内容自：ZC_MSG001-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模板新特性。
标签 含义 备注
<#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

文章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_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#> 头像

文章发布时间：

以“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#> 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

评论发布时间：

:!:2.0版本新增

以“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#> 1
<#article/comment/posttime/monthname#> January LANGUAGE文件中对应 ZVA_Month（1~12）全称
<#article/comment/posttime/day#> 13
<#article/comment/posttime/weekday#> 7
<#article/comment/posttime/weekdayname#> Saturday LANGUAGE文件中对应 ZVA_Week（1~7）全称
<#article/comment/posttime/hour#> 15
<#article/comment/posttime/minute#> 31
<#article/comment/posttime/second#> 13

4.文章列表

列表页相关信息：

只能在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#> 下一页 <a href=NextUrl>« 更早的文章
</a>
<#template:pagebar_previous#> 上一页 <a href=PrevUrl>之后的文章 »
</a>
<#articlelist/page/now#> 当前页码
<#articlelist/page/all#> 总页数

分页条样式在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_文件名（全大写且不要后缀）#>，可以引用系统目录6)INCLUDE文件夹下的文本文件内容
  • 使用<#CACHE_INCLUDE_文件名_HTML#>，表示强制引用系统目录INCLUDE文件夹下的文件内容
  • 使用<#CACHE_INCLUDE_文件名_JS#>，表示强制JS方式动态引用系统目录INCLUDE文件夹下的文件
  • 使用<#TEMPLATE_INCLUDE_文件名（全大写且不要后缀）#>，可以引用主题目录7)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.特殊的标签

<#BLOG_CREATE_TIME#>:页面文件生成的时间，可以放在default.html,single.html等页

<#BlogTitle#>:当前页的标题， 如果在default.html就是BLOG的子标题，在single.html就是文章的标题，在catalog.html就是相关分类等的名称，等等

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

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： 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