RSS - Feed 元素



Feed ID

它使用一个全球唯一且永久的 URI 来识别 Feed。如果您拥有互联网域名长期可续签的租赁权,则可以随意使用您网站的地址。

语法

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

必需

必需。

Feed 标题

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

语法

<title>Tutorials and Reference Manuals</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>[email protected]</email>
   <uri>https://tutorialspoint.com/</uri>
</author>

必需

可选,但建议使用。

Feed 链接

这标识了一个相关的网页。关系类型由rel 属性定义。Feed 每个类型和hreflang 限于一个备用项。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 和 version 属性都是可选的。

语法

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

必需

可选。

icon 标签

这标识了一个小图像,它为 Feed 提供了标志性的视觉识别。图标应为正方形。

语法

<icon>/icon.jpg</icon>

必需

可选。

logo 标签

这标识了一个较大的图像,它为 Feed 提供了视觉识别。图像的宽度应为高度的两倍。

语法

<logo>/logo.jpg</logo>

必需

可选。

rights 标签

这传达了有关 Feed 中和 Feed 上的权利(例如版权)的信息。

语法

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

必需

可选。

subtitle 标签

这包含 Feed 的人类可读描述或副标题。

语法

<subtitle>A sub title </subtitle>

<entry> 元素

Atom Feed 可以包含一个或多个 entry 元素。以下是必需和可选的 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>完整故事在此</content>

必需

可选,但建议使用。

条目链接

这标识了一个相关的网页。关系类型由rel 属性定义。条目每个类型和hreflang 限于一个备用项。如果不存在 content 元素,则条目必须包含备用链接。

语法

<link rel="alternate" href="/blog/1234"/>

必需

可选,但建议使用。

条目摘要

这传达了条目的简短摘要、摘要或摘录。如果未为条目提供内容,或者该内容不是内联的,则应提供摘要。

语法

<summary>Some text.</summary>

必需

可选,但建议使用。

条目类别

这指定了条目属于的类别。一个条目可能有多个类别元素。

语法

<category term="education"/>

必需

可选。

条目贡献者

这命名了条目的一个贡献者。一个条目可能有多个贡献者元素。

语法

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

必需

可选。

Published 标签

这包含条目的初始创建或首次可用时间。

语法

<published>2007-07-13T09:17:51-08:00</published>

必需

可选。

条目来源

如果一个条目从一个 Feed 复制到另一个 Feed,则如果源 Feed 包含任何作者、贡献者、权利或类别子元素,并且这些子元素不存在于源条目中,则应保留源 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 和两个可选属性schemelabel

term 标识类别。

scheme 通过 URI 标识分类方案。

label 提供用于显示的人类可读标签。

内容

<content> 包含或链接到条目的完整内容。

在最常见的情况下,type 属性为texthtmlxhtml,在这种情况下,content 元素与其他文本结构的定义相同。

否则,如果src 属性存在,则它表示可以找到内容的 URI。如果存在,则type 属性是内容的媒体类型。

否则,如果type 属性以+xml/xml 结尾,则此类型的 xml 文档将包含在内联中。

否则,如果type 属性以text 开头,则此类型的转义文档将包含在内联中。

否则,包含一个base64 编码的指定媒体类型的文档,包含在内联中。

链接

<link> 以 html 的link 元素为原型。它具有一个必需属性href 和五个可选属性:reltypehreflangtitlelength

href 是引用的资源(通常是网页)的 URI。

rel 包含单个链接关系类型。它可以是完整的 URI 或以下预定义值之一(默认=alternate

  • alternate:条目的备用表示形式或 Feed,例如指向条目 html 版本的永久链接,或网络日志的首页面。
  • enclosure:相关资源,其大小可能很大,可能需要特殊处理,例如音频或视频录制。
  • related:与条目或 Feed 相关的文档。
  • self:Feed 本身。
  • via:条目中提供的信息来源。

type 指示资源的媒体类型。

hreflang 指示引用资源的语言。

title 指示有关链接的人类可读信息,通常用于显示目的。

length 指示资源的长度(以字节为单位)。

人员

<author><contributor> 描述一个人、公司或类似实体。它有一个必需元素name 和两个可选元素:uriemail

<name> 传达人员的人类可读名称。

<uri> 包含人员的主页。

<email> 包含人员的电子邮件地址。

文本

<title><summary><content><rights> 包含人类可读的文本,通常数量很少。type 属性决定了此信息是如何编码的(默认为“text”)。

如果type="text",则此元素包含纯文本,没有实体转义的 html。

<title type="text">AT&amp;T bought by SBC!</title>

如果type="html",则此元素包含实体转义的 html。

<title type="html">AT&amp;amp;T bought &lt;b&gt;by SBC&lt;/b&gt;!</title>

如果type="xhtml",则此元素包含内联 xhtml,包装在一个 div 元素中。

<title type="xhtml">
   <div xmlns="http://www.w3.org/1999/xhtml">
      AT&amp;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>[email protected]</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.htm
广告