====== 記事配信 ======

[[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.