常见结构
类别
<category>
有一个必需属性 term 和两个可选属性 scheme 和 label。
term 标识类别。
scheme 通过 URI 标识分类方案。
label 提供用于显示的可读性标签。
内容
<content>
包含或链接到条目的完整内容。
在最常见的情况下,type 属性为 text,html,xhtml,此时内容元素与其他文本结构的定义相同,在这里进行描述。
否则,如果存在 src 属性,则它表示可以找到内容的 URI。 type 属性(如果存在)是内容的媒体类型。
否则,如果 type 属性以 +xml 类结尾或 /xml,则包含此类型的 XML 文档。
否则,如果 type 属性以 text 开头,则包含此类型的转义文档。
否则,包含以指定的媒体类型编码的 base64 文档。
链接
<link>
是根据 HTML 的 link 元素制定的。它有一个必需属性 href 和五个可选属性:rel、 type、hreflang、title 和 length。
href 是所引用资源(通常是 Web 页面)的 URI。
rel 包含单个链接关系类型。 它可以是完整的 URI,也可以是以下预定义值之一(默认值为 alternate ):
- alternate – 条目或Feed的其他表示形式,例如条目的永久链接, 或博客网站的首页。
- enclosure – 相关资源,大小可能很大,可能需要特殊处理,例如音频或视频记录。
- related – 条目或Feed相关的文档。
- self – 自身Feed。
- via – 条目中所提供的信息来源。
type 指示资源的媒体类型。
hreflang 指示引用资源的语言。
title 指示链接的人类可读信息,通常用于显示目的。
length 指示资源的长度(以字节为单位)。
个人
<author>
和 <contributor>
描述人员、公司或类似实体。它有一个必需元素 name 和两个可选元素:uri,email。
<name>
提供人员的可读姓名。
<uri>
包含人员的主页。
<email>
包含人员的电子邮件地址。
文本
<title>
, <summary>
, <content>
和 <rights>
包含人类可读的文本,通常是少量的。 type 属性决定了如何编码这些信息(默认值为 “text”)。
如果 type=”text” ,那么该元素包含文本,没有被 HTML 转义。
<title type="text">AT&T bought by SBC!</title>
如果 type=”html” ,那么该元素包含已被转义的 HTML。
<title type="html">
AT&T bought <b>by SBC</b>!
</title>
如果 type=”xhtml” ,那么该元素包含内联 XHTML,包装在一个 div 元素中。
<title type="xhtml">
<div xmlns="http://www.w3.org/1999/xhtml">
AT&T bought <b>by SBC</b>!
</div>
</title>
查看 Atom 1.0 完整规范 RFC4287 。
Atom 1.0 示例源
示例展示了如何使用 Atom 1.0 编写 Feed。
<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
<title>Example Feed</title>
<subtitle>Insert witty or insightful remark here</subtitle>
<link href="http://example.org/"/>
<updated>2003-12-13T18:30:02Z</updated>
<author>
<name>Mohtashim</name>
<email>mohtashim@example.com</email>
</author>
<id>urn:uuid:60a76c80-d399-11d9-b93C-0003939e0af6</id>
<entry>
<title>Tutorial on Atom</title>
<link href="http://example.org/2003/12/13/atom03"/>
<id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id>
<updated>2003-12-13T18:30:02Z</updated>
<summary>Some text.</summary>
</entry>
</feed>
Atom 1.0 文件扩展
不需要为 Atom 1.0 文档指定特定的文件扩展名。但推荐使用 .xml。