Web-Feeds

für die Liste aller Seiten

Was ist ein Feed?

Ein Feed ist die bequemste Möglichkeit zu erfahren, wenn sich eine Webseite verändert. Anstatt also jeden Tag die Seite Aktuelle Änderungen zu überprüfen, um herauszufinden was sich geändert hat, wird man bei jeder Änderung benachrichtigt. Diese Benachrichtigung kann man dann im RSS-fähigen Programm auslesen. (Um Benachrichtigungen per E-Mail zu erhalten, sollte man sich E-Mail Nachricht bei geänderten Seiten / E-Mail Nachricht bei geänderten Seiten (neu) ansehen.) Wenn man solche Feeds von anderen Webseiten bekommen möchte, sollte man nach folgenden Begriffen Ausschau halten: "XML", "RSS", "Atom", "Subscribe", "Syndicate", "Bloglines", "Updates" oder "News". Sie sind auch die Grundlage für Podcasting.

in der einfachsten Form basieren Feeds in PmWiki auf Seitenabfolge. Benutzen Sie eine Feed-Aktion wie ?action=rss oder action=atom auf einem Trail, wird ein Web-Feed erzeugt (oft "channel" genannt), wo jede in dem Trail vorkommende Seite ein Item in dem Feed ist. Aktuelle Änderungen- oder Alle aktuellen Änderungen-Seiten sind definitiv Trails, somit können Sie jede Aktuelle Änderungen- oder Alle aktuellen Änderungen-Seite aus jeder Gruppe und des gesamten Webauftritts als Quelle für den RSS-Feed verwenden. Fügen Sie einfach ?action=rss an den URL einer Aktuelle Änderungen-Seite an. Wenn Sie zum Beispiel einen Feed für pmwiki.org erhalten wollen, benutzen Sie

Und solange Besucher Seiten bearbeiten können, können Sie auch angepasste Feeds haben, ohne den Administartor um Hilfe bitten zu müssen. Alles was sie tun müssen ist eine Referenzseite der Seitenabfolgen zu erzeugen, die die Seiten enthält, über deren Änderungen sie benachrichtigt werden möchten. Feeds können auch von Gruppen, Kategorien und Rückverweisen erzeugt werden und die Reihenfolge und Anzahl der Items können durch Optionen in dem URL verändert werden. So könnten Sie einen Feed für die Skins-Kategory (sortiert mit den wichtigsten zuerst) abfordern, in dem Sie dies benutzen:

PmWiki ist in der Lage, Feeds in vielen Formaten zu liefern, einschließlich RSS 2.0 (?action=rss), Atom 1.0 (?action=atom) und RSS 1.0 (?action=rdf). Zusätzlich, obwohl es normalerweise nicht als Web-Feed angesehen wird, kann PmWiki Metadateninformationen erzeugen, indem die 'Dublin Core Metadata extensions' benutzt werden (?action=dc).
Technisch gesprochen ist ein Feed ein XML Dokument, das einem zusammenfassenden Format wie RSS oder Atom folgt. Es listet die letzten N Änderungen auf (wobei die Zahl N vom Anbieter des Feeds festgelegt wird) und gibt deren Überschriften zurück. Wenn der Feed-Anbieter es so eingestellt hat, können auch Zusammenfassungen des Inhalts oder sogar der komplette Text der Änderung angezeigt werden.

Wie liest man PmWiki-Feeds

1. Man braucht einen RSS-Reader. Das ist ein Stück Software, mit dem man Feeds lesen kann. Es gibt viele verschiedene RSS-Reader. Manche laufen eigenständig auf dem Computer, andere sind Zusatzprogramme für E-Mail-Programme, Webbrowser oder Newsreader. Wieder andere sind Web-Applikationen, die von jedem mit dem Internet verbundenen Computer aus genutzt werden können. Manche liegen auch irgendwo dazwischen (technisch gesehen Web-Applikationen, allerdings so entwickelt,dass sie auf dem eigenen Rechner laufen). Holen Sie sich den, der Ihnen gefällt.
2. Abonnieren Sie die gewünschte Seitenabfolge, indem Sie den Feeder mit dem URL versorgen. Hängen Sie ?action=rss an das Ende der Internetadresse an, die Sie abonnieren möchten. Wenn Sie also die Seite Site.AllRecentChanges von pmwiki.org abonnieren möchte, tun Sie das mit der Adresse http://pmwiki.org/wiki/Site/AllRecentChanges?action=rss im RSS-Reader.

Feed-Optionen

Fügen Sie beliebige der folgenden Optionen an das Ende des PmWiki-Web-Feed-URLs, um dessen Ausgabe zu ändern (im Grunde genommen ist jede pagelist-Option? für Web-Feeds einzusetzen):

?count=n

Limit feed to n items (default 10)

?order=-time

Display most recently changed items first (default: the order of the trail, or by name; in RecentChanges pages the trail is already ordered by -time)

?trail=page

Obtain items from trail on page (default: the trail on the current page)

?group=group

Limit feed to pages in group

?name=name

Limit feed to pages with specific name

?link=page

Create feed from pages linked to page

?list=normal

Exclude things like RecentChanges, AllRecentChanges, etc.

Autoren (Fortgeschrittene)

PmWiki für Feeds konfigurieren

Dieser Abschnitt beschreibt, wie Sie Teile eines Wikis aufbereiten, um es in einem Web-Feed zu präsentieren. Es wird nicht beschrieben, wie Sie ein Web-Feed in einer Wiki-Seite darstellen – siehe dazu Cookbook:RssFeedDisplay.

Um eine Web-Feed-Erzeugung für eine Site zu ermöglichen, fügen Sie eine oder mehrere der folgenden Zeilen zu einer Ihrer Lokale Anpassungen-Dateien (z. B. local/config.php-Datei) hinzu:

if ($action == 'rss') include_once("$FarmD/scripts/feeds.php");
if ($action == 'atom') include_once("$FarmD/scripts/feeds.php");
if ($action == 'rdf') include_once("$FarmD/scripts/feeds.php");
if ($action == 'dc') include_once("$FarmD/scripts/feeds.php");

Oder Sie kombinieren mehrere Feeds in einem einzigen Ausdruck , wobei Sie "||" benutzen, um die Feed-Typen voneinander zu trennen. Z. B., wenn Sie RSS- und Atom-Feeds aktivieren wollen, schreiben Sie:

if ($action == 'rss'  ||
    $action == 'atom' ||
    $action == 'rdf'  ||
    $action == 'dc') include_once("$FarmD/scripts/feeds.php");

Feed-Inhalt konfigurieren

Web-Feeds sind im höchsten Grade konfigurierbar, neue Elemente können leicht zu Feeds über das $FeedFmt-Array hinzugefügt werden. Elemente in $FeedFmt sehen so aus:

Dabei korrespondiert der erste Index mit der Aktion (?action=atom), der zweite Index indiziert ein Per-Feed- oder Per-Item-Element und der dritte Index ist der Name des erzeugten Elements. Die obige Einstellung erzeugt demnach ein ""<rights>All Rights Reserved</rights>" in dem Feed für ?action=atom.

Wenn der Wert eines Eintrags mit einem '<' beginnt, wird feed.php nicht automatisch ein Tag darumherum hinzufügen. Elemente können auch aufrufbare Funktionen (callable functions) sein, welche aufgerufen werden, um die passenden Ausgabe zu erzeugen. Siehe RSS specification oder andere Feed-Spezifikationen wegen des möglichen Inhalts der Elemente.

Sie können auch einen existierenden Eintrag ändern anstatt einen neuen zu erzeugen. Benutzen Sie die folgenden Zeilen, um sicherzustellen, dass Änderungen am Wiki von einigen RSS-REadern aufgenommen werden, die andernfalls "keine Notiz" von der Änderung nehmen würden:

# Ändere den Verweis-URL, wenn ein Item bearbeitet wird.
$FeedFmt['rss']['item']['link'] = '{$PageUrl}?when=$ItemISOTime';
$FeedFmt['atom']['item']['link'] =
   "<link rel=\"alternate\" href=\"{\$PageUrl}?when=\$ItemISOTime\" />\n";

Siehe auch

• Cookbook:FeedLinks - Fügen Sie HTML-<head>-Links hinzu für 'auto-discovery' Ihres Feeds.
• WikiTrails - Abfolge mehrerer Seiten definieren ('Trail')
• Wikipedia:Web_feed, Wikipedia:Web_syndication,
• Wikipedia:RSS, Wikipedia:Atom_%28standard%29

FAQ

    function MarkupExcerpt($pagename) {
      $page = RetrieveAuthPage($pagename, 'read', false);
      return substr(@$page['text'], 0, 200);
    }

    $FmtPV['$MarkupExcerpt'] = 'MarkupExcerpt($pn)';
    $FeedFmt['rss']['item']['description'] = '$MarkupExcerpt';

$FeedFmt['rss']['item']['description'] = '$LastSummary'; 
$FeedFmt['rss']['item']['title'] = '{$Group} / {$Title} @ $ItemISOTime';

    if ($action == 'rss') $EnablePageListProtect = 0;

    .../Site/AllRecentChanges?action=rss&authpw=secret

$FeedFmt['rss']['feed']['image'] =
" <title>Logo title</title>
 <link>http://example.com/</link>
 <url>http://example.com/images/logo.gif</url>
 <width>120</width>
 <height>60</height>";

   if ($action == 'rss')
     SDVA($_REQUEST, array(
       'group' => 'News',
       'order' => '-time',
       'count' => 10));

$HTMLHeaderFmt['feedlinks'] = '<link rel="alternate" type="application/rss+xml" 
  title="$WikiTitle" href="$ScriptUrl?n=Site.AllRecentChanges&amp;action=rss" />
<link rel="alternate" type="application/atom+xml" title="$WikiTitle"
  href="$ScriptUrl?n=Site.AllRecentChanges&amp;action=atom" />';

   if (PageVar($pagename, '$Group')!='ForbiddenGroup') {
     $RecentChangesFmt['Site.MyFeedPage'] =
       '* [[{$FullName}]]  . . . $CurrentTime $[by] $AuthorLink: [=$ChangeSummary=]';
   }

   $FeedFmt['rss']['item']['guid'] = '{$PageUrl}?guid=$ItemISOTime';

   ## For new pages updates: http://example.com/wiki/HomePage?action=rss
   ## For edits updates: http://example.com/wiki/HomePage?action=rss&edits=1
   if(@$_REQUEST['edits'] && $action == 'rss')
     $FeedFmt['rss']['item']['guid'] = '{$PageUrl}?guid=$ItemISOTime';

für die Liste aller Seiten