RSS – 订阅元素

Feed ID

它使用一个普遍唯一且永久的URI标识Feed。如果您拥有长期且可更新的Internet域名，那么可以使用您网站的地址。

语法

<id>http://tutorialspoint.com/</id>

必需的

必需的。

Feed标题

它包含一个可读的Feed标题。通常与相关网站的标题相同。此值不应为空。

语法

<title>教程和参考手册</title>

必需的

必需的。

Feed更新日期

它指示上次显著修改Feed的时间。Atom中的所有时间戳必须符合RFC 3339。

语法

<updated>2007-07-13T18:30:02Z</updated>

必需的

必需的。

Feed作者

它命名Feed的一个作者。一个Feed可能包含多个作者元素。除非所有入口元素都至少包含一个作者元素，否则Feed必须包含至少一个作者元素。

作者元素可以有“name”，“email”和“uri”标签。

语法

<author>
   <name>Mohtashim</name>
   <email>mohtashim@tutorialspoi.com</email>
   <uri>http://tutorialspoint.com/</uri>
</author>

必需的

可选，但建议使用。

Feed链接

这个标识了一个相关的网页。关系类型由rel属性定义。Feed每种类型和hrelang限于一个替代。一个Feed应包含一个回到Feed本身的链接。

语法

<link>rel="self" href="/feed"</link>

必需的

可选，但建议使用。

Feed类别

这个指定Feed所属的类别。一个Feed可能有多个类别元素。

语法

<category>category term="sports"</category>

必需的

可选。

Feed贡献者

这个名字指Feed的一个贡献者。一个Feed可能有多个贡献者元素。

语法

<contributor>
   <name>Mohtashim</name>
</contributor>

必需的

可选。

Feed生成器

这个标识用于生成Feed的软件，用于调试和其他目的。URI和版本属性都是可选的。

语法

<generator uri="/myblog.php" version="1.0">Example Toolkit</generator>

必需的

可选。

Icon标签

这个标识一个小图像，为Feed提供象征性的视觉识别。图标应该是正方形的。

语法

<icon>/icon.jpg</icon>

必需的

可选。

Logo标签

这个标识一个更大的图像，为Feed提供视觉识别。图像的宽度应该是高度的两倍。

语法

<logo>/logo.jpg</logo>

必需的

可选。

许可标签

这个传达有关Feed中所持有和持有的版权等权利的信息。

语法

<rights> © 2007 TutorialsPoint.com </rights>

必需的

可选。

副标题标签

这个包含一个可读的Feed描述或副标题。

语法

<subtitle>A sub title </subtitle>

`<entry>`元素

Atom Feed可能包含一个或多个条目元素。以下是所需和可选的Feed元素列表。

Entry ID

这个使用一个普遍唯一且永久的URI标识入口。如果它们表示不同时间点的同一条目，则一个Feed中的两个条目可以具有相同的id值。

语法

<id>http://example.com/blog/1234</id>

必需的

必需的。

Entry标题

这个包含入口的可读标题。此值不应为空。

语法

<title>Atom 1.0教程</title>

必需的

必需的。

Entry更新日期

这个指示上次显著修改输入的时间。只有在修正错误之后，值才不需要更改，只有在实质性修改之后才需要更改。通常，Feed中的不同条目将具有不同的更新时间戳。

语法

<updated>2007-07-13T18:30:02-05:00</updated>

必需的

必需的。

Entry作者

这个命名输入的一个作者。一个输入可能有多个作者。一个条目必须包含至少一个作者元素，除非封闭Feed中存在作者元素，或封闭源元素中存在作者元素。

语法

<author>
   <name>Mohtashim</name>
</author>

必需的

可选。

常见结构

类别

_ <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 的其他表示形式，例如，条目的永久链接或博客的主页。
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 示例文章

该示例显示了如何使用 Atom 1.0 编写文章。

<?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>