主题目录结构, XML信息规范与官方认证办法
主题目录结构, XML信息规范与官方认证办法 (草拟):
I.主题发布的必备条件:
[indent]1.主题名称的英文ID, 与其它现有主题不重名.
2.主题信息文件, Theme.xml, 内含主题发布信息.
3.主题截图文件, ScreenShot.png, 300*240像索, 横向.[/indent]
II.主题发布的目录结构与所需文件说明:
[indent]1.主题目录, 名称为主题的英文ID, 位于Z-Blog之THEMES目录下. 此目录中有如下文件或文件夹 (2~9).
2.文件: Theme.xml, 主题信息. (必须)
3.文件: ScreenShot.png, 主题截图.. (必须)
4.目录: Template, 模板目录, 内存模板文件.①. (必须)
5.目录: Style, 样式目录, 内存样式表及所需图片. (必须)
6.目录: Include, 包含文件目录, 相当于Z-Blog之Include目录的主题专用版②. (可选)
7.目录: Plugin, 此目录下装有主题所包含的插件③. (可选)
8.目录: Script, 主题自行加入的JS代码④. (可选)
9.目录: Source, 主题服务器脚本等, 但不属于Plugin的部分.(可选)[/indent]
III.主题信息文档Theme.xml格式规范与节点说明.⑤
[indent]样例文档[code] <?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>[/code][/indent]
[indent]1.theme, 表示此文档为主题信息, 其属性version表示此文档格式的版本号.(必须)
2.id, 主题ID, 即存放该主题的目录名.(必须)
3.name, 主题名称, 中英文均可.(必须)
4.url, 发布主题的网页地址.
5.note, 主题简介.
6.author, 主题作者.[/indent](必须)
[indent][indent]i.name, 作者名称.(必须)
ii.url, 作者网址.(必须)
iii.email, 作者电邮.(必须)[/indent][/indent]
[indent]7.source, 主题原作者.[/indent]
[indent][indent]i.name, 原作者名称.
ii.url, 原作者网址.
iii.email, 原作者电邮.[/indent][/indent]
[indent]8.plugin, 主题自带插件.[/indent]
[indent][indent]i.name, 插件名称.
ii.note, 插件简介.
iii.type, 插件类型 (如inline, outline).
iv.path, 插件首页文件 (如 main.asp).
v.include, 插件包含文件, CDATA! (如 <!-- #include file="totoro/c_totoro.asp" -->).
vi.level, 插件权限 ( "1" 为管理员, "2" 为高级用户, 以此类推...).[/indent][/indent]
[indent]9.version, 主题自身的版本号.(必须)
10.adapted, 适用该主题的博客版本.(必须)
11.pubdate, 主题的发布目期.(必须)
12.modified, 主题的最后修改日期.
13.discription, 主题详细说明, 可用HTML, 但不必用换行标签, CDATA!.[/indent]
IV.官方对主题的认证.
[indent]1.1.8 的主题将实行官方认证, 只有通过认证的主题才可从官方服务器下载.
2.认证的总体标准为用户无需修改代码即可正常应用该主题.
3.认证的具体内容:[/indent]
[indent][indent]i.主题全部文件位于该主题目录下.
ii.主题目录规范. 信息齐全(必须有ScreenShot.png和Theme.xml).
iii.主题中需显示用户的博客名称等, 此类名称不应以图片替代.
iv.应用的图片不能带有过强的个人色彩, 如专为个人设计的Banner等.
v.模板中不含有和主题作者相关的第三方代码, 如广告, 统计等.
vi.... ...
V....[/indent][/indent]
备注:
[indent]①.关于模板的使用, 请见月木的教程.
②.关于Include目录, zx.asd会有说明.
③.关于主题自带的插件, zx.asd会有说明.
④.主题所应用的JS文件将不再被允许放到SCRIPT目录下, 也不再允许安装主题时修改 common.js文件, 因为这一目录的存在将完全保证功能和独立性的需要.
⑤.ThemeSapper (TS) 插件提供了Theme.xml文档的编辑器, 不太了解XML的用户可以通过此编辑器生成标准的主题信息文档. TS同时还提供了与在线安装包版本匹配的打包器. 以备需求.
其它有待补充...[/indent]
对应wiki链接：[url]http://wiki.rainbowsoft.org/doku.php?id=themes:std[/url]
