Tutoriel RSS, description construction et utilisation d'un flux

Tutoriel RSS, description construction et utilisation d'un flux



RSS - Syndication vraiment simple

Construire et utiliser un fil RSS

SommaireTutoriel RSS avec exemples

Qu'est-ce que RSS?

C'est un format d'Ă©change de donnĂ©es, dĂ©fini en XML version 1.0. Vous pouvez dĂ©livrer des donnĂ©es en les intĂ©grant dans ce format, et l'on peut recueillir des donnĂ©es de sources multiples dans ce format. On dĂ©signe les sources par fil ou flux RSS.
Les navigateurs rĂ©cents peuvent directement lire des fichiers RSS, mais on peut aussi utiliser un logiciel spĂ©cialisĂ© que l'on appelle lecteur RSS ou aggrĂ©gateur.

Histoire

Créé par Netscape an 1999. La premiÚre version est la 0.90. Elle est suivie par la 0.91 version, améliorée avec la contribution de la société Userland en 2000.
ApparaĂźt en 2000 une version 1.0 dĂ©finie O'Reilly, par la suite maintenue par le groupe RSS-DEV, basĂ©e sur RDF et nommĂ©e RDF Site Summary.
RSS 2.0 a été défini par Dave Winer (qui travaillait auparavant chez Userland) à l'université Harvard en 2002.
Cette page se base sur la spĂ©cification Really Simple Syndication 2.01 de Harvard.

Pourquoi utiliser RSS?

Pour recueillir l'actualitĂ© ou les informations fournies par des sites web, sous une forme exploitable par des ordinateurs. Pour l'afficher sur un site ou simplement la lire si vous ĂȘtes utilisateur final.
Et pour l'Ă©diteur Ă  l'origine du contenu, cela permet de faire connaĂźtre les nouvelles sur son site.

RSS, comment cela fonctionne?

Le systĂšme RSS de publication d'articles ou d'informations sur le web est trĂšs simple:

  1. De simples pages web, que l'on veut voir afficher sur d'autres sites.
    Cet ensemble de pages provenant d'un site (ou de plusieurs) s'appelle un flux RSS.
  2. Un fichier XML qui définit le flux RSS. Ce fichier contient pour chacune des pages en question l'adresse (URL) un titre et un résumé.
  3. Soit une personne qui veut lire ce flux sur son poste. Elle utilise son navigateur ou ajoute simplement le fichier RSS sur un lecteur de flux, ou aggrégateur.
  4. Soit un autre site web qui veut afficher ce flux. Pour cela il lui faut tĂ©lĂ©charger le fichier RSS, extraire l'addresse des pages, le titre et le rĂ©sumĂ© pour les afficher. Cela peut ĂȘtre accompli par un script en PHP. Quand on affiche la page du site client, le script est exĂ©cutĂ©, il rĂ©cupĂšre le fichier RSS sur le site Ă©diteur et il construit sur la page, une liste Ă  partir des titres, descriptions et liens extraits du fichier RSS.
  5. L'internaute en cliquant sur les liens affichés se trouve redirigé sur les pages du site éditeur.

Structure d'un document RSS

C'est un fichier XML.
Le conteneur global est une balise "RSS" pour le format 2.0.
Elle contient au moins un canal, désignant un distributeur qui fournit de l'information, et qui est un site web.
Ce canal procure un certain nombre d'articles ou d'élément d'information de diverses sortes. Ils correspondent à des pages web, venant de sites quelconques (donc pas forcément le site du canal).

Comment utiliser RSS?

1 - Utilisation sur le bureau

Les navigateur permettent d'afficher les flux RSS. On peut aussi installer un logiciel lecteur RSS (aggrĂ©gateur) fonctionnant sous son systĂšme d'exploitation (Windows, Linux, Mac OS). Voir dans la section ressources. Noter qu'il en existe un dont l'interface est faite en XUL.
L'accÚs au contenu RSS dépend du logiciel, cela peut consister simplement à ajouter une source avec le bouton "add", elle augmentera une liste.
Le fournisseur du contenu peut moduler la façon dont il sera utilisé par les lecteurs.

2 - Utilisation sur un site web

On affiche sur une page un flux RSS, donc une liste de titres. Cliquer sur un titre donne accĂšs Ă  une page web sur un autre site. Les titres sont mis Ă  jour automatiquement.
Pour que l'information soit mise à jour, il faut un script qui charge le fichier du flux sur le site éditeur, extraie les adresses des pages, et affiche la liste. Des adresses sont données en ressources.

Comment publier le contenu de son site dans un flux RSS?

Il y a plusieurs moyens de générer un flux RSS.

  • Utiliser la librairie RSS de PHP, ce qui suppose une gĂ©nĂ©ration dynamique des pages. On utilisera un script en PHP, qui produira le code HTML affichĂ© sur la page.
  • Utiliser un outil d'extraction de texte.
Pour faire connaĂźtre l'existence d'un flux RSS, une balise de lien est utilisĂ©e:  ou 

1
2
3
<font style="vertical-align: inherit;"><font style="vertical-align: inherit;"><a type="application/rss+xml"</font></font><font></font>
   href="https://www.xul.fr/rss.xml">Flux RSS de cette page<font></font><font style="vertical-align: inherit;"><font style="vertical-align: inherit;">
</a></font></font>

Les flux au format Atom utilisent la valeur: "application/atom+xml".
Remplacez xul.fr par le nom de domaine de votre site.

Vocabulaire

  • Feed. LittĂ©ralement "pĂąture" se traduit plutĂŽt par "flux" ou "fil". Un feed est un ensemble de balises "item", chacune contenant l'adresse d'une page web.
  • RDF. Voir la page RDF sur ce site.
  • Syndicated. Se dit de l'information transmise par RSS, peut se traduire par "publiĂ©".
  • Syndication. Cela peut se traduire par publication, auditorat, lectorat, etc. C'est la transmission du cotĂ© de l'Ă©diteur du contenu, l'acquisition du cotĂ© du public, de l'information.

Principales balises RSS

rss. Le conteneur global.
channel. Un canal. Il contient plusieurs balises descriptives, et une série de balises "item", les informations.

1
2
3
4
5
<font style="vertical-align: inherit;"><font style="vertical-align: inherit;"><rss version="2.0"></font></font><font></font><font style="vertical-align: inherit;"><font style="vertical-align: inherit;">
<canal></font></font><font></font>
...<font></font><font style="vertical-align: inherit;"><font style="vertical-align: inherit;">
</canal></font></font><font></font><font style="vertical-align: inherit;"><font style="vertical-align: inherit;">
</rss></font></font>

Les balises descriptives obligatoires du canal

  • title. titre du canal, devrait contenir son nom.
  • link. Adresse (URL) du site web pour ce canal.
  • description. Une phrase pour dĂ©crire le canal.
  • plus au moins une balise item pour le contenu.
1
2
3
4
5
6
7
8
9
10
<rss version="2.0"><font></font>
<channel><font></font>
    <title>XUL</title><font></font>
    <link>https://www.xul.fr</link><font></font>
    <description></description><font></font>
    <item><font></font>
    ...<font></font>
    </item><font></font>
</channel><font></font>
</rss>

Balises optionnelles pour le canal

  • language La langue dans laquelle le texte est Ă©crit.
  • docs Adresse web de la documentation sur le format, donc Ă  Harvard.
  • webMaster E-mail du responsable.
  • pubDate Date de publication.
  • etc. Il y a d'autres options Ă  voir dans la spĂ©cification.

Les articles du canal

Chaque balise item correspondant Ă  une information contient les balises suivantes:

  • title. Titre de l'article ou autres genre d'information.
  • link. L'URL de la page.
  • description. RĂ©sumĂ©, "synopsis" de l'article.
1
2
3
4
5
<item><font></font>
  <title>XUL news</title><font></font>
  <link>https://www.xul.fr/index.php</link><font></font>
  <description>...texte quelconque...</description><font></font>
</item

Plus quelques indications optionnelles pour l'article

  • pubDate. Date de publication.
  • guid. Une chaĂźne de caractĂšre qui est un identifiant unique de l'item.
  • category. Une catĂ©gorie Ă  laquelle peut appartenir l'article.
  • etc.

Créer votre propre flux RSS, pas à pas

Au départ un simple fichier de texte, créé avec un éditeur quelconque. Un éditeur XML étant préférable. (Voir la page "logiciels"). On l'appelera dans cet exemple: "flux.xml".
La structure générale du fichier sera la suivante:

1
2
3
4
5
6
<?xml version="1.0" ?><font></font>
<rss version="2.0"><font></font>
<channel><font></font>
...<font></font>
</channel><font></font>
</rss>

1) DĂ©finir le canal dans la balise channel

Ce sera le mĂȘme pour tous vos fichiers RSS. Il doit comporter ces balises:
title: le titre de votre site, le mĂȘme que dans la balise title sur la page d'accueil.
link: l'adresse de votre site: ex: https://www.xul.fr
description: description de votre site en 200 caractĂšres, ce peut ĂȘtre la mĂȘme description que dans la mĂ©ta-tag de la page d'accueil

1
2
3
4
5
<channel><font></font>
  <title>XUL et XML</title><font></font>
  <link>https://www.xul.fr/</link><font></font>
  <description>L'interface graphique XML  etc.</description><font></font>
</channel>

2) Ajouter une image

C'est facultatif. CrĂ©er une petite image (88x31 par exemple) au format usuel (gif, jpg, png) et placez la dans le mĂȘme rĂ©pertoire que ce fichier RSS.
La balise image est un élément de la balise channel
url est l'adresse de l'image elle-mĂȘme.
link est l'adresse de la page affichĂ©e quand on clique sur l'image.

1
2
3
4
5
6
7
8
<channel><font></font>
    <title> </title><font></font>
    <link> </link><font></font>
    <image><font></font>
        <url>http:///www.xul.fr/xul.gif</url><font></font>
        <link>http:///www.xul.fr/index.php</link><font></font>
    </image><font></font>
 </channel>

3) Ajouter un article

Un article n'est rien d'autre qu'une page Web. A partir de là, on crée une balise item contenue dans channel, avec les éléments suivants:
title: le titre de l'article, donc de la page.
link: l'adresse de la page.
description: résumé de l'article en 200 caractÚres environ.

1
2
3
4
5
<font style="vertical-align: inherit;"><font style="vertical-align: inherit;"><élément></font></font><font></font>
    <title>Nouvelle du jour</title><font></font><font style="vertical-align: inherit;"><font style="vertical-align: inherit;">
    <link>https://www.xul.fr/xml-rss.html</link></font></font><font></font>
    <description>Tout savoir sur RSS</description><font></font><font style="vertical-align: inherit;"><font style="vertical-align: inherit;">
</item></font></font>

4) Ajouter d'autres articles si besoin

Ajouter d'autres balises item à l'intérieur du canal.

5) Uploader le fichier sur le site

Placer le fichier flux.XML sur votre site, parmi les pages web.

6) Valider le fichier

Vous pouvez utiliser le valideur indiqué dans les liens en fin de page.

7) Rendre le flux accessible

Pour cela il faut placer un bouton RSS sur la page d'accueil. En cliquant sur le bouton on doit afficher le fichier prĂ©cĂ©demment crĂ©Ă©.  ou 

1
2
3
<a href="https://www.xul.fr/rss-fr.xml"><font></font>
  <img  src="rss.gif"><font></font>
</a>

Si l'image ne s'affiche pas, utiliser une URL complĂšte comme https://www.xul.fr/rss.gif.

8) Mettre Ă  jour le flux

Pour fournir de nouveaux articles, il suffit d'ajouter des items, et de supprimer les plus anciens lorsque la taille du fichier devient trop imposante.

Exemple: le fichier complet

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<?xml version="1.0" ?><font></font>
<rss version="2.0"><font></font>
<channel><font></font>
  <title>Ajax et XML</title><font></font>
  <link>https://www.xul.fr/</link><font></font>
  <description>L'interface graphique XML etc...</description><font></font>
  <image><font></font>
  <url>http:///www.xul.fr/xul-icon.gif</url><font></font>
  <link>http:///www.xul.fr/index.php</link><font></font>
   </image><font></font>
   <item><font></font>
      <title>Nouvelle  du jour</title><font></font>
      <link>https://www.xul.fr/xml-rss.html</link> <font></font>
      <description>Tout  savoir sur RSS</description><font></font>
   </item><font></font>
   <item><font></font>
     <title>Nouvelle  du lendemain</title><font></font>
    <link>https://www.xul.fr/xml-rdf.php</link> <font></font>
    <description>Et  tout savoir sur RDF</description><font></font>
   </item><font></font>
  </channel><font></font>
</rss>
Un document RSS

Vous pouvez tĂ©lĂ©charger l'exemple et l'utiliser comme point de dĂ©part pour votre propre fichier RSS, en remplaçant bien sur "xul.fr" par le nom de votre site.

Vous avez créé un flux et vous l'avez placé sur votre site web, à la racine par exemple. Il faut en informer les navigateurs lorsqu'ils affichent la page d'accueil du site (ou toutes autres pages si vous voulez). Firefox affichera l'icÎne dans le champ d'URL, Internet Explorer sur la barre de commandes.
Pour les activer, insĂ©rez la ligne suivante dans le code source de la page, n'importe oĂč Ă  l'intĂ©rieur de la section <head> </head>:

1
2
<link rel="alternate" type="application/rss+xml"<font></font>
    href="https://www.xul.fr/rss.xml" title="Votre titre">

Remplacer l'URL de l'exemple par celle de votre domaine avec le chemin et le nom du fichier RSS.
Et si le fichier est au format atom, remplacer rss+xml par atom+xml .

Spécifications et outils

Spécifications et références

  • RSS 2.0. SpĂ©cification par Harvard en version française.
  • RSS 1.0. Le tutoriel du format RDF Site Summary 1.0 de O'Reilly.

Outils de génération et affichage de flux RSS

  • Ara Editor. Editeur de flux RSS en ligne Ă©crit en PHP. Voir aussi Bioloide sur le mĂȘme site.
  • Lecteur RSS. Fonction PHP pour afficher un flux RSS sur une page Web, Ă  partir d'un fichier local ou distant.

Commentaires

Posts les plus consultés de ce blog

TOP outils de rĂ©fĂ©rencement gratuits qui valent la peine d'ĂȘtre utilisĂ©s en 2023

Les outils de rĂ©fĂ©rencement gratuits qui valent vraiment la peine d'ĂȘtre utilisĂ©s

Changement de domaine en 2023 : tout ce que vous devez savoir

Chatbot Dialogflow : Tutoriel NoCode NLP pour les spĂ©cialistes du marketing | Landbot

Revenu passif : idées pour gagner de l'argent (en dormant)

Meilleurs outils de rĂ©fĂ©rencement 🛠 organisĂ©e par Saijo George

La toolbox du growth hacker 💎 - Outils - Growthhacking.fr | CommunautĂ© française de growth hacking

Comment signer avec une maison de disques ? Voici notre guide ultime pour 2024

100 outils pour lancer sa startup sans argent (mais pas sans talent)