W3C Widget 配置与打包（2）Widget 配置

look_w

Widget 配置         创建一个 Widget，首先要创建一个以 Widget 名称命名的目录，如：myWidget。        （在允许使用带点文件名的操作系统上，可以使用 myWidget.wgt。）        我们将会把新的 Widget 文件放到这个目录中。如果想要创建和测试新的 HTML、CSS 和 JavaScript 文件，        我们可以把这个目录创建在 Web 服务器的文档根目录下，这样我们就可以在打包 Widget 前通过浏览器查看 HTML 文件。
        每一个 Widget 包必须有一个名为 config.xml （大小写敏感）的配置文件，它就位于我们刚创建的空目录下，        这个目录就是包的根目录。这个配置文件包含了关于 Widget 的重要信息，如：名称、作者、描述、许可证等等。
中显示的是一个配置文件例子。
        清单 3. 一个示例 config.xml 文件

1 2 3 4 5 6 7 8 9 10 11 12

<?xml version="1.0" encoding="UTF-8"?> <widget xmlns="http://www.w3.org/ns/widgets" id="http://www.example.com/widgets/HelloWidget" version="0.1" width="300" height="200">   <name>HelloWidget</name>   <description>A very basic widget that says, "Hello"</description>   <content src="index.html" />   <icon src="images/icon.png" />   <access network="false" />   <author>Nathan A. Good</author>   <license>This is my license</license> </widget>

        这个 XML 文件必须采用 UTF-8 编码，如例子所示。
        Widget 父元素有详细说明 Widget 信息的属性，如  所示。
表 1. Widget 父元素的属性 属性名描述id惟一 URI，它是 Widget 的标识 versionWidget 的版本号 width, height分别以像素值表示 Widget 的宽和高 viewmodesWidget 的查看模式 （见 ）
        配置中的 XML 元素如  所示。
表 2. Widget 配置元素 元素名描述name        Widget 的缩写名是在属性 short 指定的，        而全名在 XML 元素的文本中指定。descriptionWidget 的描述信息authorWidget 的作者信息licenseWidget 的许可证icon图标文件的相对路径
        在创建一个简单的配置文件后，我们就可以创建开始文件了。