Squelettes Atom 1.0 (version 1.1)

Des squelettes permettant une publication au format Atom 1.0.

-  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
-  26/12/2006 ajout des fichiers en version 1.1.2
-  27/02/2007 ajout des fichiers en version 1.1.3
-  06/03/2007 ajout des fichiers en version 1.1.4
-  10/10/2007 ajout des fichiers en version 1.1.5

Discussion

4 discussions

  • 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

  • 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

  • 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

  • Vous pouvez ajouter dans les squelettes, après la ligne contenant « <link rel="alternate" type="text/html" » (soit quatres endroits au total), la ligne

    [		<link rel="replies" type="application/atom+xml" href="(#PARAMETRES_FORUM|url_rss_forum|parametre_url{fmt,atom}|url_absolue)"/>]

    .

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom