HTML CSS JAVASCRIPT PYTHON PYTHON2 JAVA C C++ C# SQL Excel Linux AI BOOTSTRAP PHP 教程库 参考手册 技术文章 测验 练习 HOWTO FAQ
❮ 上一节 下一节 ❯

RSS - Feed 元素

Feed ID:

它使用通用唯一且永久的 URI 来标识 Feed。如果您的 Internet 域名有长期可续租的租约，那么您可以随意使用您的网站地址。

语法

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

必需

Feed title

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

语法

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

必填

Feed updated

表示上次对 Feed 进行重大修改的时间。Atom 中的所有时间戳都必须符合 RFC 3339。

语法

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

必填

Feed Author

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

author 元素可以包含 <name>、<email> 和 <uri> 标签。

语法

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

必需

可选，但建议使用。

Feed link

这标识相关网页。关系类型由 rel 属性定义。每个 Feed 类型和 hreflang 只能有一个替代项。Feed 应包含指向 Feed 本身的链接。

语法

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

必需

可选，但建议使用。

Feed category

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

语法

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

必需

可选。

Feed contributor

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

语法

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

必需

可选。

Feed generator

这标识了用于生成 Feed 的软件，用于调试和其他目的。uri 和 version 属性都是可选的。

语法

<generator uri="/myblog.php" version="1.0">示例工具包</generator>

必需

可选。

icon icon

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

语法

<icon>/icon.jpg</icon>

必需

可选。

logo 标签

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

语法

<logo>/logo.jpg</logo>

必需

可选。

rights 标签

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

语法

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

必需

可选。

subtitle 标签

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

语法

<subtitle>副标题 </subtitle>

<entry> 元素

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

条目 ID

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

语法

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

必填

title 条目标题

这包含条目的可读标题。此值不应为空。

语法

<title>Atom 1.0 教程</title>

必填

updated 条目更新日期

这表示上次对条目进行重大修改的时间。此值在拼写错误修复后无需更改，仅在进行重大修改后才需要更改。通常，Feed 中的不同条目将具有不同的更新时间戳。

语法

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

必填

author 条目作者

这指定条目的一位作者。一个条目可能有多个作者。除非封闭的 Feed 中有作者元素，或者封闭的源元素中有作者元素，否则条目必须包含至少一个作者元素。

语法

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

必需

可选，但建议使用。

content 条目内容

包含或链接到条目的完整内容。如果没有备用链接，则必须提供内容;如果没有摘要，则应提供内容。

语法

<content>完整故事在此</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 条目权限

这传达了有关条目中持有的权利(例如版权)的信息。

语法

<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> 仿照 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> 包含此人的电子邮件地址。

文本

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

Atom1.0 文件扩展名:

Atom 1.0 文档不需要特定的文件扩展名。但建议使用 .xml。

what-is-atom.html

❮ 上一节 下一节 ❯