RSS - Feed 元素



Feed ID

它使用一個全球唯一且永久的 URI 來識別 Feed。如果您擁有網際網路域名長期可續簽的租賃權,則可以隨意使用您網站的地址。

語法

<id>https://tutorialspoint.tw/</id>

必需

必需。

Feed 標題

它包含 Feed 的人類可讀標題。通常與關聯網站的標題相同。此值不應為空。

語法

<title>Tutorials and Reference Manuals</title>

必需

必需。

Feed 更新日期

它指示 Feed 以重要方式修改的最後時間。Atom 中的所有時間戳都必須符合 RFC 3339。

語法

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

必需

必需。

Feed 作者

它命名 Feed 的一位作者。Feed 可能有多個作者元素。除非所有條目元素都包含至少一個作者元素,否則 Feed 必須包含至少一個作者元素。

作者元素可以包含<name>、<email> 和<uri> 標籤。

語法

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

必需

可選,但建議使用。

Feed 連結

這標識了一個相關的網頁。關係型別由rel 屬性定義。Feed 每個型別和hreflang 限於一個備用項。Feed 應包含指向 Feed 本身的連結。

語法

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

必需

可選,但建議使用。

Feed 類別

這指定了 Feed 屬於的類別。Feed 可能有多個類別元素。

語法

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

必需

可選。

Feed 貢獻者

這命名了 Feed 的一位貢獻者。Feed 可能有多個貢獻者元素。

語法

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

必需

可選。

Feed 生成器

這用於識別用於生成 Feed 的軟體,用於除錯和其他目的。uri 和 version 屬性都是可選的。

語法

<generator uri="/myblog.php" version="1.0">Example Toolkit</generator>

必需

可選。

icon 標籤

這標識了一個小影像,它為 Feed 提供了標誌性的視覺識別。圖示應為正方形。

語法

<icon>/icon.jpg</icon>

必需

可選。

logo 標籤

這標識了一個較大的影像,它為 Feed 提供了視覺識別。影像的寬度應為高度的兩倍。

語法

<logo>/logo.jpg</logo>

必需

可選。

rights 標籤

這傳達了有關 Feed 中和 Feed 上的權利(例如版權)的資訊。

語法

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

必需

可選。

subtitle 標籤

這包含 Feed 的人類可讀描述或副標題。

語法

<subtitle>A sub title </subtitle>

<entry> 元素

Atom Feed 可以包含一個或多個 entry 元素。以下是必需和可選的 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>完整故事在此</content>

必需

可選,但建議使用。

條目連結

這標識了一個相關的網頁。關係型別由rel 屬性定義。條目每個型別和hreflang 限於一個備用項。如果不存在 content 元素,則條目必須包含備用連結。

語法

<link rel="alternate" href="/blog/1234"/>

必需

可選,但建議使用。

條目摘要

這傳達了條目的簡短摘要、摘要或摘錄。如果未為條目提供內容,或者該內容不是內聯的,則應提供摘要。

語法

<summary>Some text.</summary>

必需

可選,但建議使用。

條目類別

這指定了條目屬於的類別。一個條目可能有多個類別元素。

語法

<category term="education"/>

必需

可選。

條目貢獻者

這命名了條目的一個貢獻者。一個條目可能有多個貢獻者元素。

語法

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

必需

可選。

Published 標籤

這包含條目的初始建立或首次可用時間。

語法

<published>2007-07-13T09:17:51-08:00</published>

必需

可選。

條目來源

如果一個條目從一個 Feed 複製到另一個 Feed,則如果源 Feed 包含任何作者、貢獻者、權利或類別子元素,並且這些子元素不存在於源條目中,則應保留源 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,在這種情況下,content 元素與其他文字結構的定義相同。

否則,如果src 屬性存在,則它表示可以找到內容的 URI。如果存在,則type 屬性是內容的媒體型別。

否則,如果type 屬性以+xml/xml 結尾,則此型別的 xml 文件將包含在內聯中。

否則,如果type 屬性以text 開頭,則此型別的轉義文件將包含在內聯中。

否則,包含一個base64 編碼的指定媒體型別的文件,包含在內聯中。

連結

<link> 以 html 的link 元素為原型。它具有一個必需屬性href 和五個可選屬性:reltypehreflangtitlelength

href 是引用的資源(通常是網頁)的 URI。

rel 包含單個連結關係型別。它可以是完整的 URI 或以下預定義值之一(預設=alternate

  • alternate:條目的備用表示形式或 Feed,例如指向條目 html 版本的永久連結,或網路日誌的首頁面。
  • 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>

Atom1.0 副檔名

Atom 1.0 文件不需要特定的副檔名。但建議使用 .xml。

what-is-atom.htm
廣告

© . All rights reserved.