- RSS 教程
- RSS - 首頁
- RSS - 什麼是RSS?
- RSS - 優點
- RSS - 版本歷史
- RSS - Feed 格式
- RSS - 閱讀 Feed
- RSS - Feed 釋出
- RSS - Feed 驗證
- RSS - 什麼是Atom?
- RSS - 擴充套件
- RSS - 總結
- RSS 有用參考
- RSS - 快速指南
- RSS - 有用資源
- RSS - 討論
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,以及兩個可選屬性 scheme 和 label。
term 標識類別。
scheme 透過 URI 標識分類方案。
label 提供用於顯示的人類可讀標籤。
內容
<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 版本的永久連結或 weblog 的首頁。
- enclosure:相關的資源,其大小可能很大,可能需要特殊處理,例如音訊或影片錄製。
- related:與條目或 Feed 相關的文件。
- self:Feed 本身。
- via:條目中提供的資訊來源。
type 指示資源的媒體型別。
hreflang 指示引用資源的語言。
title 指示關於連結的人類可讀資訊,通常用於顯示目的。
length 指示資源的長度(以位元組為單位)。
人員
<author> 和 <contributor> 描述一個人、公司或類似實體。它有一個必需元素 name,以及兩個可選元素:uri、email。
<name> 傳達人員的人類可讀名稱。
<uri> 包含該人的主頁。
<email> 包含該人的電子郵件地址。
文字
<title>、<summary>、<content> 和 <rights> 包含人類可讀文字,通常數量較少。type 屬性決定如何對這些資訊進行編碼(預設 =“text”)。
如果 type="text",則此元素包含沒有實體轉義 html 的純文字。
<title type="text">AT&T bought by SBC!</title>
如果 type="html",則此元素包含實體轉義 html。
<title type="html"> AT&amp;T bought <b>by SBC</b>! </title>
如果 type="xhtml",則此元素包含內聯 xhtml,包裝在一個 div 元素中。
<title type="xhtml">
<div xmlns="http://www.w3.org/1999/xhtml">
AT&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。