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


1.5
date	2008.12.06.09.02.16;	author TWikiContributor;	state Exp;
branches;
next	1.4;

1.4
date	2008.01.22.03.21.30;	author TWikiContributor;	state Exp;
branches;
next	1.3;

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.5
log
@buildrelease
@
text
@%META:TOPICINFO{author="TWikiContributor" date="1228163901" format="1.0" version="5"}%
---+ 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}%/&lt;web&gt;/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>
&lt;title>&lt;nop>%<nop>WIKITOOLNAME%'s &lt;nop>%<nop>INCLUDINGWEB% web&lt;/title>
&lt;subtitle>(the description of the web, plain text with no markup and no wikiwords). TWiki is an Enterprise Collaboration Platform.&lt;/subtitle>
%<nop>INCLUDE{"%<nop>SYSTEMWEB%.WebAtomBase"}% &lt;!--
   * Set <nop>SKIN = rss
--&gt;
</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" encode="quote" 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.4
log
@buildrelease
@
text
@d1 1
a1 1
%META:TOPICINFO{author="TWikiContributor" date="1163619832" format="1.0" version="4"}%
d44 1
a44 1
%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>"}%
@


1.3
log
@buildrelease
@
text
@d1 1
a1 1
%META:TOPICINFO{author="TWikiContributor" date="1163619832" format="1.0" version="3"}%
d30 1
a30 1
%<nop>INCLUDE{"%<nop>TWIKIWEB%.WebAtomBase"}% &lt;!--
@


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}%/&lt;web&gt;/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
@
