====== RSS/ATOM 訂閱彙整清單 ======

{{http://wolfbbs.net/imagehost/uploads2/590e960779.png?50X50}}
**狼之樂園協作平台**可以整合外部所提供的 RSS 訂閱清單。

===== 語法 =====

將一個 RSS 或 ATOM 訂閱清單產生在 Dokuwiki 頁面是相當簡單的. 以下以訂閱 J.C.的小龍兄弟部落格 RSS 最新訊息語法當範例:

  {{rss>http://tw.myblog.yahoo.com/dragon-bro/rss}}

{{rss>http://tw.myblog.yahoo.com/dragon-bro/rss}}

Dokuwiki 是使用 [[http://simplepie.org/|SimplePie]] 的剖析 RSS 的工具函式. 只要 SimplePie 所支援的格式在 DokuWiki 內都能夠使用. 如果你希望增加額外的效果, 可以使用以下的參數定義, 多個參數定義時需要使用空白字元來區分:

^ 參數  ^ 說明 ^
| 任何數字    | 限制清單項目顯示的數目. 當清單項目超出這個數字, 將只列出所指定的項目數, 預設是限制 8 個項目|
| reverse    | 反向顯示. 將 RSS 內的最後一項顯示在清單最前面 |
| author     | 顯示項目的作者名稱 |
| date       | 顯示項目的日期 |
| description| 顯示項目的說明描述. 如果設定不允許顯示 [[config:htmlok|HTML]] 所有的 HTML 語法將不會被顯示出來 |
| //n//[dhm] | 指定自動更新的時間, d=天, h=小時, m=分鐘. (例如 12h = 12 小時). |

自動更新的時間預設是 4 小時. 如果指定的時間值小於 10 分鐘還是會被視為 10 分鐘. DokuWiki 一般都會提供一個快取的頁面, 在這理有動態的外部內容顯然是不太合適. 這個參數是當頁面從上次產生後已經超過 //自動更新的時間// 就通知 DokuWiki 重新產生頁面.

如下是指定顯示 5 個項目以及要出現作者與時間, 每小時自動更新一次 的範例語法:

  {{rss>http://tw.myblog.yahoo.com/dragon-bro/rss 5 author date 1h }}