Aller au contenu principal

Annexe B. Notes sur l'utilisation du champ Link avec le format Atom

Atom conveys links in the atom:link element, with the "href"
attribute indicating the target IRI and the "rel" attribute
containing the relation type. The context of the link is either a
feed IRI or an entry ID, depending on where it appears; generally,
feed-level links are obvious candidates for transmission as a Link
header.
When serialising an atom:link into a Link header, it is necessary to
convert target IRIs (if used) to URIs.

Atom définit les types de relation d'extension en termes d'IRI. Cette spécification les redéfinit comme des URI, afin de simplifier et de réduire les erreurs lors de leur comparaison.

Atom permet aux types de relation de lien enregistrés d'être sérialisés en tant qu'URI absolus. De tels types de relation devraient (SHOULD) être convertis sous la forme enregistrée appropriée (par exemple, "http://www.iana.org/assignments/relation/self" en "self") afin qu'ils ne soient pas pris à tort pour des types de relation d'extension.

En outre, les types de relation de lien Atom sont toujours comparés de manière sensible à la casse ; par conséquent, les types de relation de lien enregistrés devraient (SHOULD) être convertis sous leur forme enregistrée (généralement en minuscules) lorsqu'ils sont sérialisés dans un document Atom.

Notez également que, bien que le champ d'en-tête Link permette de sérialiser plusieurs relations dans un seul lien, atom:link ne le permet pas. Dans ce cas, un seul link-value peut correspondre à plusieurs éléments atom:link.

Comme pour HTML, atom:link définit certains attributs qui ne sont pas explicitement reflétés dans la syntaxe du champ d'en-tête Link, mais ils peuvent également être utilisés comme link-extensions afin de préserver la fidélité.