head	1.6;
access;
symbols;
locks; strict;
comment	@# @;


1.6
date	2006.01.31.11.11.38;	author TWikiContributor;	state Exp;
branches;
next	1.5;

1.5
date	2004.08.15.22.25.40;	author PeterThoeny;	state Exp;
branches;
next	1.4;

1.4
date	2003.10.19.07.51.16;	author PeterThoeny;	state Exp;
branches;
next	1.3;

1.3
date	2003.09.03.05.39.02;	author PeterThoeny;	state Exp;
branches;
next	1.2;

1.2
date	2003.02.26.17.35.21;	author PeterThoeny;	state Exp;
branches;
next	1.1;

1.1
date	2003.01.30.08.11.06;	author PeterThoeny;	state Exp;
branches;
next	;


desc
@none
@


1.6
log
@buildrelease
@
text
@%META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="6"}%
---+ RSS News Feeds

---++ Find out What's New

There are several ways to find out what's new in each TWiki web:
	1. Visit WebChanges to see recent changes
	1. Subscribed in WebNotify get notified of recent changes by e-mail
	1. Use a news readers such as TWiki:Plugins/HeadlinesPlugin to display the recent changes
		* The source can be a RSS 1.0 feed (WebRss) or ATOM 1.0 feed (WebAtom)
		* Learn more on RSS at TWiki:Codev/TWikiSyndication
		* Learn more on ATOM at WebAtomBase and TWiki:Codev/AtomSyndication

---++ RSS Feed Usage

	* The URL for an RSS feed is =%SCRIPTURL{"view"}%/&lt;web&gt;/WebRss=
	* For this <nop>%WEB% web it is %SCRIPTURL{"view"}%/%WEB%/WebRss
	* You can also create a custom feed based on a search. Add a =search=value= parameter to the URL, e.g. %SCRIPTURL{"view"}%/%WEB%/WebRss?search=plugin is a what's new feed about Plugins.

---++ RSS Feed Internals

Each web has a WebRss topic which includes part of this <nop>%TOPIC% topic. This topic is the base for the RSS feed and generates an RSS 1.0 feed for TWiki:Codev/TWikiSyndication.

The WebRss topic in each web contains the following text:

-----
<pre>
&lt;channel rdf:about="%<nop>SCRIPTURL{"view"}%/%<nop>INCLUDINGWEB%">
  &lt;title>%<nop>WIKITOOLNAME%'s &lt;nop>%<nop>INCLUDINGWEB% web&lt;/title>
  &lt;link>%<nop>SCRIPTURL{"view"}%/%<nop>INCLUDINGWEB%&lt;/link>
  &lt;description>(the description of the web). TWiki is a Web-Based Collaboration Platform for the Enterprise.&lt;/description>
%<nop>INCLUDE{"%TWIKIWEB%.WebRssBase"}% &lt;!--
	* Set <nop>SKIN = rss
-->
</pre>
-----


Below part is included by each <nop>WebRss topic:


-----
<verbatim>
%STARTINCLUDE%<image rdf:resource="%WIKILOGOIMG%" />
  <dc:language>en-us</dc:language>
  <dc:rights>%WEBRSSCOPYRIGHT%</dc:rights>
  <dc:publisher>%WIKIWEBMASTERNAME% [%WIKIWEBMASTER%]</dc:publisher>
  <dc:creator>%WIKIWEBMASTERNAME% [%WIKIWEBMASTER%]</dc:creator>
  <dc:source>%WIKITOOLNAME%</dc:source>
  <items>
	 <rdf:Seq>
%SEARCH{"%URLPARAM{"search" default=".*" }%" web="%INCLUDINGWEB%" excludetopic="WebStatistics" regex="on" nosearch="on" order="modified" reverse="on" nototal="on" limit="16" format="		<rdf:li rdf:resource=\"%SCRIPTURL{"view"}%/$web/$topic\" />"}%
	 </rdf:Seq>
  </items>
</channel>
<image rdf:about="%WIKILOGOIMG%">
  <title>%WIKILOGOALT%.%INCLUDINGWEB%</title>
  <link>%SCRIPTURL{"view"}%/%INCLUDINGWEB%</link>
  <url>%WIKILOGOIMG%</url>
</image>
%SEARCH{"%URLPARAM{"search" default=".*" }%" web="%INCLUDINGWEB%" excludetopic="WebStatistics" regex="on" nosearch="on" order="modified" reverse="on" nototal="on" limit="16" format="<item rdf:about=\"%SCRIPTURL{"view"}%/$web/$topic\">$n  <title>$topic</title>$n  <link>%SCRIPTURL{"view"}%/$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"}%?topic=$wikiusername\">$n		<rdf:value>$username</rdf:value>$n	 </rdf:Description>$n  </dc:contributor>$n</item>"}%
%STOPINCLUDE%
</verbatim>
-----

__See also__: WebAtomBase, TWiki:Codev/RichSiteSummary, TWiki:Codev/TWikiSyndication 

@


1.5
log
@none
@
text
@d1 2
a2 2
%META:TOPICINFO{author="PeterThoeny" date="1092608740" format="1.0" version="1.5"}%
---++ How to Find out What's New?
d4 9
a12 4
There are three ways to find out what's new in each TWiki web:
	1. WebChanges shows recent changes
	1. People subscribed in WebNotify get notified of recent changes by e-mail
	1. 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
d16 3
a18 3
	* The URL for an RSS feed is =%SCRIPTURL%/view%SCRIPTSUFFIX%/&lt;web&gt;/WebRss?skin=rss=
	* For this <nop>%WEB% web it is %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/WebRss?skin=rss (or %SCRIPTURL%/view%SCRIPTSUFFIX%/Main/WebRss?skin=rss&contenttype=text/plain for plain text RSS)
	* You can also create a custom feed based on a search. Add a =search=value= parameter to the URL, e.g. %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/WebRss?skin=rss&search=plugin is a what's new feed about Plugins.
d27 9
a35 7
<verbatim>
<channel rdf:about="%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%">
  <title>%WIKITOOLNAME%'s %INCLUDINGWEB% web</title>
  <link>%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%</link>
  <description>(the description of the web). TWiki is a Web-Based Collaboration Platform for the Corporate World.</description>
%INCLUDE{"%TWIKIWEB%.WebRssBase"}%
</verbatim>
a49 5
  <wiki:interwiki>
	 <rdf:Description link="%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%/">
		<rdf:value>TWiki.%INCLUDINGWEB%</rdf:value>
	 </rdf:Description>
  </wiki:interwiki>
d52 1
a52 1
%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\" />"}%
d58 1
a58 1
  <link>%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%</link>
d61 1
a61 1
%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>"}%
d66 1
a66 3
__See also__: TWiki:Codev/RichSiteSummary, TWiki:Codev/TWikiSyndication 

-- TWiki:Main.PeterThoeny - 02 Sep 2003
@


1.4
log
@none
@
text
@d1 67
a67 64
%META:TOPICINFO{author="PeterThoeny" date="1066549876" format="1.0" version="1.4"}%
---++ How to Find out What's New?

There are three ways to find out what's new in each TWiki web:
	1. WebChanges shows recent changes
	1. People subscribed in WebNotify get notified of recent changes by e-mail
	1. 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

---++ RSS Feed Usage

	* The URL for an RSS feed is =%SCRIPTURL%/view%SCRIPTSUFFIX%/&lt;web&gt;/WebRss?skin=rss=
	* For this %WEB% web it is %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/WebRss?skin=rss (or %SCRIPTURL%/view%SCRIPTSUFFIX%/Main/WebRss?skin=rss&contenttype=text/plain for plain text RSS)
	* You can also create a custom feed based on a search. Add a =search=value= parameter to the URL, e.g. %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/WebRss?skin=rss&search=plugin is a what's new feed about Plugins.

---++ RSS Feed Internals

Each web has a WebRss topic which includes part of this <nop>%TOPIC% topic. This topic is the base for the RSS feed and generates an RSS 1.0 feed for TWiki:Codev/TWikiSyndication.

The WebRss topic in each web contains the following text:

-----
<verbatim>
<channel rdf:about="%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%">
  <title>%WIKITOOLNAME%'s %INCLUDINGWEB% web</title>
  <link>%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%</link>
  <description>(the description of the web). TWiki is a Web-Based Collaboration Platform for the Corporate World.</description>
%INCLUDE{"%TWIKIWEB%.WebRssBase"}%
</verbatim>
-----

Below part is included by each <nop>WebRss topic:

-----
<verbatim>
%STARTINCLUDE%  <image rdf:resource="%PUBURL%/%TWIKIWEB%/TWikiLogos/twikilogo88x31.gif" />
  <dc:language>en-us</dc:language>
  <dc:rights>Copyright %GMTIME{"$year"}%, Peter Thoeny and contributing authors.</dc:rights>
  <dc:publisher>Peter Thoeny [Peter@@Thoeny.com]</dc:publisher>
  <dc:creator>Peter Thoeny [Peter@@Thoeny.com]</dc:creator>
  <dc:source>TWiki</dc:source>
  <wiki:interwiki>
	 <rdf:Description link="%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%/">
		<rdf:value>TWiki.%INCLUDINGWEB%</rdf:value>
	 </rdf:Description>
  </wiki:interwiki>
  <items>
	 <rdf:Seq>
%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\" />"}%
	 </rdf:Seq>
  </items>
</channel>
<image rdf:about="%PUBURL%/%TWIKIWEB%/TWikiLogos/twikilogo88x31.gif">
  <title>TWiki.%INCLUDINGWEB%</title>
  <link>%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%</link>
  <url>%PUBURL%/%TWIKIWEB%/TWikiLogos/twikilogo88x31.gif</url>
</image>
%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</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>"}%
%STOPINCLUDE%
</verbatim>
-----

__See also__: TWiki:Codev/RichSiteSummary, TWiki:Codev/TWikiSyndication 

-- Main.PeterThoeny - 02 Sep 2003
@


1.3
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="PeterThoeny" date="1062567542" format="1.0" version="1.3"}%
d13 1
a13 1
	* You can also create a custom feed based on a search. Add a =search=value= parameter to the URL, e.g. %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/WebRss?skin=rss&search=plugin= is a what's new feed about Plugins.
d57 1
a57 1
%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</link>$n  <description>$summary</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>"}%
@


1.2
log
@none
@
text
@d1 2
a2 2
%META:TOPICINFO{author="PeterThoeny" date="1046280921" format="1.0" version="1.2"}%
---++ RSS Feed
d4 4
a7 1
This is the base for the RSS feed for each web. 
d9 11
a19 1
Each web has a WebRss that should contain the following text:
d29 1
d48 1
a48 1
%SEARCH{".*" web="%INCLUDINGWEB%" regex="on" nosearch="on" order="modified" reverse="on" nototal="on" limit="16" format="		<rdf:li rdf:resource=\"%SCRIPTURL%/view%SCRIPTSUFFIX%/$web/$topic\" />"}%
d57 1
a57 1
%SEARCH{".*" 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</link>$n  <description>$summary</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>"}%
d64 1
a64 1
-- Main.PeterThoeny - 30 Jan 2003
@


1.1
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="PeterThoeny" date="1043914266" format="1.0" version="1.1"}%
d21 1
a21 1
%STARTINCLUDE%  <image rdf:resource="%PUBURL%/twikilogo88x31.gif" />
d38 1
a38 1
<image rdf:about="%PUBURL%/twikilogo88x31.gif">
@
