Squelette atom 1.0

All contributions published for previous SPIP versions

Je vous propose un squelette pour offrant une syndication au format atom 1.0. Il est basé sur la version courante de dist/backend.html, et fourni donc les rubriques du site entier ou d’une rubrique spécifique, les documents joints et tout le contenu (texte) des articles.

Installation

Ci-joint le document atom.zip, qui contient backend.atom.php3 à placer à la racine du site, et backend.atom.html à placer dans le dossier des squelettes.

Version de SPIP

Version de SPIP requise : 1.8.2 à cause des filtres texte_backend et url_absolue. {{{Licence}}} Ce squelette étant basé sur les versions de développement (du 11 décembre 2005) de backend.php3 et dist/backend.html, ainsi que d'une lecture approfondie de la norme atom 1.0, ils est sous licence GPL. {{{Validation}}} - Le squelette a été vérifié à une reprise avec http://validator.w3.org/feed/.
-  Il ne suit pas le SHOULD de la section 4.1.1, alinéa 8 (de la norme).
-  Il ne respecte pas entièrement la section 4.2.6 : SPIP ne dispose pas de système permettant de savoir qu’un site web SPIP avait auparavant une autre adresse, un passage de urls-standard à urls-propres ou autre modifie les URL des articles, et de toute façon la section 4.2.6 a des implications importantes et sa résolutions est problématique.

Informations supplémentaires


-  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 : « RSS 2.0 and Atom 1.0, Compared », Tim Bray,
http://www.tbray.org/atom/RSS-and-Atom;
-  un site web de promotion de atom : http://www.atomenabled.org/.

updated on 28 October 2006

Discussion

Une discussion

  • 5

    Pour le SHOULD de la section 4.1.1, alinéa 8 de la norme, pourquoi ne pas ajouter la déclaration suivante?

    <link rel=“self” href=“#URL_SITE_SPIP/backend.atom.php3”/>

    anthony_m

    • J’avais oublié: un grand merci pour ce squelette!

      anthony_m

    • « Pour le SHOULD de la section 4.1.1, alinéa 8 de la norme, pourquoi ne pas ajouter la déclaration suivante ?

      <link rel="self" href="#URL_SITE_SPIP/backend.atom.php3"/> »

      Vous oubliez que ce squelette atom (et le squelette rss de SPIP 1.9alpha dont il est dérivé) peut être appellé avec divers paramètres, dont id_rubrique, lang, texte_complet, extension. backend.atom.php3?id_rubrique=1000&lang=kl peut être une ressource très différente de backend.atom.php3?texte_complet=false, et ne conviendrait donc pas pour link rel=“self” (cf. section 4.2.7.2 de la norme).

      Note : je peut mettre un lien vers http://www.w3.org/News/2005#item166 sur le mot « hébergé » dans l’article.

    • En effet, j’avais oublié que l’on peut effectivement passé des paramètres à ce squelette!
      Merci de la précision,

      Anthony

    • C’est encore moi.

      On peut utiliser la balise SPIP #SELF pour récupérer la page appelée, ainsi que les paramètres de requêtes éventuellement passés. Ce qui donnerait donc:

      <link rel=“self” href=“#URL_SITE_SPIP/#SELF”/>

      Anthony

    • <link rel="self" href="#URL_SITE_SPIP/#SELF"/>

      <link rel="self" type="application/atom+xml" href="#URL_SITE_SPIP/#SELF"/> convient. Merci.

    Reply to this message

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom