[风格技巧] Bo-Blog 2.0风格制作手册+经验分享专贴！

本手册最后修正于： 2006年10月21日
最后适用的版本： 2.0.2 sp2

第一部分 风格组成

一个完整的Bo-Blog 2.0的风格（以下简称风格）由以下几个部分组成：
风格文件夹，位于template/文件夹下
|- 风格的CSS文件 style.css；
|- 风格的图片文件夹；
|- 风格的信息文件 info.php；
|- 风格的结构定义文件 element.php；
|- 风格的缩略图文件。

其中，粗体字标出的文件为必需。

这些文件的作用和注释如下：
1. CSS文件
该文件是整个风格的最主要部分，我们建议所有的风格都尽力在配合默认架构 default/template.php 文件的基础上修改。也就是说，建议只修改CSS文件达到您想要的效果，而不是修改模板架构本身。CSS+DIV的网页排版方式符合标准，也能创造出风格迥异的丰富效果来。
有关CSS文件中各个Class的命名和对应区域，请阅读第三部分。

2. 风格的图片文件夹
我们建议您在专门建立一个文件夹以存放该风格用到的图片，而不是将所有图片都存放在风格的根目录下。
推荐您在风格所在的文件夹下建立images子文件夹，放置用到的图片文件。

3. 风格的信息文件 info.php
这个文件存放了风格的作者等重要信息。它必须是没有错误的PHP文件，编码必须采用UTF-8。（我们推荐使用的文本编辑器见第二部分。）
下面是默认风格的 info.php ，存在于 template/default/ 文件夹下。结合这个文件为您说明该文件的结构。注意：双斜杠 // 后面以及 和 /* 与 */ 之间的文字为注释，事实上您的文件不需要包括这些注释。


<div class=msgbody><div class=msgheader>QUOTE:</div><div class=msgborder>
<?PHP
//PHP文件开始。
//请使用这样的形式而不是short tag，即：不要缩写成 <? ，也不要写成 <%，尽管这样可能也能被识别。

$template[\'id\']=\"60A13BBE-C069-47A1-A0A1-FA7C4ECCAA47\";
//这一行的引号中是这个风格的ID。ID是便于程序识别一个风格的一个字符串，可以是任何拉丁字符、数字等。比如 mystyle、style200601等都是允许的。但为了减少你的ID和任何人发布的其它风格重复的概率，建议您将ID设置得复杂一些。一个建议是像默认风格这样使用GUID。

$template[\'name\']=\"Default\";
//引号中是这个风格的名字。

$template[\'author\']=\"Bob Shen\";
//引号中是这个风格的作者。注意这里是支持HTML代码的。

$template[\'intro\']=\"Default skin of Bo-blog 2.0.1.\";
//引号中是这个风格的简介。

$template[\'dirname\']=\"default\";
//引号中是这个风格所在文件夹的名字。假如您的风格名为pure，那么它的所有文件就应该存放在 template/pure/ 下，而这里的值也应该改为 pure。

$template[\'thumbnail\']=\"thumb.jpg\";
//引号中是这个风格的缩略图文件的文件名。缩略图应该放置在这个风格文件夹下。文件名在此指定。

$template[\'structure\']=\"template/default/elements.php\";
//引号中是这个风格的结构定义文件的位置和文件名。对于只修改CSS就能完成的风格，您不必再在风格文件夹中放置一个 elements.php，而完全可以采用默认的，也就是保持该行不修改。

$template[\'images\']=\"template/default/images\";
//引号中指定了blog界面上的部分图片的位置。这些图片包括RSS图标、上/下一篇日志的图标等等。具体的文件名请阅读第四部分。

$template[\'css\']=\"template/default/styles.css\";
/* 引号中是CSS文件的位置和文件名。Bo-Blog 2.0支持同一风格载入多个CSS。因此这里可以写成数组的形式。比如，如果您的风格用到了3个CSS文件，分别是 structure.css、style.css、extra.css，您可以写成：
$template[\'css\']=\"template/default/structure.css\";
$template[\'css\']=\"template/default/style.css\";
$template[\'css\']=\"template/default/extra.css\";
注意数组上标从 0 开始。
这些css文件会被程序自动全部载入模板。*/
</div></div>


4. 风格的结构定义文件 element.php
这也是一个PHP文件，也必须使用UTF-8编码。它规定了模板的结构，也就是各个区域具体的HTML代码。有关这个文件的详细说明，请参考第五部分。

5. 风格缩略图文件
大小是400*300像素，建议为JPG、GIF和PNG格式。为了不增加额外的空间负担，不建议您截取精读太高的缩略图。


第二部分 一些建议和要求

1. 文本编辑器
编辑文本文件的编辑器可谓多如牛毛，您完全可以选择最顺手的使用。但是有一些情况您需要了解。
Bo-Blog采用 UTF-8 编码，因此所有文本文件（风格中涉及的是PHP文件）必须储存为 UTF-8 编码。另外，部分文本编辑软件，如Dreamweaver、记事本等，在保存UTF-8文件时会在文件最开始加入UTF-8识别记号（BOM）。BOM在WINDOWS下打开文件时不可见，但PHP在读取文件时仍会将其作为文件的一部分，由此会产生cookie失效（无法登入），模板无法顶住页面顶部等现象。

解决的方法：
建议您使用 Editplus 2.12 或者 EmEditor 编辑PHP文件。它们对无BOM的UTF-8文件兼容较好；
UltraEdit用户需将 Write UTF-8 BOM header to ALL UTF-8 files when saved 选项设置为关；
其它文本编辑器用户，在编辑完后如发现程序异常，可参考这篇文章解决。

2. 针对发布者的建议
您可以将您修改、制作的风格发布到论坛的2.0模板风格专版，我们会非常感谢您的分享。
对于出色的风格，将被收入官方网站的“风格”栏目（筹）。

对发布者有这样的一些建议：
1. 兼容性
建议您在制作风格时考虑到浏览器的兼容问题。由于 2.0 采用的是CSS+DIV布局，因此可能在不同的浏览器上存在不同的显示效果。建议您在发布时考虑到主流浏览器的兼容问题。一个方法是：在发布的帖子里注明：在IE下测试通过；暂不兼容Firefox；可在IE、Fx、Opera下正确显示 等等类似的字样。
对于收入官方风格栏目的风格，至少需要做到同时与IE和Firefox兼容。

2. thumb.db
Windows XP会在您的图片文件夹下生成一个名为 thumb.db 的隐藏文件。当您把这个文件也打包到压缩包里时，会导致压缩文件体积增大不少！所以建议您不要把这个文件放到压缩包里。以常用软件winrar为例，可以在压缩完成后，打开压缩文件，就能看到这个文件是否存在了。

3. 压缩格式
推荐的压缩包格式为： Zip和Gzip两种。

4. 源文件
您可以自主决定是否将图片的源文件放入压缩包。如果您不打算提供源文件的话，建议您提供一张没有加过自己站名的空白logo图，方便下载者修改。当然，这都出于自愿。

5. elements.php 文件
这个文件可能会随着程序的不断完善而不断修改，因此如果非必要，建议您使用默认的elements.php，也就是在风格的info.php中将structure指向template/default/elements.php（请参考第一部分的说明）。


第三部分 CSS

1. 总布局
提示：使用Firefox的DOM查看器可以方便地查看页面的结构。

总布局参考图如下：
图中色块代表了一个div，色块注释文字表示的是这个div的class（或ID） name。
请点击在新窗口中查看图片。



2. CSS详解
下面介绍主要的CSS类的用途和一些说明。请参考整体框架图阅读。

2.1 整体框架
#wrapper - 整个页面的框架。
#innerWrapper - 内嵌在wrapper里的整个页面的框架。

2.2 顶部框架
#header - 整个顶部框架
#innerHeader - 内嵌在header里的框架。
.blog-header - 包含blog标题和描述。
h1 - blog的标题。
.blog-desc - blog的描述语。
menu - blog的顶部模块（导航条）。

2.3 主体框架
#mainWrapper - 整个主体部分的框架，包含了侧边栏和主内容这两个框架。

2.4 侧边栏框架
.sidebar - 整个侧边栏框架。
#innerSidebar - 内嵌在sidebar内的框架。
.sidebar-hide - 当侧边栏关闭时的侧边栏样式。（display: none;）
.panel - 具体到某一个侧边栏项目的总框架。
.panel h5 - 侧边栏项目的抬头部分。
.panel-content - 侧边栏项目的主要内容区域。
.panel-content li - 侧边栏包含列表项的样式。
.panel-content li.indent - 侧边栏列表项缩进后的样式（如链接前的列表符号）。
.search-field - 搜索框样式。

2.5 主内容框架
.content - 主内容的总框架。
#innerContent - 内嵌于content的框架。
.announce - 公告框样式。
.announce-content - 公告内容样式。
.article-top - 分页条（位于顶部）样式。
.article-bottom - 分页条（位于底部）样式。
.pages - 分页条文字样式。
.pagelink-current - 当前页文字样式。
..textbox - 每篇日志的总框架。
.textbox-title - 日志标题位置样式。
.textbox-title h4 - 日志标题文字样式。
.textbox-label - 发表日期栏样式。
.textbox-fontsize - 日志工具条（字号选择等）样式。
.textbox-content - 日志内容样式。
.textbox-bottom - 日志底部工具条样式。
.textbox-adminbar - 管理工具条样式。
.textbox-tburl - Trackback地址条样式。
.tags - tags显示条样式。
.prev-article - 上一篇提示文字样式。
.next-article - 下一篇提示文字样式。

2.6 日历部分
#calendar - 日历总框架。
.calendar-main - 日历总体样式。
.calendar-top - 日历顶端文字样式。
.calendar-year - 年的样式。
.calendar-month - 月的样式。
.calendar-weekday-cell - 星期的样式。
.calendar-day - 普通工作日样式。
.calendar-saturday - 星期六的样式。
.calendar-sunday - 星期日的样式。
.calendar-today - 今日样式。

2.7 评论显示框
.commentbox - 单条评论（或留言，下同）整体框架。
.commentbox-title - 评论标题样式。
.commentbox-label - 评论日期文字样式。
.commentbox-content - 评论内容样式。
.trackbackbox - 单条trackback框架。
.trackbackbox-title - trackback标题样式。
.trackbackbox-label - trackback日期文字样式。
.trackbackbox-content - trackback内容样式。

2.8 表格样式
.listbox - 表格整体框架。
.listbox-table - 表格的宽度。
.listbox-header - 表格头部文字样式。
.listbox-entry - 表格正文文字样式。

2.9 添加评论框
.formbox - 评论表单所在框。
.formbox-title - 评论表单标题文字样式。
.panel-smilies - 表情选择栏。
.panel-smilies-title - 表情栏文字样式。
.panel-smilies-content - 表情栏内容样式。

2.10 提示页样式
.messagebox - 消息框整体。
.messagebox-title - 消息框标题。
.messagebox-content - 消息框内容样式。
.messagebox-bottom - 消息框底部文字样式。

2.11 细节样式
.code - 代码框样式。
.quote - 引用框整体框架。
.quote-title - 引用框标题文字样式。
.quote-content - 引用框内容样式。

2.12 底部框架
#footer - 底部总框架。
#innerFooter - 底部内嵌框架。


第四部分 风格所需图片

以下介绍位于 $template[\'images\'] 所在位置（参考第一部分）的图片名称和作用：

detail.gif - 查看用户列表时，点击查看用户资料的图标（默认：一个小人）
download.gif - 使用[ file ]下载UBB标签后，文件下载框中的图标（默认：一个磁盘）
email.gif - 评论和留言中，点击给他/她发邮件的图标（默认：一个信封）
folder.gif - 展开/折叠被折叠的置顶日志的图标（默认：两个向下的箭头）
homepage.gif - 评论和留言中，点击访问他/她的主页的图标（默认：一个外部链接箭头）
ip.gif - 评论和留言中，点击查看他/她的IP来源的图标（默认：一个放大镜）
readmore.gif - 查看更多内容（默认：多页纸重叠）
real.gif - Real文件播放框内的图标（默认：RealOne的图标）
rss.png - 侧边栏分类名称旁的RSS链接所用图标（默认：写有rss字样的方框）
swf.gif - Flash文件播放框内的图标（默认：Flash的图标）
toolbar_fontsize.gif - 日志阅读工具栏的字体大小提示图标（默认：一个向右的箭头）
toolbar_next.gif - 日志阅读工具栏的下一篇日志提示图标（默认：一个向下的箭头）
toolbar_previous.gif - 日志阅读工具栏的上一篇日志提示图标（默认：一个向上的箭头）
toolbar_rss.gif - 日志阅读工具栏的本文rss链接的图标（默认：写有rss字样的小方框）
toolbar_save.gif - 日志阅读工具栏的保存本文的图标（默认：一页纸）
trackback.gif - Trackback条目前的提示图标（默认：一个气泡）
viewimage.gif - 查看图片前的链接图标（默认：一张照片）
wmp.gif - Windows Media Player文件播放框内的图标（默认：WMP的图标）

提示：
IE 7.0以前的版本不能正确显示PNG的透明色。在制作 rss.png时需注意。


第五部分 elements.php文件

下面解释elements.php文件的作用和内容。
这个文件里定义了各个部分的html表现代码。之所以设立这样一个文件，是为了满足在仅仅修改css无法达到布局更改时的需求。

这个文件的内容就是一些赋值语句。形式为 $elements[ElementName]=ElementHtmlCode; 。
Element的名称和含意对照如下：

$elements[\'header\'] 文件开始
$elements[\'displayheader\'] 顶部
$elements[\'mainpage\'] 日志页面
$elements[\'otherpage\'] 其它页面
$elements[\'displayside\'] 侧边栏
$elements[\'displayfooter\'] 底部
$elements[\'footer\'] 文件结束
$elements[\'msgbox\'] 出错/成功信息提示框
$elements[\'sideblock\'] 侧栏项目
$elements[\'excerpt\'] 摘要
$elements[\'excerptontop\'] 置顶的摘要
$elements[\'viewentry\'] 查看日志
$elements[\'listbody\'] 日志列表
$elements[\'list\'] 日志列表单行
$elements[\'comment\'] 评论
$elements[\'trackback\'] 引用
$elements[\'form_reply\'] 评论发表框
$elements[\'endviewentry\'] 查看日志的补充
$elements[\'entryadditional\'] “查看更多”区域
$elements[\'login\'] 登入表单
$elements[\'contentpage\'] 内容页
$elements[\'taglist\'] tags
$elements[\'register\'] 注册表单
$elements[\'normaltable\'] 一般表格
$elements[\'normaltablewithtitle\'] 一般表格（带有表格标题）
$elements[\'form_eachline\'] 表格一行
$elements[\'eachlink\'] 链接页（单项）
$elements[\'linkdiv\'] 链接页（组）
$elements[\'tips\'] 提示信息的页面

1. 被替换标签以 {开头，以}结束，在模板解析时会被替换为实际的内容。例如，星标的标签为
由于这里的标签很多，时间有限暂不一一讲解，大部分标签都是可以顾名思义的，在制作模板时可以边测试边修改。

2. 不同侧边栏项目的区块可以分别定义。
例如，$elements[\'sideblock_categories\'] 可定义名为 categories 的项目（即分类项目）的html。
形式为 sideblock_itemname 。当一个item显示时，如果有 $elements[\'sideblock_item\'] ，则优先使用此处的定义，否则使用默认（$elements[\'sideblock\']）。


第六部分 标签

用{}包含起来的是“标签”，标签可以被解释成具体的html内容。其意义如下：

注1： 标有*号的是2.0.3起新增的标签。
注2： 各个标签在其规定的区域内可直接使用，例如在 $elements[\'header\'] 区域中，{blogkeywords}可直接输出blog关键词。但这些标签不是全局性的，当在 $elements[\'displayheader\'] 中引用时，不会被解释。在Bo-blog 2.0.3以前的版本中，您无法跨区域使用标签，但 2.0.3 版本起，程序提供了一个跨区域引用标签的方法。要使用非本区域中定义的标签，请使用 <!--global:{标签名}--> 。例如，在本例中，书写 <!--global:{blogkeywords}--> 即可输出blog关键词。

1. $elements[\'header\'] 文件开始
*language - 网页使用的语言代码，如zh-cn（简体中文）、en（英语）
blogdesc - blog描述语
blogkeywords - blog关键词
baseurl - <baseurl>设置
blogname - blog名
csslocation - CSS载入代码
pagetitle - 当前页面标题，如“留言本”
ajax_js - 载入Ajax所需js代码
extraheader - 载入header区域额外代码

2. $elements[\'displayheader\'] 顶部
blogname - blog名
blogdesc - blog描述语
section_head_components - 顶部导航内容（如首页、链接、Tags等），生成的是一组列表（<li>）

3. $elements[\'mainpage\'] 日志页面
ifannouncement - 顶部公告显隐状态（block/none）
topannounce - 顶部公告内容
iftoppage - 顶部分页条显隐状态（block/none）
ifbottompage - 底部分页条显隐状态（block/none）
mainpart - 页面整体内容，由具体的分页面生成
pagebar - 分页条完整内容 （包含当前页面指示、分页选择、上下页选择）
*currentpage - 当前处于第几页
*previouspageurl - 上一页的链接地址
*nextpageurl - 下一页的链接地址
*turningpages - 翻页部分
*totalpages - 总共有几页

4. $elements[\'otherpage\'] 其它页面
mainpart - 页面整体内容，由具体的分页面生成

5. $elements[\'displayside\'] 侧边栏
section_side_components - 侧边栏总内容
*siderbarcounter - 总共显示了几个侧边栏项目

6. $elements[\'displayfooter\'] 底部
mainpart - 底部内容，由程序根据底部模块配置生成

7. $elements[\'footer\'] 文件结束
此部分无任何标签

8. $elements[\'msgbox\'] 出错/成功信息提示框 （废弃）
message - 提示框内显示的信息

9. $elements[\'sideblock\'] 单一侧栏项目
id - 该侧边栏项目的识别名
title - 侧边栏项目的标题
ifextend - 是否展开（block/none）
content - 侧边栏内容

10. $elements[\'excerpt\'] 普通的摘要
entrystar - 星标
entrytitle - 带链接的日志标题
*baseurl - 不带链接的日志标题
*entryrelurl - 日志链接URL（相对链接）
*entryabsurl - 日志链接URL（绝对链接）
entryicon - 天气
entrydate - 完整的日志发布日期 （年/月/日）
*entrydatey - 日志发布日期之‘年’
*entrydatem - 日志发布日期之‘月’
*entrydated - 日志发布日期之‘日’
entrytime - 日志发布时刻
entryauthor - 日志发布者
entrycontent - 日志内容
iftags - 有无设置tags（block/none）
tags - “Tags”
alltags - 本文的tags
entrycateicon - 所属分类的分类图标
entrycate - 分类名
entrycomment - “评论”（评论数）
*entrycommentnum - 单纯的评论数
entrytb - “引用”（引用数）
*entrytbnum - 单纯的引用数
entryviews - “阅读”（阅读次数）
*entryviewsnum - 单纯的阅读次数
ifadmin - 管理的链接
tbbar - 引用传输的地址显示区域（带地址）
*entrytburl - 引用传输的URL
adminbar - 管理栏
topid - 置顶日志的唯一id
previous - 上一篇日志的链接和标题
next - 下一篇日志的链接和标题
ifedited - 本文最后编辑时间和编辑者（仅打开相关选项时有效）

11. $elements[\'excerptontop\'] 置顶的摘要
此部分支持标签与 $elements[\'excerpt\'] 完全一致

12. $elements[\'viewentry\'] 查看日志
此部分支持标签与 $elements[\'excerpt\'] 完全一致

13. $elements[\'list\'] 日志列表单行
此部分支持标签与 $elements[\'excerpt\'] 完全一致

14. $elements[\'listbody\'] 日志列表
listbody - 列表具体内容

15. $elements[\'comment\'] 评论
replier - 评论人
replieremail - 评论者的email
replierhomepage - 评论者的主页地址
replierip - 评论者的ip
replytime - 评论时间
addadminreply - 添加、修改管理员回复的链接
deladminreply - 移除管理员回复的链接
delreply - 移除此评论的链接
replycontent - 评论内容
ifadminreplied - 管理员是否回复过（block/none）
commentid - 管理员回复id
adminrepliershow - 管理员回复的回复者名字、时间
adminreplycontent - 管理员回复的内容
commentid - 此评论的唯一id
adminreplybody - 管理员评论输入框

16. $elements[\'trackback\'] 引用
tbtitle - 引用的标题
tbtime - 引用传送时间
delreply - 删除此引用
tburl - 引用来源URL
tbblogname - 引用来源日志名
tbcontent - 引用内容

17. $elements[\'form_reply\'] 评论发表框
jobnow - 当前表单动作
formtitle - 表单标题
emots - 表情框
disable_html - html可用状态
disable_ubb - ubb可用状态
disable_emot - 表情可用状态
if_neednopsw_begin - 是否显示密码输入框（<!--）
replier - 当前的评论者名称
disable_replier - 评论者名称输入框可用状态
password - 当前的评论者密码
disable_password - 评论者密码输入框可用状态
repurl - 评论者网站地址
repemail - 评论者邮件地址
if_neednopsw_end - 是否显示密码输入框（-->）
additional - 额外js
ubbcode - UBB工具条
if_securitycode_begin - 是否显示验证码（<!--）
rand - 随机数，只起到强制浏览器更新验证码的作用，非验证码本身
if_securitycode_end - 是否显示验证码（-->）
hidden_areas - 表单隐藏数据

18. $elements[\'endviewentry\'] 查看日志的补充
innerpages - 该日志的内部分页
form_reply - 该日志的评论区域

19. $elements[\'entryadditional\'] “查看更多”区域
readmore - “查看更多”

20. $elements[\'login\'] 登入表单 （2.0.3废弃）
lvstart - 是否显示验证码（<!--）
lvend - 是否显示验证码（-->）
rand - 随机数，只起到强制浏览器更新验证码的作用，非验证码本身

21. $elements[\'contentpage\'] 内容页
title - 该页标题
contentbody - 该页内容

22. $elements[\'taglist\'] tags
tagcategory - tag页的标题
tagcontent - tag页的内容
tagextra - tag页的额外说明

23. $elements[\'register\'] 注册表单 （2.0.3的登入表单合并入此）
job - 当前表单动作
title - 当前表单标题
registerbody - 表单整体内容

24. $elements[\'normaltable\'] 一般表格
tablebody - 表格内容

25. $elements[\'normaltablewithtitle\'] 带有标题的一般表格
title - 标题
tablebody - 表格内容

26. $elements[\'form_eachline\'] 表格一行
text - 副标题列
formelement - 内容列

27. $elements[\'eachlink\'] 链接页（单项）
logo - 链接logo
title - 链接网站名
desc - 链接描述

28. $elements[\'linkdiv\'] 链接页（组）
title - 链接组名
tablebody - 链接组内容

29. $elements[\'tips\'] 提示信息的页面
*language - 网页使用的语言代码，如zh-cn（简体中文）、en（英语）
blogdesc - blog描述语
blogname - blog名
csslocation - CSS载入代码
title - 信息框标题
tips - 信息主体内容
admin_plus - 管理员特有的链接

（END）
skintutorial.swf

［此帖子已被 花笑如 在 2007-8-20 23:45:21 编辑过］