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/.

Discussion

One 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

Add a comment

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 / PostgreSQL
  • 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 apparait.

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.

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