====== Z-Blog2.0模板文件与模板标签 ====== Z-blog2.0版本对模板结构进行了优化，增加了若干新特性： * [[sidebar2.0]] * [[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 侧栏模块模板（[[sidebar2.0|更多...]]） - b_article-search-content.html 搜索结果内文模板 - b_article_comment_pagebar.html 评论分页条模板 ==== 日志页相关模板 ==== - single.html 日志页主模板文件 - b_article-single.html 日志页文章模板 - b_article_mutuality.html 每条相关文章显示模板 - b_article_comment.html 每条评论内容显示模板((“私人文章”不显示评论及评论发送表单)) - b_article_commentpost.html 评论发送表单模板((“关闭评论”不显示评论发送表单)) - b_article_commentpost-verify.html 评论验证码显示模板((启用“验证码”功能选项才显示)) - b_article_tag.html 每个tag 的显示样式 ==== 其它可选模板文件 ==== - search.html 搜索页模板，显示搜索页面，为可选模板 - 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模板中引用。 * :!:还可参考[[newfeatureof2.0]]。 ^ 标签 ^ 含义 ^ 备注 ^ |<#article/id#> |编号 | | |<#article/url#> |链接 | | |<#article/level#> |权限 | | |<#article/title#> |标题 | | |<#article/staticname#> |别名 | | |<#article/intro#> |摘要 | | |<#article/content#> |全文 | | |<#article/posttime#> |时间 |更多时间格式请看[[#文章发布时间]]| |<#article/commnums#> |评论数 | | |<#article/viewnums#> |浏览数 |推荐使用JS显示浏览数 [[..:theme: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/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码 |[[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#> |头像 | | === 文章发布时间： === 以“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#> |下一页 |« 更早的文章 \\ | |<#template:pagebar_previous#> |上一页 |之后的文章 » \\ | |<#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改进侧栏模块管理方式，将模块信息写入数据库，可在博客管理后台很方便的进行编辑或者排序。更多详情参考：[[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文件夹下的文本文件内容 :!:更多引用方式请看[[..:theme: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.特殊的标签 ==== <#BLOG_CREATE_TIME#>:页面文件生成的时间，可以放在default.html,single.html等页 <#BlogTitle#>:当前页的标题，如果在default.html就是BLOG的子标题，在single.html就是文章的标题，在catalog.html就是相关分类等的名称，等等