XML文件(在线版)
XML文件的作用是告诉
COOZINE关于电子杂志、电子图书页面的基本信息,例如JPG图片文件存放的服务器地址、服务器目录、页面数和页面尺寸等,详细参数说明如下。示例XML文件
点击下载。
XML示例代码
baseurl
存放JPG图片文件的服务器基本URL地址,例如:baseurl="http://res.xbooksky.com/",请注意后面必须加"/"。
[必须]
subpath
服务器子目录,是JPG图片文件的存放位置,例如文件的绝对地址是 http://res.xbooksky.com/ZINE/MYZINE/ 下面,地址中的 ZINE/MYZINE 即为子目录,即:subpath="ZINE/MYZINE",请注意前后不要有“/”。
[必须]
filehead
JPG图片文件的文件名“前缀”,例如JPG图片文件:缩图 MYBOOK001M.jpg、MYBOOK002M.jpg 至 MYBOOK099M.jpg、MYBOOK100M.jpg,大图 MYBOOK001B.jpg、MYBOOK002B.jpg 至 MYBOOK099B.jpg、MYBOOK100B.jpg,这些 JPG 文件中的“MYBOOK”即为“前缀”,即:filehead="MYBOOK",请注意“.jpg”必须为小写。
[必须]
gopage
gopage的作用是指定打开电子杂志、电子图书时自动翻页到的页面,例如:gopage="8",打开时自动翻页到第8页。
[COOZINE 1.8][非必须]
pageoffset
pageoffset的作用是指示电子杂志、电子图书中页码中的“第 1 页”的页码是从哪一页开始,即页码的偏移数,它同时应用在页码显示情况,如果不设置此值,则不显示页码,例如:pageoffset="2"。
[非必须]
page1和page2
page1是页面开始数,page2是页面结束数,例如JPG图片文件 BOOK001M.jpg 至 BOOK80M.jpg 和 BOOK001B.jpg 至 BOOK80B.jpg,即 “page1”为 “1”,“page2”为“80”,即:page1="1" page2="80";而如果 JPG 文件是 BOOK028M.jpg 至 BOOK268M.jpg 和 BOOK028B.jpg 至 BOOK268B.jpg,即 “page1”为 “28”,“page2”为“268”,即:page1="28" page2="268"。
[必须]
width1和height1
指定缩图的宽和高的尺寸,以象素为单位,例如:width1="500" height1="600"。
[必须]
width2和height2
指定大图的宽和高的尺寸,以象素为单位,例如:width2="960" height2="1152"。
[必须]
注:在COOZINE 1.1 版本中,width1和width2以及heigh1和height2之间的比例必须为1:3,在
COOZINE 1.8 版本中,这个比例将不限于1:3,可以按实际需要灵活调整。
背景音乐:mp3url 和 mp3playonload
mp3url 用来指定背景音乐的完整 MP3 文件的完整URL,例如:mp3url="http://res.xbooksky.com/ZINE/MYZINE/Homeland.mp3"; mp3playonload 指定当打开电子杂志或电子图书时即自动播放背景音乐,例如:mp3playonload="1" 为自动播放,mp3playonload="0" 不自动播放。
[非必须]
背景图:bgimg 和 bgalpha
bgimg 用来指定背景图片的完整 JPG 文件的URL,例如:bgimg="http://res.xbooksky.com/ZINE/MYZINE/my_bg1.jpg"; bgalpha 是用来指定背景图片的透明度,数值从 0 到 100,例如:bgalpha="96" 为设置背景图的透明度为 96,如果设置为 0 即为完全透明,100 是完全不透明。
[非必须]
封面标题:title
例如:title="我的开心杂志"。
[COOZINE 1.8][必须]
目录XML:catalogxml
例如:catalogxml="http://res.xbooksky.com/ZINE/MYZINE/my_catalog.xml"。如果电子杂志、电子图书没有添加目录,则不需要设定该值。目录XML详细说明,请阅读
“目录XML”。
[COOZINE 1.8][非必须]
是否在电子杂志、电子图书初次装载后立即显示目录:showcatalogfirst
例如:showcatalogfirst="1"为显示,showcatalogfirst="0"为不显示。
[COOZINE 1.8][非必须]
首页左图:firstleftimage
首页左图是指与封面相邻的图片。例如:firstleftimage="http://res.xbooksky.com/ZINE/IKEA2009/left_img1.jpg"。
[COOZINE 1.8][非必须]
是否开启翻页声:flippagesound
flippagesound="1"为开启,flippagesound="0"则不开启,默认为不开启翻页声音。
[COOZINE 1.8][非必须]
是否在初次装载后自动调整中页尺寸:autoadjust
autoadjust="1"为是,autoadjust="0"为否,默认为否。
[COOZINE 1.8][非必须]
跨域:crossdomain
对于JPG图片文件存放于不同服务器的情况,只要指定 crossdomain="1",COOZINE 即可实现跨域服务器访问。
[非必须]
跨域的情况是当电子杂志、电子图书数量较大的情况,需要将它们的内容,即JPG图片文件放在不同的内容服务器,以实现多服务器负载,这种情况就会涉及多个域名,需要实现跨域访问。
实现:例如内容服务器群 m1.yourdomain.com、m2.yourdomain.com和m3.yourdomain.com,现在 coozine.swf 放在 www.yourdomain.com 下,而JPG图片文件放在不同的服务器,例如分为电子杂志服务器和电子图书服务器,则只要在这些服务器根目录中分别放入 crossdomain.xml 文件,并在之前提到的 XML 内容中指定 crossdomain="1" 即可。
下载
crossdomain.xml
[必须]
[必须]是指在XML内容中不可缺少的。baseurl、subpath、filehead、page1、page2、width1和height1、width2和height2、title 等为必须项。
[非必须]
[非必须]是指在XML内容中根据实际需要设置。gopage、pageoffset、mp3url、mp3playonload、bgimg、bgalpha、crossdomain、catalogxml、showcatalogfirst、firstleftimage、flippagesound和autoadjust 等为可选项,根据需要决定是否设置。
[COOZINE 1.8]表示在
COOZINE 1.8 或以上版本才有的功能。
注:XML文件编码必须为UTF-8,否则中文会出现乱码。
XML文件转换为UTF-8编码可以使用"记事本"程序,打开"记事本",菜单:文件->另存为->编码选择UTF-8
XML内容的动态化
XML内容可以使用ASP、PHP或JSP等动态服务器脚本来代替,只要输出内容格式符合以上的规范要求即可。
帮助首页