RSS

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
<?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` :

```sh
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.

hCette page sur le Web	URL:https://engineer.company/fr/glossary/rss/	engineer.company	70
