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.