Nom des squelettes : Squelettes Atom 1.0
Version du squelette : 1.1 (version précédente)
Auteur : Nicolas Krebs
Licence : GPL version 2
Compatibilité SPIP : SPIP 1.9 ou 1.9.2 nécessaire
Principales fonctionnalités et spécificités : publication au format Atom 1.0 (rfc 4287)
Contributions intégrées et sources d’inspiration : les squelettes dist/backend.html et dist/backend-breves.html de SPIP 1.9, la rfc 4287, divers tutoriaux sur SPIP 1.9 et et sur Atom 1.0
Version de SPIP
Version de SPIP requise : 1.9 pour les versions 1.1 et 1.1.1, 1.9.2 pour les versions 1.1.2 et suivantes.
Installation
Décompresser le fichier ci-joint et copier les trois fichiers *.html dans le dossier des squelettes de votre site web motorisé par SPIP.
Utilisation
Ce sont trois fichiers squelette SPIP :
atom-articles.html publie (les références ou les contenus, suivant la configuration du site) des vingt derniers articles
atom-breves.html les vingt dernières brèves
atom.html les vingt derniers articles et les vingt dernières brèves
Chacun des squelettes peut être appelé avec des identifiants de rubrique, de langue ou de mot-clé. Exemples avec les url de type « page » de SPIP 1.9 :
spip.php?page=atom&id_rubrique=1,
spip.php?page=atom-breves,
spip.php?page=atom-articles&id_mot=1,
spip.php?page=atom&id_mot=1&rubrique=1.
Il est possible d’ajouter des liens dans les squelettes du sommaire et des rubriques afin que le document html indique explicitement la possibilité de syndication avec atom. Par exemple, pour syndiquer les brèves et les articles d’une rubrique, ajouter dans la section <head> du squelette de la ou les rubriques « [<link rel="alternate" type="application/atom+xml" title="<:syndiquer_rubrique:>" href="(#URL_PAGE{atom}|parametre_url{id_rubrique,#ID_RUBRIQUE})" />] ».
Licence
Ces squelettes sont sous licence GPL version 2.
Validation
Puisque dans SPIP les brèves n’ont pas d’auteur, les squelettes atom.html et atom-breves.html n’attribuent pas d’auteurs aux brèves, ce qui est contraire à la norme atom 1.0 (« atom:entry elements MUST contain one or more atom:author elements, unless the atom:entry contains an atom:source element that contains an atom:author element or, in an Atom Feed Document, the atom:feed element contains an atom:author element itself.
» dans la section 4.1.2). Un palliatif à ce défaut a été ajouté dans la version 1.1.3.
La production du squelette a été vérifié avec http://validator.w3.org/feed/ et, à part le point précédent, la production est conforme.
Améliorations possibles (aka todo list)
Prendre en compte les éventuelles mises à jour des formats utilisés ;
Ajouter une pagination, avec les liens atom vers page suivante ou précédente
Ajouter un squelette atom-site.html créant une liste atom des articles d’un site syndiqué.
Informations supplémentaires
Ces squelettes créent des espaces d’identifiant atom:id et atom:scheme, qui peuvent entrer en conflit avec des identifiants atom créés par ailleurs.
Le type MIME de publication (qui est spécifié à la deuxième ligne de chaque squelette par une balise #HTTP_HEADER) peut être « text/xml », « application/xml » et « application/atom+xml » (cf. rfc 3023 et rfc 4287 section 7).
Les fichiers backend (article dans la documentation officielle de SPIP)
La norme Atom 1.0, RFC 4287, http://www.ietf.org/rfc/rfc4287.txt (décembre 2005).
Un service de validation, hébergé par le W3C : http://validator.w3.org/feed/.
Une comparaison entre RSS 2.0 et Atom 1.0
Un site web de promotion d’Atom : http://www.atomenabled.org/.
SPIP 1.9 (article dans la documentation officielle de SPIP)
31/08/2006 ajout des fichiers en version 1.1.1
RSS 2.0