version=pmwiki-2.2.17 ordered=1 urlencoded=1 agent=Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.2.3) Gecko/20100401 Firefox/3.6.3 (.NET CLR 3.5.30729) author= charset=ISO-8859-1 csum= host=122.163.0.230 name=PmWiki.RSS rev=47 targets=PmWiki.WebFeeds,PmWiki.Notify,PmWiki.WikiTrails,Site.AllRecentChanges,Cookbook.RssFeedDisplay,PmWiki.RSS text=(:Summary: Deprecated in favour of [[PmWiki/WebFeeds]]:)%0a-> %25note%25 This page is somewhat obsolete -- see [[WebFeeds]].%0a%0a!!What is a feed?%0a%0aA feed is the most convenient way to be notified when a site changes. Instead of checking [=RecentChanges=] every day to find out what's new, the site will send you an alert when it changes, which you can read in your news aggregator. (To receive alerts via email, you want [[Notify]].) If you want to find feeds on other websites, look for terms or icons like "XML", "RSS", "Atom", "Subscribe", "Syndicate", "Bloglines", "Updates", or "News". Feeds are still fairly new, so the terms aren't standardized yet. %0a%0aFeeds in PmWiki build on the [[WikiTrails]] idea. The page that is browsed with @@?action=rss@@ is treated as a `WikiTrail. In the RSS feed produced, the trail page is the channel, and each item on the trail is a news item. So, you can use any RecentChanges page, or [[Site.AllRecentChanges]] as source `WikiTrail for each group and the whole site. And so long as they can edit pages, visitors can have custom feeds without asking the administrator for help. All they have to do is create a page with a wiki trail of the pages that they want update notices for. %0a%0aMore technically, a feed is a document written in the XML language, and following a syndication format like RSS or Atom. It will list the last N changes (N being whatever number the feed's maker decided it should be), and will give headlines. If the feed's maker decided to, there might also be summaries of the new content, or even the full text of the changed page.%0a%0a!!How to read your PmWiki syndicated feeds%0a%0a# You'll need a [[news aggregator -> Wikipedia:List_of_news_aggregators]], which is a piece of software designed to read news feeds. Many different news aggregators are available. Some run on your own computer, either on their own or as plugins for email clients, web browsers, or newsreaders. Others are web applications that you can use from any internet-connected computer. Some are in between (technically web applications, but ones designed to run on your computer, not some remote server). Get one that you like.%0a# Subscribe to the [[WikiTrail(s)]] you desire. Your aggregator will need the feed's address. Tack @@?action=rss@@ onto the end of the URL you want to subscribe to. So, if you wanted to subscribe to pmwiki.org's [[Site/AllRecentChanges]], you'd take its address http://pmwiki.org/wiki/Site/AllRecentChanges, and add @@?action=rss@@ to that. The result, http://pmwiki.org/wiki/Site/AllRecentChanges?action=rss, is the feed address for your news aggregator.%0a%0a!!Set up feeds on your PmWiki site%0a%0aSetting up feeds in this instance means syndicating portions of your wiki, so others can read it as a RSS / RDF feed. This is NOT an example of reading feeds within your wiki such as trying to include a slashdot newsfeed into one of your wiki pages. To set up pmwiki so it can parse feeds, go to [[Cookbook:RssFeedDisplay]]%0a%0aPmWiki has the ability to output [[RSS(#huh)]] v1 or [[RSS(#huh)]] v2 documents by adding the line%0a%0a->[@include_once('scripts/feeds.php');@]%0a%0asomewhere in your ''local/config.php'' and supplying @@?action=rss@@ in the URL to a RSS aggregator (@@?action=rdf@@ will output RSS v1).%0a%0a[[#huh]]%0a!!What's the difference between RSS v1 and RSS v2?%0aGlad you asked! Back when the whole idea of RSS was invented it stood for RDF Site Summary where RDF stands for Resource Description Framework. Basically RDF was a way to describe meta-information about content using XML. The only problem with RSS back then was that it had very little to do with RDF (RDF headers were output, but the rest of the document was different XML than what RDF defined). So, anyway, this idea of RSS evolved for a time and gave birth to RSS v1.%0a%0aSometime later Dave Winer decided to redo the RSS spec and gave the acronym a new meaning -- Really Simple Syndication. Thus was born RSS v2 which was quite different from RSS v1 but still trying to accomplish the same goals.%0a%0a time=1277124183