- RSS 教程
- RSS - 首页
- RSS - 什么是RSS?
- RSS - 优点
- RSS - 版本历史
- RSS - Feed 格式
- RSS - 阅读 Feed
- RSS - Feed 发布
- RSS - Feed 验证
- RSS - 什么是Atom?
- RSS - 扩展
- RSS - 总结
- RSS 有用参考
- RSS - 快速指南
- RSS - 有用资源
- RSS - 讨论
RSS - 条目元素
Atom Feed 可以包含一个或多个条目元素。以下是必需和可选的 Feed 元素列表。
条目 ID
这使用一个普遍唯一且永久的 URI 来标识条目。如果两个条目代表不同时间点的同一条目,则 Feed 中的两个条目可以具有相同的 id 值。
语法
<id>http://example.com/blog/1234</id>
必需
必需。
条目标题
这包含条目的可读标题。此值不应为空。
语法
<title>Atom 1.0 Tutorial</title>
必需
必需。
条目更新日期
这表示条目上次以重要方式修改的时间。更正错别字后,此值不需要更改,只有在进行重大修改后才需要更改。通常,Feed 中的不同条目将具有不同的更新时间戳。
语法
<updated>2007-07-13T18:30:02-05:00</updated>
必需
必需。
条目作者
这命名条目的一个作者。一个条目可以有多个作者。除非封闭的 Feed 中有作者元素,或者封闭的 source 元素中有作者元素,否则条目必须至少包含一个作者元素。
语法
<author> <name>Mohtashim</name> </author>
必需
可选,但推荐。
条目内容
这包含或链接到条目的完整内容。如果没有备用链接,则必须提供内容;如果没有摘要,也应提供内容。
语法
<content>complete story here</content>
必需
可选,但推荐。
条目链接
这标识相关的网页。关系类型由rel属性定义。每个类型和hreflang,一个条目最多只能有一个备用链接。如果没有内容元素,则条目必须包含备用链接。
语法
<link rel="alternate" href="/blog/1234"/>
必需
可选,但推荐。
条目摘要
这传达条目的简短摘要、梗概或摘录。如果未为条目提供内容,或者该内容不是内联的,则应提供摘要。
语法
<summary>Some text.</summary>
必需
可选,但推荐。
条目类别
这指定条目所属的类别。一个条目可以有多个类别元素。
语法
<category term="education"/>
必需
可选。
条目贡献者
这命名条目的一个贡献者。一个条目可以有多个贡献者元素。
语法
<contributor> <name>Mohtashim</name> </contributor>
必需
可选。
发布标签
这包含条目的初始创建或首次可用时间。
语法
<published>2007-07-13T09:17:51-08:00</published>
必需
可选。
条目来源
如果从一个 Feed 复制条目到另一个 Feed,则如果源 Feed 包含任何 author、contributor、rights 或 category 子元素并且这些子元素不存在于源条目中,则应保留源 Feed 的元数据(Feed 的所有子元素,除了条目元素)。
语法
<source> <id>http://moretutorials.org/</id> <title>Tutorials and Reference Manuals</title> <updated>2007-07-13T18:30:02Z</updated> <rights>© 2007 More Tutorials.</rights> </source>
必需
可选。
条目权利
这传达有关条目中和关于条目的权利(例如版权)的信息。
语法
<rights type="html">© 2007 TutorialsPoint.com</rights>
必需
可选。
常用结构
类别
<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 是引用的资源(通常是网页)的 URI。
rel 包含单个链接关系类型。它可以是完整的 URI 或以下预定义值之一(默认 = alternate)
- alternate:条目的备用表示或 Feed,例如指向条目 html 版本的永久链接或 weblog 的首页。
- 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&amp;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 示例 Feed
此示例显示如何使用 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。