Z-Blog Wiki Z-Blog Wiki

Z-Blog官方文档

用户工具

站点工具


zblogasp:theme:std

Z-Blog主题制作说明

:!: 以下说明适用于Z-Blog 1.8 及以上版本

1.主题发布的必备条件

  1. 主题名称的英文ID, 与其它现有主题不重名.
  2. 主题信息文件, Theme.xml, 内含主题发布信息.
  3. 主题截图文件, ScreenShot.png, 300*240像素, 横向.

2.主题目录文件结构

主题目录, 名称为主题的英文ID, 位于Z-Blog之THEMES目录下. 此目录中有如下文件或文件夹

  • 必需:
    1. 文件: Theme.xml, 主题信息.
    2. 文件: ScreenShot.png, 主题截图.
    3. 目录: Template, 模板目录, 内存模板文件.
    4. 目录: Style, 样式目录, 内存样式表及所需图片.
  • 可选:
    1. 目录: Include, 包含文件目录, 相当于Z-Blog之Include目录的主题专用版1).
    2. 目录: Plugin, 此目录下装有主题所包含的插件2).
    3. 目录: Common, 主题自行加入的共用脚本,flash等元素,存放于此目录中。

3.Theme.xml格式规范说明

ThemeSapper (TS) 插件提供了Theme.xml文档的编辑器, 不太了解XML的用户可以通过此编辑器生成标准的主题信息文档. TS同时还提供了与在线安装包版本匹配的打包器, 以备需求.

样例文档

Theme.xml

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <theme version="0.1">
    <id>Default</id>
    <name>Default主题</name>
    <url>http://download.rainbowsoft.org/</url>
    <note>Z-Blog的默认主题</note>
    <author>
            <name>zx.asd</name>
            <url>http://www.rainbowsoft.org/zblog/</url>
            <email>null@null.com</email>
    </author>
    <source>
            <name>zx.asd</name>
            <url>http://www.rainbowsoft.org/zblog/</url>
            <email>null@null.com</email>
    </source>
    <plugin>
            <name></name>
            <note></note>
            <type></type>
            <path></path>
            <include><![CDATA[]]></include>
            <level></level>
    </plugin>
    <version>1.0</version>
    <adapted>Z-Blog 1.8</adapted>
    <pubdate>2005-2-18</pubdate>
    <modified>2007-7-15</modified>
    <description><![CDATA[
    <p>Z-Blog的默认主题,论坛样式区的所有的样式均适合于该主题模板。</p>
    ]]></description>
    </theme>

节点说明

  1. theme, 表示此文档为主题信息, 其属性version表示此文档格式的版本号.
  2. id, 主题ID, 即存放该主题的目录名.
  3. name, 主题名称, 中英文均可.
  4. url, 发布主题的网页地址.
  5. note, 主题简介.
  6. author, 主题作者.
    1. name, 作者名称.
    2. url, 作者网址.
    3. email, 作者电邮.
  7. source, 主题原作者
    1. name, 原作者名称.
    2. url, 原作者网址.
    3. email, 原作者电邮.
  8. plugin, 主题自带插件. (注意,需要在主题目录中创建plugin目录,以下节点格式请参考插件开发文档)
    1. name, 插件名称.
    2. note, 插件简介.
    3. type, 插件类型 (如inline, outline).
    4. path, 插件首页文件 (如 main.asp).
    5. include, 插件包含文件(如 include.asp).
    6. level, 插件权限 ( “1” 为管理员, “2” 为高级用户, 以此类推…).
  9. version, 主题自身的版本号.
  10. adapted, 适用该主题的博客版本.
  11. pubdate, 主题的发布目期.
  12. modified, 主题的最后修改日期.
  13. description, 主题详细说明, 可用HTML, 但不必用换行标签

4.官方对主题的认证

1.8 的主题将实行官方认证, 只有通过认证的主题才可被官方资源站收录.

  1. 认证的原则是:用户无需修改代码即可正常应用该主题.
  2. 认证的具体要求:
    1. 主题所用全部文件位于同一主题目录下.
    2. 主题目录规范. 信息齐全(必须有ScreenShot.png和Theme.xml).
    3. 主题中需显示用户的博客名称等, 此类名称不应以图片替代.
    4. 应用的图片不能带有过强的个人色彩, 如专为个人设计的Banner等.
    5. 模板中不含有和主题作者相关的第三方代码, 如广告, 统计等.
1)
关于Include目录下文件的引用,请使用<#TEMPLATE_INCLUDE_XXX#>标签,XXX代表全大写的文件名且不要后缀.
2)
关于主题自带的插件, 请参考插件开发文档.
zblogasp/theme/std.txt · 最后更改: 2016/06/29 16:42 由 yszm