Agrégation des flux RSS/ATOM
DokuWiki sait intégrer des flux RSS/ATOM extérieurs. Pour en savoir plus, rendez-vous sur la page syndication : vous y apprendrez comment DokuWiki exporte des données sous forme de flux XML.
Syntaxe
Inclure un flux RSS ou ATOM est simple. Voici un exemple d'intégration d'un flux de slashdot.org :
{{rss>http://slashdot.org/index.rss}}
DokuWiki intègre SimplePie, qui parse les flux XML pour lui. Ainsi tous les arguments pris en charge par SimplePie peuvent être utilisés pour personnaliser le rendu des flux. Pour ce faire, intégrez les paramètres séparés par des espaces à la syntaxe vue ci-dessus. Les paramètres possibles sont les suivants :
| Paramètre | Description |
|---|---|
| n'importe quel nombre | Nombre maximum d'éléments à montrer, défaut 8 |
| reverse | Inverser l'ordre d'affichage des historiques (le dernier en premier) |
| author | Montre le nom des auteurs |
| date | Montre les date et heure |
| description | Montre la description de l'élément. Si HTML n'est pas activé, les éléments HTML ne seront pas interprétés |
| n[dhm] | Période de rafraîchissement du flux, où d=jours, h=heures, m=minutes (par ex : 12h = 12 heures). |
La période de rafraîchissement par défaut est 4 heures. Une valeur définie à moins de 10 minutes sera traitée comme 10 minutes. DokuWiki fournira en général une version en cache de la page : ce qui n'est pas approprié si la page contient du contenu dynamique. Ce paramètre contraint DokuWiki à rafraîchir la page si la refresh period (période de rafraîchissement) est moins importante que le temps qui s'est écoulé entre la création du dernier flux mis en cache et le moment où la page est demandée.
Exemple:
{{rss>http://slashdot.org/index.rss 5 author date 1h }}