这是本文档旧的修订版!
狼之樂園協作平台可以整合外部所提供的 RSS 訂閱清單。
將一個 RSS 或 ATOM 訂閱清單產生在 Dokuwiki 頁面是相當簡單的. 以下以訂閱 J.C.的小龍兄弟部落格 RSS 最新訊息語法當範例:
{{rss>http://tw.myblog.yahoo.com/dragon-bro/rss}}
Dokuwiki 是使用 SimplePie 的剖析 RSS 的工具函式. 只要 SimplePie 所支援的格式在 DokuWiki 內都能夠使用. 如果你希望增加額外的效果, 可以使用以下的參數定義, 多個參數定義時需要使用空白字元來區分:
參數 | 說明 |
---|---|
任何數字 | 限制清單項目顯示的數目. 當清單項目超出這個數字, 將只列出所指定的項目數, 預設是限制 8 個項目 |
reverse | 反向顯示. 將 RSS 內的最後一項顯示在清單最前面 |
author | 顯示項目的作者名稱 |
date | 顯示項目的日期 |
description | 顯示項目的說明描述. 如果設定不允許顯示 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 }}