ZBLOG模板制作笔记

SJY发表于:2013年10月25日 16:57 • 阅读:

常用系统常量

  • <#ZC_BLOG_HOST#>    博客网址    
  • <#ZC_BLOG_TITLE#>    博客标题
  • <#ZC_BLOG_SUBTITLE#>    博客简介
  • <#ZC_BLOG_THEME#>    主题名称

文章基本数据

相关模板文件如下

  • 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模板中引用。

可用参数

  • <#article/id#>    编号    
  • <#article/url#>    链接    
  • <#article/title#>    标题    
  • <#article/staticname#>    别名    
  • <#article/intro#>    摘要    
  • <#article/content#>    全文    
  • <#article/posttime#>    时间    
  • <#article/commnums#>    评论数
  • <#article/viewnums#>    浏览数,建议用JS实现浏览次数,参考 ZBLOG如何用JS实现浏览次数
  • <#article/tagtoname#> 文本形式的tag,可用于<head>区内作为关键词 
  • <#article/category/id#>    分类编号
  • <#article/category/name#>    分类名称
  • <#article/category/order#>    分类序号
  • <#article/category/count#>    该分类下文章数
  • <#article/category/url#>    分类链接
  • <#article/category/staticname#>    分类别名
  • <#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#>    作者链接
  • <#article/author/avatar#>    作者头像地址    BlogHost/zb_users/avatar/AuthorID.png
  • <#article/author/levelname#>    作者等级名    如管理员、网站编辑等

b_article_navbar_l.html 和 b_article_navbar_r.html

上一篇文章 引用标签为<#template:article_navbar_l#> 

下一篇文章 引用标签为<#template:article_navbar_r#> 

  • <#article/nav_l/url#>    上一篇文章链接
  • <#article/nav_l/name#>    上一篇文章标题
  • <#article/nav_r/url#>    下一篇文章链接
  • <#article/nav_r/name#>    下一篇文章标题

b_article_tag.html

tag链接形式 引用标签为<#template:article_tag#>

  • <#article/tag/id#>    编号
  • <#article/tag/name#>    名称
  • <#article/tag/intro#>    摘要
  • <#article/tag/count#>    文章数
  • <#article/tag/url#>    链接
  • <#article/tag/encodename#>    

b_article_mutuality.html

相关文章 引用标签为<#template:article_mutuality#>

  • <#article/mutuality/id#>    编号
  • <#article/mutuality/url#>    链接
  • <#article/mutuality/posttime#>    时间
  • <#article/mutuality/name#>    文章名

b_article_comment.html

文章评论 引用标签为<#template:article_comment#> 

  • <#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优先使用
  • <#article/comment/parentid#>    父评论ID    
  • <#article/comment/avatar#>    头像 格式为blogsite/zb_users/AVATAR/UserID.png,非注册用户的userID为0
  • <#article/loadviewcount#>    加载阅读数,用于列表页展示    <span id=“spnID”></span><script type=“text/javascript”>LoadViewCount(ID)</script>
  • <#article/addviewcount#>    记录并显示阅读数,用于文章页    <span id=“spnID”></span><script type=“text/javascript”>AddViewCount(ID)</script>

article_commentpost.html

评论发送表单 引用标签为<#template:article_commentpost#> 

article_trackback.html

引用列表 引用标签为<#template:article_trackback#> 

文章列表

只能在catalog.html及其相关模板中引用,以下标签在特定页之将替换为空。 

分类数据 CATEGORY即显示分类页面替换以下标签

  • <#articlelist/category/id#>    分类ID
  • <#articlelist/category/name#>    分类名
  • <#articlelist/category/order#>    分类序号
  • <#articlelist/category/count#>    分类下文章数
  • <#articlelist/category/url#>    分类链接
  • <#articlelist/category/staticname#>    分类静态别名,默认为分类别名,别名为空时则为分类名
  • <#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#>    作者简介
  • <#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#>    分页条    完整的分页条,后台设置显示条数
  • <#articlelist/page/now#>    当前页码    
  • <#articlelist/page/all#>    总页数    
  • <#articlelist/page/count#>    每页显示条数
  • 分页条样式在b_pagebar.html定制:
  • <#pagebar/page/url#>    分页链接
  • <#pagebar/page/number#>    分页码
  • <#template:pagebar_next#>    下一页    <span class=“pagebar-next”><a href=NextUrl><span>« 更早的文章</span></a></span>
  • <#template:pagebar_previous#>    上一页    <span class=“pagebar-previous”><a href=PrevUrl><span>之后的文章 »</span></a></span>

补充:

修改默认分页代码格式 \zb_system\FUNCTION\c_system_lib.asp 搜索 first-page 附近就是分页代码或者用插件 BetterPageBar

修改上一页,下一页的文字,其文字分别对应语言包中(LANGUAGE\SimpChinese.asp)

Const ZC_MSG156="之后的文章 »"
Const ZC_MSG155="« 更早的文章"

侧栏模块

相关模板文件:b_function.html

Z-Blog 1.8是通过在模板文件中引用文件缓存模块的方式呈现侧栏的,这种方式对于初学者来说编排有些复杂。Z-Blog 2.0改进侧栏模块管理方式,将模块信息写入数据库,可在博客管理后台很方便的进行编辑或者排序。需要注意的是,Z-Blog 2.0保留1.8版本的引用文件缓存的方式,如需制作高自定化的主题仍可使用。

默认可用调用标签

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

文件缓存

\zb_users\INCLUDE 目录下的文件均为缓存文件,文件生成的代码格式修改位置 \zb_system\FUNCTION\c_system_base.asp

  • <#CACHE_INCLUDE_文件名(全大写且不要后缀)#>,引用系统目录INCLUDE文件夹下的文本文件内容
  • <#CACHE_INCLUDE_文件名_HTML#>,表示强制引用系统目录INCLUDE文件夹下的文件内容
  • <#CACHE_INCLUDE_文件名_JS#>,表示强制JS方式动态引用系统目录INCLUDE文件夹下的文件
  • <#TEMPLATE_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#>    文章归档  

以上标签所引用文件内容均为系统自动生成,在c_system_base.asp文件中可以修改,搜索 Function MakeBlogReBuild_Core 下面就是可以修改的功能名称,搜索功能名称即可快速找到修改位置。如果懂点程序,自己制作插件会更好,这样就不用去修改系统文件,也方便他人使用。

以下标签所引用内容可在后台链接管理中修改

  • <#CACHE_INCLUDE_NAVBAR#>    导 航 条    
  • <#CACHE_INCLUDE_LINK#>    友情链接    
  • <#CACHE_INCLUDE_FAVORITE#>    网站收藏    
  • <#CACHE_INCLUDE_MISC#>    图标汇集    

特殊的标签

  • <#CUSTOM_TAGS#>:只能用在tags.html,显示博客内的所有tags
  • <#BlogTitle#>:当前页的标题, 如果在default.html就是BLOG的子标题,在single.html就是文章的标题,在catalog.html就是相关分类等的名称,等等

内容引用

<#TEMPLATE_XXX#>

表示引用模板目录下xxx.html模板文件,如<#TEMPLATE_HEADER#>即引用 header.html。 

默认主题已采用该特性,将模板头部、底部代码抽离(header.html、footer.html),让模板文件结构更明晰。

<#template:xxx#>(系统模板标签除外)

表示引用子模板即模板目录下b_xxx.html模板文件,如<#template:article-multi2#>即引用 b_article-multi2.html。

该特性可使自定义模板功能更加灵活,主模板与子模板可任意搭配。

补充:当主题中某模板文件不存在时,系统可自动调用保留模板(位于zb_system\DEFEND\default)
如某一主题中没有header.html模板文件,依然可以在模板default.html中使用<#TEMPLATE_HEADER#>标签,调用的将是系统默认header.html模板文件。

辅助代码

记录和显示浏览次数的必备辅助代码,放在模板的</head>之前

<script src="<#ZC_BLOG_HOST#>zb_system/script/common.js" type="text/javascript"></script>
<script src="<#ZC_BLOG_HOST#>zb_system/function/c_html_js_add.asp" type="text/javascript"></script>    

调用主题目录下script文件夹下的custom.js文件,用于回复评论时输入框直接显示在该条评论下面,评论输入表单的父元素ID必须为 divCommentPost 点此下载custom.js

<script src="<#ZC_BLOG_HOST#>zb_users/theme/<#ZC_BLOG_THEME#>/script/custom.js" type="text/javascript"></script>

无意义的字符调用(完全可以直接用字符)

  • <#ZC_MSG044#> 符号"-"
  • <#ZC_MSG011#> 字符"发布"
  • <#ZC_BLOG_MASTER#> 博客站长名,即"zblogger"
  • <#ZC_MSG138#> 字符"Tags"
  • <#ZC_MSG051#> 字符"置顶"
  • <#ZC_MSG146#> 字符"« 上一篇"
  • <#ZC_MSG148#> 字符"下一篇 »"  
  • <#ZC_MSG231#> 字符"相关文章"
  • <#ZC_MSG211#> 字符"留言列表"
  • <#ZC_MSG024#> 字符"发表留言"
  • <#ZC_MSG264#> 字符"取消"
  • <#ZC_MSG149#> 字符"回复"
  • <#ZC_MSG089#> 字符"验证"
  • <#ZC_MSG055#> 字符"正文"
  • <#ZC_MSG056#> 字符"留言最长字数"
  • <#ZC_MSG049#> 字符"记住我,下次回复时不用重新输入个人信息"
  • <#ZC_MSG040#> 字符"◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。"

ZBLOG主题制作小技巧 

主题样式调用

复制默认主题default下的 SOURCE目录,然后直接调用该目录下的style.css.asp文件即可,代码如下

<link href="<#ZC_BLOG_HOST#>zb_users/theme/<#ZC_BLOG_THEME#>/source/style.css.asp" rel="stylesheet" type="text/css">

标签调用技巧

比如希望文章中存在TAG,则显示TAG列表,否则不显示。

<#template:article_tag:begin#><aside>Tags: <#template:article_tag#></aside><#template:article_tag:end#>

同样的,希望仅在文章有评论时显示评论,否则不显示。

<#template:article_comment:begin#>
<h2>评论</h2>
<#template:article_comment#>
<#template:article_comment:end#>

其他标签都是同样的道理。格式如下

<#template:xxx:begin#><#template:xxx#><#template:xxx:end#>

欢迎转载,但请保留原文地址 http://www.sjyhome.com/zblog/zb-theam-note.html

回复(0)