差分

このページの2つのバージョン間の差分を表示します。

この比較画面へのリンク

dokuwiki:ja:syndication [2006/11/11] – 作成 administratordokuwiki:ja:syndication [2022/03/12] (現在) – 外部編集 127.0.0.1
行 1: 行 1:
 +====== 記事配信 ======
 +
 +[[DokuWiki]] makes some of its data available as XML feed through the [[this>feed.php]] file.
 +
 +===== Parameters =====
 +
 +How the feed is generated can be influenced through various URL parameters.
 +
 +^ Parameter ^ Valid values ^ Default ^ Description ^
 +| type | rss, rss1, rss2, atom | rss1 | This is the Document-Type the feed is using |
 +| mode | recent, list | recent | What should be exported? The recent changes or a list of documents |
 +| num  | //any integer// | [[config#recent]] option | How many items should be included (ignored in list mode)|
 +| ns   | //a [[namespace]]// | * | which namespace should be exported |
 +| linkto | page, rev, diff | diff | where should the itemlink point to | 
 +
 +===== Examples =====
 +
 +  * [[this>feed.php?type=rss2&num=5]] returns a [[http://backend.userland.com/rss|RSS 2.0]] feed of the 5 most recent changes
 +  * [[this>feed.php?mode=list&type=atom&linkto=page&ns=wiki]] list all pages in the wiki namespace as an [[http://intertwingly.net/wiki/pie/FrontPage|ATOM 0.3]] feed with all items linking to the page directly
 +
 +
 +===== Username/Password =====
 +
 +When enabling [[ACL]] and restricted pages to be viewed unless user is authorized, remember that one must pass to the RSS Reader the arguments of username and password, like this: %%''http://example.com/dokuwiki/feed.php?u=username&p=password''%% If not, then the RSS Reader will be unable to show any recent changes or list the documents that belong to a restricted namespace, due to those viewing restrictions.
 +
 +===== Feedcreator =====
 +
 +The XML Syndication feature was implemented by using the excellent [[http://www.bitfolge.de/rsscreator-en.html|Feed Creator Class]] by Kai Blankenhorn.