Flux de syndication

Ce que c'est

Un flux de syndication est un fichier à une adresse fixe qui énumère
les dernières publications d'un site sous une forme lisible par un
logiciel. Chacune porte un titre, une date, un identifiant qui ne
change pas et généralement le texte lui-même ; un programme peut
ainsi récupérer le fichier à intervalles réguliers et ne montrer à
une personne que les nouveautés. On parle aussi de flux web, et
beaucoup emploient « flux RSS » pour tous ces flux, quel que soit le
format sous-jacent.

Ce qui distingue un flux, c'est le sens de circulation. Une lettre
d'information est envoyée : l'éditeur conserve une liste d'adresses
et écrit à chacune. Un flux est récupéré : l'éditeur laisse un
fichier sur le serveur et le lecteur de flux de chaque abonné le
télécharge, le compare à la copie précédente et conserve les
éléments qu'il n'avait pas encore rencontrés. L'éditeur n'apprend
jamais qui s'est abonné, l'abonné ne communique jamais d'adresse
électronique, et partir consiste à supprimer une ligne dans un
lecteur.

Trois formats portent presque tous les flux du web. RSS 2.0 est en
XML, date ses éléments à la manière de la RFC 822 (`Sat, 07 Sep 2002
00:00:01 GMT`) et sa propre spécification le déclare figé. Atom,
publié par l'IETF dans la RFC 4287 en décembre 2005, est lui aussi
en XML, mais plus strict : chaque flux et chaque entrée portent un
`id` permanent et un horodatage `updated` au format RFC 3339, et un
auteur doit être nommé quelque part. JSON Feed, en version 1.1
depuis août 2020, exprime les mêmes choses en JSON pour les
développeurs qui préfèrent ne pas analyser du XML.

Une page indique aux logiciels où sont ses flux avec des éléments
`<link rel="alternate">` dans l'en-tête de son document HTML, chacun
donnant un type de média : `application/rss+xml`,
`application/atom+xml` ou `application/feed+json`. C'est ainsi qu'un
lecteur trouve le flux à partir de la seule adresse ordinaire du
site.

Pourquoi c'est important

La première décision est de savoir s'il faut en publier un. Un flux
est une sortie supplémentaire pour laquelle il faut écrire un
modèle, qu'il faut valider et garder stable pendant des années, pour
un public plus petit que celui d'un réseau social. En contrepartie,
c'est le seul canal d'abonnement qui n'exige ni plateforme, ni
compte, ni liste de diffusion, et aucun algorithme de classement ne
s'interpose entre une publication et les personnes qui ont demandé à
la voir.

La deuxième décision porte sur les formats. Certains lecteurs
n'acceptent que RSS, d'autres qu'Atom, et il est impossible de
savoir à l'avance lequel attend le lecteur d'un abonné donné.
Publier les deux comble cette lacune au prix d'un deuxième modèle.
JSON Feed en ajoute un troisième pour les logiciels écrits par des
personnes qui préfèrent manipuler du JSON. Chaque format
supplémentaire est un fichier de plus à maintenir en accord avec les
autres : mêmes éléments, mêmes identifiants, mêmes dates.

La troisième décision est la quantité de texte à placer dans chaque
élément. Un flux en texte intégral permet de lire tout l'article
dans son lecteur, ce qui est une grande part de l'intérêt d'un
lecteur, et coûte des pages vues à l'éditeur. Un flux limité aux
résumés renvoie chaque lecteur au site pour chaque élément. Aucun
choix n'est mauvais ; il faut choisir entre la diffusion des textes
et la fréquence des visites de la page elle-même.

Quelles que soient les réponses, l'adresse est un engagement. Les
lecteurs interrogent l'URL reçue à un rythme qu'ils choisissent
chacun eux-mêmes. RSS permet à un flux d'en suggérer un en minutes
avec `ttl`, mais le lecteur peut l'ignorer. Beaucoup continuent à
l'interroger des années. Une fois l'adresse d'un flux publiée, il
faut la maintenir.

À quoi cela ressemble en pratique

Ce site publie les trois formats depuis sa page d'accueil, à
`/index.xml` pour RSS, `/atom.xml` pour Atom et `/feed.json` pour
JSON Feed. La page des crédits les énumère avec les services qui les
vérifient : les trois contiennent le texte intégral, et il y a deux
flux XML plutôt qu'un seul parce que certains lecteurs n'en
acceptent qu'un des deux et qu'on ne peut pas compter sur le même
pour tous. Le validateur de flux du W3C vérifie Atom et RSS, et le
validateur JSON Feed vérifie le troisième, que le service du W3C ne
couvre pas parce qu'il est antérieur au format. Le service du W3C
avertit que la plupart des entrées partagent une date de
modification. La page conserve cet avertissement plutôt que de le
cacher : les dates viennent de l'historique Git et la plupart des
pages ont été écrites dans les mêmes quelques commits.

La page de contact propose les flux pour suivre l'entreprise sans
compte, à côté de ses profils sociaux, et rappelle que les trois
contiennent le texte intégral de tout ce qui est publié.

Aucun des trois n'est écrit à la main ni produit à la demande. Dans
le projet qui a construit le site, le site est généré entièrement à
la construction, sans backend à l'exécution. Chaque page est publiée
sous plusieurs représentations à partir d'une seule arborescence de
contenu, et la page d'accueil y ajoute trois flux de syndication et
un manifeste d'application installable.

Où les problèmes surviennent

Chaque ancien élément revient comme une nouveauté. Après une
refonte, un changement de domaine ou de modèle, les abonnés voient
des dizaines d'éléments lus des mois auparavant. Les lecteurs
reconnaissent un élément à son identifiant, `id` pour Atom, `guid`
pour RSS ou `id` pour JSON Feed. Quand cette chaîne change,
l'élément est nouveau pour eux. La RFC 4287 exige explicitement que
l'`id` d'une entrée survive à une relocalisation, une migration et
une republication. Un lien permanent n'est un bon identifiant que si
le site promet de conserver l'ancienne chaîne après un déplacement.
En RSS, indiquez aussi ce qu'est le `guid` : la spécification donne
à `isPermaLink` la valeur vraie lorsque cet attribut est omis, et le
modèle RSS de ce site écrit malgré tout `isPermaLink="true"`, car un
lecteur qui suppose le contraire réimporte chaque élément en double.

Le flux prétend avoir changé à chaque construction. La date du flux
change chaque fois que le site est reconstruit, qu'une publication
ait eu lieu ou non. Un logiciel qui surveille cette date pour
trouver des nouveautés se déclenche donc pour rien. La cause est un
modèle qui prend l'heure courante au moment de la construction. RSS
définit `lastBuildDate` comme « le dernier moment où le contenu du
canal a changé », et l'`updated` du flux Atom a le même sens : la
date devrait donc venir de l'élément le plus récent. Le modèle Atom
de ce site la tire de l'entrée la plus récente pour cette raison
précise.

Un changement typographique empêche d'analyser le flux. Les lecteurs
signalent un flux défectueux, et un validateur pointe une entité non
définie dans le premier article contenant une apostrophe ou un
guillemet typographique. XML prédéfinit cinq entités nommées, `lt`,
`gt`, `amp`, `apos` et `quot`, alors que HTML en définit des
centaines de plus. Un moteur de rendu Markdown qui écrit les
guillemets et les tirets sous forme d'entités nommées HTML produit
un balisage valable dans une page, mais fatal dans un élément XML.
Échappez le HTML avant de l'y insérer, comme l'attend un contenu
Atom de `type="html"`, ou placez-le dans une section CDATA, ce que
le profil des bonnes pratiques RSS autorise pour `content:encoded`.
Le modèle Atom de ce site échappe son contenu, et le commentaire
voisin consigne que, laissé brut, le flux ne pouvait pas du tout
être analysé.

Les abonnés disparaissent après un déplacement, sans que personne
l'apprenne. Un flux n'a ni bouton de désabonnement ni liste qui
diminue ; le seul signe est donc le silence. Son adresse a changé,
ou son fichier a été supprimé, et chaque lecteur qui interroge
l'ancienne URL reçoit maintenant une erreur. Maintenez une réponse à
l'ancienne adresse, avec le flux lui-même ou une redirection
permanente. Ce site garde son RSS à `/index.xml`, le chemin standard
de son générateur, parce que c'est l'adresse interrogée par les
lecteurs existants. Dans une langue qu'il n'annonce pas, il écrit
encore des flux bien formés ne contenant aucun élément, pour qu'un
lecteur reçoive un document valide plutôt qu'une 404.

Deux flux se confondent dans la boîte de dialogue d'abonnement. Une
extension de navigateur ou un lecteur propose un seul flux alors que
la page en déclare deux. Deux liens alternatifs portant le même type
et le même titre ressemblent à un seul flux pour cet outil, qui
affiche le dernier rencontré. Donnez un titre propre à chacun ; les
pages de ce site utilisent son nom suivi de « (RSS) », « (Atom) » ou
« (JSON Feed) ».

Pour aller plus loin

  * RFC 4287 : format de syndication Atom — la norme IETF, avec ses
éléments obligatoires, ses identifiants permanents et ses dates RFC
3339.

  * Spécification RSS 2.0 — le texte du format figé publié par le
RSS Advisory Board, élément par élément.

  * JSON Feed version 1.1 — la même idée exprimée en JSON et les
changements depuis la version 1.0.

  * Norme HTML : type de lien « alternate » — la manière dont une
page indique ses flux aux logiciels.

  * Service de validation des flux du W3C — vérifie un flux RSS ou
Atom à partir de son adresse et explique chaque avertissement.

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