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,以及两个可选属性 schemelabel

term 标识类别。

scheme 通过 URI 标识分类方案。

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

内容

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

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

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

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

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

否则,包含指示的媒体类型的 base64 编码文档。

链接

<link> 模仿 html 的 link 元素。它有一个必需属性 href,以及五个可选属性:reltypehreflangtitlelength

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

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

  • alternate:条目的备用表示或 Feed,例如指向条目 html 版本的永久链接或 weblog 的首页。
  • 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>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。

what-is-atom.htm
广告
© . All rights reserved.