常见构造

category

<category> 有一个必需属性 term,以及两个可选属性 schemelabel

term 标识类别。

scheme 通过 URI 标识分类方案。

label 提供可读的显示标签。

content

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

在最常见的情况下,type 属性为 texthtmlxhtml,在这种情况下,内容元素的定义相同到其他文本构造,这些构造在此处描述。

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

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

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

否则,指示媒体类型的 base64 编码文档以内联形式包含。

Link

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

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

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

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

type 表示资源的媒体类型。

hreflang 表示引用的语言资源。

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

length 表示资源的长度,以字节为单位。

Person

<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 的完整规范 RFC4287

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