348 lines
16 KiB
Plaintext
348 lines
16 KiB
Plaintext
head 1.7;
|
|
access;
|
|
symbols;
|
|
locks; strict;
|
|
comment @# @;
|
|
|
|
|
|
1.7
|
|
date 2006.04.01.05.55.25; author TWikiContributor; state Exp;
|
|
branches;
|
|
next 1.6;
|
|
|
|
1.6
|
|
date 2006.02.01.12.01.21; 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.7
|
|
log
|
|
@buildrelease
|
|
@
|
|
text
|
|
@%META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="7"}%
|
|
---+ 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"}%/<web>/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>
|
|
<channel rdf:about="%<nop>SCRIPTURL{"view"}%/%<nop>INCLUDINGWEB%">
|
|
<title>%<nop>WIKITOOLNAME%'s <nop>%<nop>INCLUDINGWEB% web</title>
|
|
<link>%<nop>SCRIPTURL{"view"}%/%<nop>INCLUDINGWEB%</link>
|
|
<description>(the description of the web). TWiki is a Web-Based Collaboration Platform for the Enterprise.</description>
|
|
%<nop>INCLUDE{"%TWIKIWEB%.WebRssBase"}% <!--
|
|
* 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>The contributing authors of %WIKITOOLNAME%</dc:creator>
|
|
<dc:source>%WIKITOOLNAME%</dc:source>
|
|
<items>
|
|
<rdf:Seq>
|
|
%SEARCH{"%URLPARAM{"search" default=".*" }%" web="%URLPARAM{"web" default="%INCLUDINGWEB%" }%" excludetopic="%URLPARAM{"excludetopic" default="WebStatistics" }%" type="%URLPARAM{"type" default="regex" }%" nosearch="on" order="modified" reverse="on" nototal="on" limit="%URLPARAM{"limit" default="16" }%" scope="%URLPARAM{"scope" default="text" }%" casesensitive="%URLPARAM{"casesensitive" default="on" }%" date="%URLPARAM{"date" default="" }%" 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="%URLPARAM{"web" default="%INCLUDINGWEB%" }%" excludetopic="%URLPARAM{"excludetopic" default="WebStatistics" }%" type="%URLPARAM{"type" default="regex" }%" nosearch="on" order="modified" reverse="on" nototal="on" limit="%URLPARAM{"limit" default="16" }%" scope="%URLPARAM{"scope" default="text" }%" casesensitive="%URLPARAM{"casesensitive" default="on" }%" date="%URLPARAM{"date" default="" }%" format="<item rdf:about=\"%SCRIPTURL{"view"}%/$web/$topic\">$n <title>$topic</title>$n <link>%SCRIPTURL{"view"}%/$web/$topic</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.6
|
|
log
|
|
@buildrelease
|
|
@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="6"}%
|
|
d7 6
|
|
a12 6
|
|
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
|
|
d16 3
|
|
a18 3
|
|
* The URL for an RSS feed is =%SCRIPTURL{"view"}%/<web>/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.
|
|
d33 1
|
|
a33 1
|
|
* Set <nop>SKIN = rss
|
|
d48 1
|
|
a48 1
|
|
<dc:creator>%WIKIWEBMASTERNAME% [%WIKIWEBMASTER%]</dc:creator>
|
|
d51 3
|
|
a53 3
|
|
<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>
|
|
d61 1
|
|
a61 1
|
|
%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>"}%
|
|
@
|
|
|
|
|
|
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%/<web>/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%/<web>/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">
|
|
@
|