data/TWiki/WebAtomBase.txt,v
changeset 0 414e01d06fd5
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/data/TWiki/WebAtomBase.txt,v	Sat Jan 26 15:50:53 2008 +0100
     1.3 @@ -0,0 +1,151 @@
     1.4 +head	1.4;
     1.5 +access;
     1.6 +symbols;
     1.7 +locks; strict;
     1.8 +comment	@# @;
     1.9 +
    1.10 +
    1.11 +1.4
    1.12 +date	2008.01.22.03.21.30;	author TWikiContributor;	state Exp;
    1.13 +branches;
    1.14 +next	1.3;
    1.15 +
    1.16 +1.3
    1.17 +date	2007.01.16.04.11.58;	author TWikiContributor;	state Exp;
    1.18 +branches;
    1.19 +next	1.2;
    1.20 +
    1.21 +1.2
    1.22 +date	2006.04.01.05.55.24;	author TWikiContributor;	state Exp;
    1.23 +branches;
    1.24 +next	1.1;
    1.25 +
    1.26 +1.1
    1.27 +date	2006.02.01.12.01.20;	author TWikiContributor;	state Exp;
    1.28 +branches;
    1.29 +next	;
    1.30 +
    1.31 +
    1.32 +desc
    1.33 +@new-topic
    1.34 +@
    1.35 +
    1.36 +
    1.37 +1.4
    1.38 +log
    1.39 +@buildrelease
    1.40 +@
    1.41 +text
    1.42 +@%META:TOPICINFO{author="TWikiContributor" date="1163619832" format="1.0" version="4"}%
    1.43 +---+ ATOM News Feeds
    1.44 +
    1.45 +---++ Find out What's New
    1.46 +
    1.47 +There are several ways to find out what's new in each TWiki web:
    1.48 +   1. Visit WebChanges to see recent changes
    1.49 +   1. Subscribed in WebNotify get notified of recent changes by e-mail
    1.50 +   1. Use a news readers such as TWiki:Plugins/HeadlinesPlugin to display the recent changes
    1.51 +      * The source can be a RSS 1.0 feed (WebRss) or ATOM 1.0 feed (WebAtom)
    1.52 +      * Learn more on RSS at WebRssBase and TWiki:Codev/TWikiSyndication
    1.53 +      * Learn more on ATOM at TWiki:Codev/AtomSyndication
    1.54 +
    1.55 +---++ ATOM Feed Usage
    1.56 +
    1.57 +   * The URL for an RSS feed is =%SCRIPTURL{view}%/<web>/WebAtom=
    1.58 +   * For this <nop>%WEB% web it is %SCRIPTURL{view}%/%WEB%/WebAtom
    1.59 +   * 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.
    1.60 +
    1.61 +---++ ATOM Feed Internals
    1.62 +
    1.63 +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.
    1.64 +
    1.65 +The WebAtom topic in each web contains the following text:
    1.66 +
    1.67 +-----
    1.68 +<pre>
    1.69 +&lt;title>&lt;nop>%<nop>WIKITOOLNAME%'s &lt;nop>%<nop>INCLUDINGWEB% web&lt;/title>
    1.70 +&lt;subtitle>(the description of the web, plain text with no markup and no wikiwords). TWiki is an Enterprise Collaboration Platform.&lt;/subtitle>
    1.71 +%<nop>INCLUDE{"%<nop>SYSTEMWEB%.WebAtomBase"}% &lt;!--
    1.72 +   * Set <nop>SKIN = rss
    1.73 +--&gt;
    1.74 +</pre>
    1.75 +-----
    1.76 +
    1.77 +
    1.78 +Below part is included by each <nop>WebAtom topic:
    1.79 +
    1.80 +-----
    1.81 +<verbatim>
    1.82 +%STARTINCLUDE%<link rel="self" type="application/atom+xml" href="%SCRIPTURL{"view"}%/%INCLUDINGWEB%/%BASETOPIC%"/>
    1.83 +<id>%SCRIPTURL{"view"}%/%INCLUDINGWEB%</id>
    1.84 +<rights>%WEBRSSCOPYRIGHT%</rights>%CALC{$SET(c,0)}%
    1.85 +%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.86 +%STOPINCLUDE%
    1.87 +</verbatim>
    1.88 +-----
    1.89 +
    1.90 +__See also__: WebRssBase, TWiki:Codev/AtomSyndication 
    1.91 +
    1.92 +@
    1.93 +
    1.94 +
    1.95 +1.3
    1.96 +log
    1.97 +@buildrelease
    1.98 +@
    1.99 +text
   1.100 +@d1 1
   1.101 +a1 1
   1.102 +%META:TOPICINFO{author="TWikiContributor" date="1163619832" format="1.0" version="3"}%
   1.103 +d30 1
   1.104 +a30 1
   1.105 +%<nop>INCLUDE{"%<nop>TWIKIWEB%.WebAtomBase"}% &lt;!--
   1.106 +@
   1.107 +
   1.108 +
   1.109 +1.2
   1.110 +log
   1.111 +@buildrelease
   1.112 +@
   1.113 +text
   1.114 +@d1 1
   1.115 +a1 1
   1.116 +%META:TOPICINFO{author="TWikiContributor" date="1138082878" format="1.0" version="2"}%
   1.117 +d18 1
   1.118 +a18 1
   1.119 +   * 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.
   1.120 +d41 2
   1.121 +a42 2
   1.122 +%STARTINCLUDE%<link rel="self" type="application/atom+xml" href="%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%/%HOMETOPIC%"/>
   1.123 +<id>%SCRIPTURL%/view%SCRIPTSUFFIX%/%INCLUDINGWEB%</id>
   1.124 +d44 1
   1.125 +a44 1
   1.126 +%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.127 +@
   1.128 +
   1.129 +
   1.130 +1.1
   1.131 +log
   1.132 +@buildrelease
   1.133 +@
   1.134 +text
   1.135 +@d1 1
   1.136 +a1 1
   1.137 +%META:TOPICINFO{author="TWikiContributor" date="1138082878" format="1.0" version="1"}%
   1.138 +d7 6
   1.139 +a12 6
   1.140 +	1. Visit WebChanges to see recent changes
   1.141 +	1. Subscribed in WebNotify get notified of recent changes by e-mail
   1.142 +	1. Use a news readers such as TWiki:Plugins/HeadlinesPlugin to display the recent changes
   1.143 +		* The source can be a RSS 1.0 feed (WebRss) or ATOM 1.0 feed (WebAtom)
   1.144 +		* Learn more on RSS at WebRssBase and TWiki:Codev/TWikiSyndication
   1.145 +		* Learn more on ATOM at TWiki:Codev/AtomSyndication
   1.146 +d16 3
   1.147 +a18 3
   1.148 +	* The URL for an RSS feed is =%SCRIPTURL{view}%/&lt;web&gt;/WebAtom=
   1.149 +	* For this <nop>%WEB% web it is %SCRIPTURL{view}%/%WEB%/WebAtom
   1.150 +	* 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.
   1.151 +d31 1
   1.152 +a31 1
   1.153 +	* Set <nop>SKIN = rss
   1.154 +@