Zblog帮助:模板文件与模板标签
Z-blog 主题下 TEMPLATE 文件夹是专门放置模板文件的。
-
相关参考:
- 默认模板页面结构分析
- 默认模板侧栏代码整理和注释
- 主题制作技巧
文件组成
模板文件图解参考
首页相关模板
- default.html 首页主模板文件
- b_article-multi.html 摘要文章模板
- b_article-istop.html 置顶文章模板
- b_pagebar.html 页面底部分页条模板,可以改分页条样式
列表页相关模板
所谓列表页面是指由catalog.asp显示的页面。
- catalog.html 分类页模板文件
- 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_MSG001-ZC_MSGxxx 引用:<#ZC_MSGxxx#>
这里xxx是要引用的字符串资源的最后3位数字。
3.文件缓存区
- 使用<#CACHE_INCLUDE_文件名(全大写且不要后缀)#>,可以引用根目录INCLUDE文件夹下的asp后缀的文件
- 使用<#TEMPLATE_INCLUDE_文件名(全大写且不要后缀)#>,可以引用主题目录INCLUDE文件夹下的asp后缀的文件
更多引用方式请看如何在模板中引用include目录内文件
默认可用调用标签
标签 | 含义 |
---|---|
<#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 | |
<#template:article_tag#> | tags | 链接形式 |
<#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#> | |
<#article/author/homepage#> | 网站链接 |
<#article/author/count#> | 文章数 |
<#article/author/url#> | 链接 |
文章块级标签:
有些文章相关数据模块也有自己的模板。
标签 | 含义 | 备注 |
---|---|---|
<#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#> | ||
<#article/comment/posttime#> | 时间 | |
<#article/comment/content#> | 内容 | |
<#article/comment/authorid#> | 作者编号 | |
<#article/comment/firstcontact#> | 首要联系 | 网址优先 |
<#article/comment/emailmd5#> | Email的MD5码 | 应用参考 |
<#article/comment/urlencoder#> | 经过加扰的URL链接 | 防SPAM优先使用 |
文章页“前后篇文章导航条”数据:
相关模板文件: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#> | 下一页 | ||
<#template:pagebar_previous#> | 上一页 | ||
<#articlelist/page/now#> | 当前分页页码 | ||
<#articlelist/page/all#> | 总分页数 |
分页条在b_pagebar.html定制:
标签 | 含义 |
---|---|
<#pagebar/page/url#> | 分页链接 |
<#pagebar/page/number#> | 分页码 |
6.特殊的标签
<#BLOG_CREATE_TIME#>:页面文件生成的时间,可以放在default.html,single.html等页
<#BlogTitle#>:当前页的标题 如果在default.html就是BLOG的子标题,在single.html就是文章的标题,在catalog.html就是相关分类等的名称,等等
以上标签列表为有限集合,超出以上列表系统将不会替换。