- 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)
squelettes atom 1.0 version 1.1
Vos commentaires
# Le 1er février 2010 à 10:42, par Agnes
En réponse à : Des images dans les items ?
Bonjour
Et merci pour ces squelettes !
pour ma part, je cherche désespéremment de l’aide pour modifier le fichier backend de façon à intégrer, dans le rss-item (ou son equivalent), un logo ou une image associés à l’article.
C’est apparemment possible sous différentes méthides en RSS (sans foute Atom), mais je n’arrive pas a extraire les bons éléments de SPIP.
(tentatives infructueuses décrites sur
http://forum.spip.org/fr_220729.html#forum220743)
Si vous avez des idées, ou des solutions, ce pourrait être une amélioration !
Merci
Agnes
Répondre à ce message
# Le 11 août 2008 à 14:18, par ?
En réponse à : Squelettes Atom 1.0 (version 1.1)
Bravo pour le squelette, c’est exactement ce que je cherchais :)
Attention, le tri par date n’est pas antéchronologique (il manque le inverse dans les boucles concernées) dans la dernière version. Sinon, sur le site que je gère, il y a aussi des articles sans auteurs (c’est tout à fait possible et ça peut être utile) et donc se repose le même problème que celui des brèves.
Personnellement, dans ce cas là, je mets comme auteur le site lui-même en attendant de trouver mieux (qui est d’ailleurs déjà l’auteur « général » du feed).
Répondre à ce message
# Le 6 avril 2008 à 14:53, par pam
En réponse à : Squelettes Atom 1.0 (version 1.1)
il me semble comprendre que ces squelettes permettent de syndiquer des articles (les 20 derniers ) de mon site vers d’autres sites utilisant la syndication.
De mon coté, je cherche à alimenter mon site avec des images provenant d’un mobile nokia et de son application « lifeblog » qui permet d’uploader directement sur le site des photos... en utilisant le protocole atom.
Le paramétrage de l’application lifeblog me demande une adresse du genre http://www.typepad.com/t/atom/weblog avec un user/pass....
je comprends que atom permet de lire/écrire... mais est-ce que je fais une erreur en comprenant que ce squelette me permet de lire avec atom des articles de mon site et pas d’en écrire... ?
si je me trompe, merci de me mettre sur la bonne piste atom/spip.
si je ne me trompe pas, merci de toute autre piste... ;-o)
pam
Répondre à ce message
# Le 28 juillet 2006 à 19:38, par Nicolas Krebs
En réponse à : Squelettes Atom 1.0 (version 1.1)
Vous pouvez ajouter dans les squelettes, après la ligne contenant «
<link rel="alternate" type="text/html"» (soit quatres endroits au total), la ligne.
Répondre à ce message