RSS - Entry 条目元素
Atom Feed 可能包含一个或多个条目元素。以下是必需和可选的 Feed 元素的列表。
条目 ID
这使用通用唯一且永久的 URI 来标识条目。如果 Feed 中的两个条目在不同时间点代表同一个条目，则它们可以具有相同的 id 值。
语法
<id>http://example.com/blog/1234</id>
必需
必需。
条目标题
这包含条目的人类可读标题。此值不应为空。
语法
<title>Atom 1.0 Tutorial</title>
必填
updated 条目更新日期
这表示条目上次被重大修改的时间。此值在拼写错误修复后无需更改，仅在进行重大修改后才需要更改。通常，Feed 中的不同条目将具有不同的更新时间戳。
语法
<updated>2007-07-13T18:30:02-05:00</updated>
必需
name 条目作者
这指定了条目的一位作者。一个条目可能有多个作者。除非封闭的 Feed 中有作者元素，或者封闭的源元素中有作者元素，否则条目必须包含至少一个作者元素。
语法
<author> <name>Mohtashim</name> </author>
必需
可选，但建议使用。
content 条目内容
这包含或链接到条目的完整内容。如果没有替代链接，则必须提供内容，如果没有摘要，则应提供内容。
语法
<content>complete story here</content>
必需
可选，但建议使用。
link 条目链接
这标识相关网页。关系类型由 rel 属性定义。每个条目每个类型和 hreflang 限制为一个替代项。如果没有内容元素，条目必须包含替代链接。
语法
<link rel="alternate" href="/blog/1234"/>
必需
可选，但建议使用。
summary 条目摘要
这传达了条目的简短摘要、摘要或摘录。如果条目没有提供内容，或者内容不是内联的，则应提供摘要。
语法
<summary>Some text.</summary>
必需
可选，但建议使用。
category 条目类别
这指定了条目所属的类别。一个条目可能有多个类别元素。
语法
<category term="education"/>
必需
可选。
contributor 条目贡献者
这指定了条目的一位贡献者。一个条目可能有多个贡献者元素。
语法
<contributor> <name>Mohtashim</name> </contributor>
必需
可选。
published 已发布标签
这包含条目的首次创建时间或首次可用时间。
语法
<published>2007-07-13T09:17:51-08:00</published>
必需
可选。
source 条目来源
如果将条目从一个 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
<category> 有一个必需属性 term 和两个可选属性 scheme 和 label。
term 标识类别。
scheme 通过 URI 标识分类方案。
label 提供可读的标签以供显示。
content
<content> 包含或链接到条目的完整内容。
在最常见的情况下，type 属性是 text， html、xhtml，在这种情况下，内容元素的定义与其他文本构造相同。
否则，如果存在 src 属性，则它表示可以找到内容的 URI。如果存在 type 属性，则该属性是内容的媒体类型。
否则，如果 type 属性以 +xml 或 /xml 结尾，则此类型的 xml 文档以内联形式包含。
否则，如果 type 属性以 text 开头，则此类型的转义文档以内联形式包含。
否则，指示媒体类型的 base64 编码文档以内联形式包含。
link
<link> 仿照 html 的 link 元素。它有一个必需属性 href，以及五个可选属性:rel、type、hreflang、title 和 length。
href 是引用资源(通常是网页)的 URI。
rel 包含单个链接关系类型。它可以是完整的 URI 或以下预定义值之一(默认值 = alternate):
- alternate:条目或 Feed 的替代表示，例如，指向条目 html 版本或网络日志首页的永久链接。
- enclosure:相关资源，可能很大，可能需要特殊处理，例如音频或视频录制。
- related:与条目或 Feed 相关的文档。
- self:Feed 本身。
- via:条目中提供的信息的来源。
type 表示资源的媒体类型。
hreflang 表示引用资源的语言。
title 表示有关链接的人性化信息，通常用于显示目的。
length 表示资源的长度(以字节为单位)。
Person
<author> 和 <contributor> 描述个人、公司或类似实体。它有一个必需元素 name，以及两个可选元素:uri、email。
<name> 传达此人可读的姓名。
<uri> 包含此人的主页。
<email> 包含此人的电子邮件地址。
Text
<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>
Atom1.0 文件扩展名
Atom 1.0 文档不需要特定的文件扩展名。但建议使用 .xml。
what-is-atom.html
