Aller au contenu
Engineer
Menu
Design
Français

Engineer / Glossaire

RSS

Format XML de flux plus ancien qu’Atom

Ce que c’est

RSS est un format XML permettant de publier un flux à une adresse que les lecteurs de flux consultent périodiquement. Un élément channel décrit un site et contient une liste d’éléments item, chacun représentant une publication avec un lien, une date et du texte. Sa spécification développe le nom en Really Simple Syndication. Beaucoup emploient « flux RSS » pour un flux de n’importe quel format, et RSS 1.0, « RDF Site Summary », est un format distinct fondé sur RDF, plutôt qu’une ancienne version de celui utilisé aujourd’hui.

Le format est né chez Netscape, qui a publié RSS 0.90 en mars 1999 et 0.91 en juillet de la même année. UserLand a publié sa propre version 0.91 en juin 2000, puis 0.92 et, en août 2002, RSS 2.0. Le Berkman Klein Center de la Harvard Law School a publié la version 2.0.1, écrite par Dave Winer, en juillet 2003. Le RSS Advisory Board assure depuis le suivi du texte sous licence Creative Commons. Sa feuille de route précise que le format est, à toutes fins pratiques, figé à la version 2.0.1. Le conseil a publié depuis des révisions du document, dont l’actuelle en mars 2009, mais les nouveaux besoins sont couverts par des extensions dans leurs propres espaces de noms XML, plutôt que par de nouvelles versions de RSS.

Un document est court. Sa racine est un élément rss dont l’attribut version doit être 2.0, contenant un seul channel. Le canal exige un title, un link et une description. Chaque élément d’une publication est facultatif, à condition qu’elle possède au moins un titre ou une description. Tout le reste, de pubDate et guid à image et ttl pour le canal, est présent au choix de l’éditeur :

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
  <channel>
    <title>Example Notes</title>
    <link>https://example.com/</link>
    <description>Short notes on running servers.</description>
    <item>
      <title>Moving the database</title>
      <link>https://example.com/notes/db-move/</link>
      <guid isPermaLink="true">https://example.com/notes/db-move/</guid>
      <pubDate>Sat, 17 Oct 2026 09:00:00 GMT</pubDate>
      <description>Why the move took one evening.</description>
    </item>
  </channel>
</rss>

Pourquoi c’est important

RSS laisse une grande latitude, et l’éditeur doit comprendre ce que cela implique. La description d’une publication peut contenir du texte brut ou du HTML échappé dans l’élément, sans que le fichier indique lequel : le lecteur décide. Le guid est facultatif, si bien qu’en son absence le lecteur détermine lui-même si une publication est nouvelle. Les dates suivent la RFC 822, norme de courrier électronique de 1982, sous forme de chaînes comme Sat, 17 Oct 2026 09:00:00 GMT, avec des noms de jours et de mois anglais. La spécification autorise encore une année à deux chiffres. Le format ne permet pas non plus de déclarer une URL de base : un lien relatif dans une publication n’a donc aucune base fiable pour sa résolution.

La réponse du conseil est le RSS Best Practices Profile, publié en octobre 2007 : des recommandations pour des documents compatibles avec la grande diversité des logiciels de lecture. Il demande un guid pour chaque publication et des URL absolues dans les liens et descriptions. Selon ses essais, les seuls formats de date correctement traités par tous les agrégateurs testés étaient en temps universel, terminés par GMT, +0000 ou -0000. Il documente aussi un atom:link avec rel="self" indiquant l’adresse du flux lui-même. Un flux conforme à ce profil laisse beaucoup moins de choses à deviner aux lecteurs.

Deux extensions portent l’essentiel des ajouts d’un flux moderne. atom:link emprunte cet élément à Atom. content:encoded, issu d’un module initialement écrit pour RSS 1.0, contient le HTML complet d’une publication. Le profil décrit leur usage conjoint : le texte intégral dans content:encoded et un résumé plus court dans description. Il a constaté que, lorsqu’une publication contenait les deux, six des huit agrégateurs testés affichaient content:encoded et ignoraient le résumé. L’élément enclosure joint un fichier multimédia à une publication avec trois attributs obligatoires : son url, sa length en octets et son type MIME.

Ce caractère figé est aussi un atout. Un format inchangé depuis 2003 offre une base stable aux implémentations, et un flux écrit aujourd’hui selon ce format est lu par des logiciels développés à partir du même texte des années auparavant. Atom comble par sa spécification la plupart des lacunes ci-dessus. Publier aussi RSS répond donc aux besoins des lecteurs plutôt qu’à un souci de rigueur : certains n’acceptent que RSS, et une adresse de flux diffusée il y a des années continue d’être interrogée.

À quoi cela ressemble en pratique

Ce site publie RSS 2.0 à l’adresse /index.xml, aux côtés d’un flux Atom et d’un JSON Feed. La page des crédits explique la présence de deux flux XML : tous trois fournissent le texte intégral. Il y a deux flux XML plutôt qu’un parce que certains lecteurs n’acceptent que l’un des deux, sans qu’on puisse compter sur le même pour tous. Cette page relie aussi le flux RSS au W3C Feed Validator, à côté du flux Atom, pour que chacun puisse lancer le contrôle sans devoir croire le site sur parole.

La page sur la lecture du site dans un terminal présente les flux comme des données. Elle indique que le portfolio est diffusé en trois formats, chacun contenant le texte intégral de chaque publication plutôt qu’un extrait, et récupère le flux RSS avec le seul curl :

curl -s https://engineer.company/index.xml

Où les problèmes surviennent

L’image du canal manque et le validateur proteste. Un lecteur n’affiche aucune image à côté du nom du flux, et le service du W3C avertit que le format de l’image ne convient pas. L’élément image de RSS est le plus contraignant des trois formats de flux : GIF, JPEG ou PNG uniquement, avec une largeur maximale de 144 pixels et une hauteur maximale de 400. Une carte de partage social en WebP est donc le mauvais fichier. Le modèle RSS de ce site fait plutôt pointer image vers son icône PNG de 144 pixels. Le commentaire voisin précise que la carte WebP avait provoqué un avertissement ImageUrlFormat, repéré en relançant la validation après la modification.

Les publications sont mal triées sans aucun signalement. Un lecteur place les nouvelles publications sous les anciennes ou leur attribue une mauvaise date. Les dates RSS sont des chaînes : une date ISO 8601, un modèle mal orthographié ou un nom de jour dans une autre langue produit encore du XML bien formé. Seul l’analyseur de dates du lecteur remarque le problème. Dans Hugo, la méthode Format d’une date écrit les noms en anglais, tandis que la fonction time.Format les localise : un pubDate danois n’est pas une date RFC 822. Ce site formate chaque pubDate avec la méthode, selon un format conservé avec celui d’Atom dans un même modèle partiel. Le commentaire précise qu’une faute dans l’un ou l’autre ne provoque pas un échec de la construction, mais un flux mal analysé et mal trié dans le lecteur d’une autre personne.

Les icônes d’une publication ne s’affichent pas et le validateur énumère des erreurs. Le texte intégral contenu dans content:encoded quitte sa page : tout ce qui dépend de cette page disparaît. Une icône SVG renvoyant à un sprite défini ailleurs sur la page ne s’affiche pas dans un lecteur, et le service du W3C signale l’élément svg lui-même. Les flux de ce site reçoivent donc leurs titres sans le séparateur en forme de rouage de la marque. Le commentaire du modèle indique que le validateur avait signalé douze messages Non-html tag: svg et six signalements concernant un attribut role.

Les liens d’une publication ne mènent nulle part. Un abonné suit un lien et arrive sur une page inexistante, ou n’arrive nulle part. Un lien relatif à la racine comme /notes/ fonctionne sur la page web parce que le navigateur connaît son adresse, mais un document RSS ne peut pas déclarer d’URL de base. Le profil précise qu’une description ne devrait pas contenir d’URL relatives et qu’un agrégateur peut tenter de les résoudre à partir du link du canal. Un lecteur qui ne le tente pas laisse le lien cassé. Écrivez tous les liens du HTML d’un flux sous forme d’URL absolues.

Deux catégories portant le même mot semblent n’en former qu’une. Une publication étiquetée selon deux vocabulaires affiche un terme en double, ou un lecteur fusionne deux termes de sens différent. L’élément category de RSS accepte un attribut facultatif domain indiquant le vocabulaire d’origine d’un terme. Le modèle RSS de ce site l’écrit sur chaque catégorie : comme l’explique son commentaire, sans domaine, les termes communs aux deux vocabulaires se liraient comme des doublons.

Pour aller plus loin

  • Spécification RSS 2.0 — le texte du RSS Advisory Board, élément par élément, avec la feuille de route qui déclare le format figé.
  • Profil de bonnes pratiques RSS — les recommandations du conseil et ses observations lors d’essais sur de vrais agrégateurs.
  • Histoire de RSS — toutes les versions, de la 0.90 de Netscape au texte actuel, avec leurs dates et éditeurs.
  • RDF Site Summary, RSS 1.0 — le format distinct fondé sur RDF qui porte le même nom.
  • RFC 822 — la norme de courrier électronique de 1982 dont RSS utilise toujours la syntaxe de date et d’heure.

Contact

Vous cherchez encore à préciser vos besoins ?

Dites-nous ce qui ne fonctionne pas ou ce que vous essayez de construire. Nous vous dirons ce que cela demanderait, son coût approximatif et si nous sommes les bonnes personnes pour le réaliser.

À partir de 1 400 DKK de l'heure, hors TVA — et un tarif horaire réduit pour une réservation plus longue.

welcome@engineer.company +45 50 10 61 84 Copenhague, Danemark