133 lines
4.8 KiB
Plaintext
133 lines
4.8 KiB
Plaintext
head 1.3;
|
|
access;
|
|
symbols;
|
|
locks; strict;
|
|
comment @# @;
|
|
|
|
|
|
1.3
|
|
date 2007.01.16.04.11.58; author TWikiContributor; state Exp;
|
|
branches;
|
|
next 1.2;
|
|
|
|
1.2
|
|
date 2006.04.01.05.55.24; author TWikiContributor; state Exp;
|
|
branches;
|
|
next 1.1;
|
|
|
|
1.1
|
|
date 2006.02.01.12.01.20; author TWikiContributor; state Exp;
|
|
branches;
|
|
next ;
|
|
|
|
|
|
desc
|
|
@new-topic
|
|
@
|
|
|
|
|
|
1.3
|
|
log
|
|
@buildrelease
|
|
@
|
|
text
|
|
@%META:TOPICINFO{author="TWikiContributor" date="1163619832" format="1.0" version="3"}%
|
|
---+ ATOM 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 WebRssBase and TWiki:Codev/TWikiSyndication
|
|
* Learn more on ATOM at TWiki:Codev/AtomSyndication
|
|
|
|
---++ ATOM Feed Usage
|
|
|
|
* The URL for an RSS feed is =%SCRIPTURL{view}%/<web>/WebAtom=
|
|
* For this <nop>%WEB% web it is %SCRIPTURL{view}%/%WEB%/WebAtom
|
|
* You can also create a custom feed based on a search. Add a =search=value= parameter to the URL, e.g. %SCRIPTURL{"view"}%/%WEB%/WebAtom?search=plugin is a what's new feed about Plugins.
|
|
|
|
---++ ATOM Feed Internals
|
|
|
|
Each web has a WebAtom topic which includes part of this <nop>%TOPIC% topic. This topic is the base for the ATOM feed and generates an WebAtom 1.0 feed for TWiki:Codev/AtomSyndication.
|
|
|
|
The WebAtom topic in each web contains the following text:
|
|
|
|
-----
|
|
<pre>
|
|
<title><nop>%<nop>WIKITOOLNAME%'s <nop>%<nop>INCLUDINGWEB% web</title>
|
|
<subtitle>(the description of the web, plain text with no markup and no wikiwords). TWiki is an Enterprise Collaboration Platform.</subtitle>
|
|
%<nop>INCLUDE{"%<nop>TWIKIWEB%.WebAtomBase"}% <!--
|
|
* Set <nop>SKIN = rss
|
|
-->
|
|
</pre>
|
|
-----
|
|
|
|
|
|
Below part is included by each <nop>WebAtom topic:
|
|
|
|
-----
|
|
<verbatim>
|
|
%STARTINCLUDE%<link rel="self" type="application/atom+xml" href="%SCRIPTURL{"view"}%/%INCLUDINGWEB%/%BASETOPIC%"/>
|
|
<id>%SCRIPTURL{"view"}%/%INCLUDINGWEB%</id>
|
|
<rights>%WEBRSSCOPYRIGHT%</rights>%CALC{$SET(c,0)}%
|
|
%SEARCH{"%URLPARAM{"search" default=".*" }%" web="%INCLUDINGWEB%" type="regex" nosearch="on" order="modified" reverse="on" nototal="on" limit="16" format="$percntCALC{$IF($GET(c)>0, , <updated>$isodate</updated>$CHAR(10))$SETM(c, +1)}$percnt<entry>$n <title>$topic</title>$n <link rel=\"alternate\" type=\"text/html\" href=\"%SCRIPTURL{"view"}%/$web/$topic?t=$isodate\"/>$n <id>%SCRIPTURL{"view"}%/$web/$topic</id>$n <updated>$isodate</updated>$n <summary>$summary (last changed by <nop>$wikiname)</summary>$n <author>$n <name><nop>$wikiname</name></author>$n</entry>"}%
|
|
%STOPINCLUDE%
|
|
</verbatim>
|
|
-----
|
|
|
|
__See also__: WebRssBase, TWiki:Codev/AtomSyndication
|
|
|
|
@
|
|
|
|
|
|
1.2
|
|
log
|
|
@buildrelease
|
|
@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="TWikiContributor" date="1138082878" format="1.0" version="2"}%
|
|
d18 1
|
|
a18 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%/WebAtom?search=plugin is a what's new feed about Plugins.
|
|
d41 2
|
|
a42 2
|
|
%STARTINCLUDE%<link rel="self" type="application/atom+xml" href="%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%/%HOMETOPIC%"/>
|
|
<id>%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%</id>
|
|
d44 1
|
|
a44 1
|
|
%SEARCH{"%URLPARAM{"search" default=".*" }%" web="%INCLUDINGWEB%" regex="on" nosearch="on" order="modified" reverse="on" nototal="on" limit="16" format="$percntCALC{$IF($GET(c)>0, , <updated>$isodate</updated>$CHAR(10))$SETM(c, +1)}$percnt<entry>$n <title>$topic</title>$n <link rel=\"alternate\" type=\"text/html\" href=\"%SCRIPTURL%/view%SCRIPTSUFFIX%/$web/$topic?t=$isodate\"/>$n <id>%SCRIPTURL%/view%SCRIPTSUFFIX%/$web/$topic</id>$n <updated>$isodate</updated>$n <summary>$summary (last changed by <nop>$wikiname)</summary>$n <author>$n <name><nop>$wikiname</name></author>$n</entry>"}%
|
|
@
|
|
|
|
|
|
1.1
|
|
log
|
|
@buildrelease
|
|
@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="TWikiContributor" date="1138082878" format="1.0" version="1"}%
|
|
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 WebRssBase and TWiki:Codev/TWikiSyndication
|
|
* Learn more on ATOM at TWiki:Codev/AtomSyndication
|
|
d16 3
|
|
a18 3
|
|
* The URL for an RSS feed is =%SCRIPTURL{view}%/<web>/WebAtom=
|
|
* For this <nop>%WEB% web it is %SCRIPTURL{view}%/%WEB%/WebAtom
|
|
* 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%/WebAtom?search=plugin is a what's new feed about Plugins.
|
|
d31 1
|
|
a31 1
|
|
* Set <nop>SKIN = rss
|
|
@
|