RSS – 入口元素
Atom Feed可能包含一个或多个条目元素。以下是必需和可选的Feed元素列表。
条目ID
这使用通用唯一永久URI标识条目。如果两个Feed中的条目代表不同时间的同一条目,则两个条目的id可能具有相同的值。
语法
<id>http://example.com/blog/1234</id>
必需
必需。
条目标题
这包含条目的可读标题。此值不能为空。
语法
<title>Atom 1.0教程</title>
必需
必需。
条目更新日期
这指示条目最后一次以重大方式被修改的时间。修正打字错误后,该值不需要更改,只有在进行实质性修改后才需要更改。通常,Feed中的不同条目将具有不同的更新时间戳。
语法
<updated>2007-07-13T18:30:02-05:00</updated>
必需
必需。
条目作者
这命名条目的一个作者。一个条目可以有多个作者。除非在封闭的Feed中有作者元素,否则条目必须包含至少一个作者元素,或者在封闭的源元素中有作者元素。
语法
<author>
<name>Mohtashim</name>
</author>
必需
可选,但建议。
条目内容
这包含或链接到条目的完整内容。如果没有备用链接,则必须提供内容,并应在没有摘要的情况下提供。
语法
<content>在此处完整内容</content>
必需
可选,但建议。
条目链接
这标识相关的Web页面。关系类型由rel属性定义。一个条目限于一个类型和_hreflang的备用。如果没有内容元素,则条目必须包含备用链接。
语法
<link rel="alternate" href="/blog/1234"/>
必需
可选,但建议。
条目摘要
这传达条目的简短摘要、摘要或摘录。如果未为条目提供内容或该内容不在行内,则应提供摘要。
语法
<summary>一些文本。</summary>
必需
可选,但建议。
条目类别
这指定条目所属的类别。一个条目可以有多个类别元素。
语法
<category term="教育"/>
必需
可选。
条目贡献者
这命名条目的一个贡献者。一个条目可以有多个贡献者元素。
语法
<contributor>
<name>Mohtashim</name>
</contributor>
必需
可选。
发布标签
此包含条目的初始创建时间或第一次可用时间。
语法
<published>2007-07-13T09:17:51-08:00</published>
必需
可选。
条目源
如果将条目从一个Feed复制到另一个Feed,则应在源Feed中保留源Feed的元数据(Feed其他子元素除条目元素之外的所有元素),如果源Feed包含任何子元素作者、贡献者、权利或类别,并且这些子元素不存在于源条目中。
语法:
<source>
<id>http://moretutorials.org/</id>
<title>教程和参考手册</title>
<updated>2007-07-13T18:30:02Z</updated>
<rights>©2007参考手册。
</source>
必需
可选。
条目权利
这传达有关在条目中或在条目上拥有的权利,例如版权。
语法
<rights type="html">© 2007 TutorialsPoint.com</rights>
必需
可选。
公共结构
类别
<category>
有一个必需属性term
,有两个可选属性scheme
,label
。
term
标识类别。
scheme
通过URI标识分类方案。
label
为展示提供人类可读标签。
内容
<content>
包含或链接到条目的完整内容。
在最常见的情况下,type属性为text,html,xhtml之一,这时的内容元素与其他文本结构定义相同。
否则,如果present属性为src,则其代表内容的URI。如果存在,_type属性为内容的媒体类型。
否则,如果type属性以+_ xml_或/ xml结尾,则包含此类型的xml文档。
否则,如果type属性以text开头,则在行内包含此类型的已转义文档。
否则,包含已编码为指定媒体类型的[base64](http://www.faqs.org/rfcs/rfc3548.html)。
链接
<link>
跟随html的[link](http://www.w3.org/TR/1999/REC-html401-19991224/struct/links.html#h-12.3)元素设计。它有一个必需属性href,和五个可选属性:rel
,type
,hreflang
,title
和length
。
href是所引用资源(通常为Web页面)的URI。
rel包含单个链接关系类型。它可以是完整的URI或以下预定义值之一(默认=alternate):
- alternate:条目或Feed的其他表示形式,例如指向条目的html版本的永久链接,或博客的主页。
- enclosure:相关资源,可能的大小很大,可能需要特殊处理,例如音频或视频录制。
- related:与条目或Feed相关的文档。
- self:Feed本身。
- via:提供条目信息的源。
type指示资源的媒体类型。
hreflang表示所引用资源的语言。
title指示与链接相关的人类可读信息,通常用于显示目的。
length表示资源的长度(以字节为单位)。
个人
<author>
和<contributor>
描述了一个人、公司或类似实体。它有一个必填元素实名
,和两个可选元素:uri,电子邮件
。
<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” ,那么此元素包含嵌套在 div 元素中的行内 xhtml。
<title type="xhtml">
<div xmlns="http://www.w3.org/1999/xhtml">
AT&T被<b>SBC</b>收购!
</div>
</title>
Atom 1.0 示例 Feed
该示例演示如何使用 Atom 1.0 编写 Feed。
<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
<title>示例 Feed</title>
<subtitle>在这里插入有趣或深刻的评论</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>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>一些文本。</summary>
</entry>
</feed>
Atom 1.0 文件扩展名
不需要为 Atom 1.0 文档指定特定的文件扩展名。但推荐使用 .xml。