TWiki/WebRssBase.mdwn

   1 ## <a name="How to Find out What&#39;s New?"></a> How to Find out What's New?
   2
   3 There are three ways to find out what's new in each TWiki web:
   4
   5 1. [[WebChanges]] shows recent changes
   6 2. People subscribed in [[WebNotify]] get notified of recent changes by e-mail
   7 3. A news feed can be exported in RSS 1.0 format for TWiki:Codev/TWikiSyndication. RSS news readers like TWiki:Plugins/HeadlinesPlugin can display the recent changes
   8
   9 ## <a name="RSS Feed Usage"></a> RSS Feed Usage
  10
  11 - The URL for an RSS feed is `http://www.dementia.org/twiki//view/<web>/WebRss?skin=rss`
  12 - For this %WEB% web it is <http://www.dementia.org/twiki//view/%WEB%/WebRss?skin=rss> (or [http://www.dementia.org/twiki//view/Main/WebRss?skin=rss&amp;contenttype=text/plain](http://www.dementia.org/twiki//view/Main/WebRss?skin=rss&contenttype=text/plain) for plain text RSS)
  13 - You can also create a custom feed based on a search. Add a `search=value` parameter to the URL, e.g. [http://www.dementia.org/twiki//view/%WEB%/WebRss?skin=rss&amp;search=plugin](http://www.dementia.org/twiki//view/%WEB%/WebRss?skin=rss&search=plugin) is a what's new feed about Plugins.
  14
  15 ## <a name="RSS Feed Internals"></a> RSS Feed Internals
  16
  17 Each web has a [[WebRss]] topic which includes part of this %TOPIC% topic. This topic is the base for the RSS feed and generates an RSS 1.0 feed for TWiki:Codev/TWikiSyndication.
  18
  19 The [[WebRss]] topic in each web contains the following text:
  20
  21 ----
  22
  23     <channel rdf:about="%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%">
  24       <title>%WIKITOOLNAME%'s %INCLUDINGWEB% web</title>
  25       <link>%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%</link>
  26       <description>(the description of the web). TWiki is a Web-Based Collaboration Platform for the Corporate World.</description>
  27     %INCLUDE{"%TWIKIWEB%.WebRssBase"}%
  28
  29 ----
  30
  31 Below part is included by each WebRss topic:
  32
  33 ----
  34
  35     %STARTINCLUDE%<image rdf:resource="%WIKILOGOIMG%" />
  36       <dc:language>en-us</dc:language>
  37       <dc:rights>%WEBRSSCOPYRIGHT%</dc:rights>
  38       <dc:publisher>%WIKIWEBMASTERNAME% [%WIKIWEBMASTER%]</dc:publisher>
  39       <dc:creator>%WIKIWEBMASTERNAME% [%WIKIWEBMASTER%]</dc:creator>
  40       <dc:source>%WIKITOOLNAME%</dc:source>
  41       <wiki:interwiki>
  42         <rdf:Description link="%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%/">
  43           <rdf:value>TWiki.%INCLUDINGWEB%</rdf:value>
  44         </rdf:Description>
  45       </wiki:interwiki>
  46       <items>
  47         <rdf:Seq>
  48     %SEARCH{"%URLPARAM{"search" default=".*" }%" web="%INCLUDINGWEB%" regex="on" nosearch="on" order="modified" reverse="on" nototal="on" limit="16" format="      <rdf:li rdf:resource=\"%SCRIPTURL%/view%SCRIPTSUFFIX%/$web/$topic\" />"}%
  49         </rdf:Seq>
  50       </items>
  51     </channel>
  52     <image rdf:about="%WIKILOGOIMG%">
  53       <title>%WIKILOGOALT%.%INCLUDINGWEB%</title>
  54       <link>%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%</link>
  55       <url>%WIKILOGOIMG%</url>
  56     </image>
  57     %SEARCH{"%URLPARAM{"search" default=".*" }%" web="%INCLUDINGWEB%" regex="on" nosearch="on" order="modified" reverse="on" nototal="on" limit="16" format="<item rdf:about=\"%SCRIPTURL%/view%SCRIPTSUFFIX%/$web/$topic\">$n  <title>$topic</title>$n  <link>%SCRIPTURL%/view%SCRIPTSUFFIX%/$web/$topic?t=$isodate</link>$n  <description>$summary (last changed by <nop>$wikiname)</description>$n  <dc:date>$isodate</dc:date>$n  <dc:contributor>$n    <rdf:Description link=\"%SCRIPTURL%/view%SCRIPTSUFFIX%?topic=$wikiusername\">$n      <rdf:value>$username</rdf:value>$n    </rdf:Description>$n  </dc:contributor>$n  <wiki:version>$rev</wiki:version>$n  <wiki:status>updated</wiki:status>$n  <wiki:importance>major</wiki:importance>$n  <wiki:diff>%SCRIPTURL%/rdiff%SCRIPTSUFFIX%/$web/$topic</wiki:diff>$n  <wiki:history>%SCRIPTURL%/rdiff%SCRIPTSUFFIX%/$web/$topic</wiki:history>$n</item>"}%
  58     %STOPINCLUDE%
  59
  60 ----
  61
  62 **_See also_**: TWiki:Codev/RichSiteSummary, TWiki:Codev/TWikiSyndication
  63
  64 -- TWiki:Main.PeterThoeny - 02 Sep 2003