Ecrire un fichier de syndication au format (...)

Accueil du site > Aide > Tutoriels > Ecrire un fichier de syndication au format (...)
Dernière modification : 15 mars 2006

Mots-clés :

initié rss

Ecrire un fichier de syndication au format RSS 2.0

Tout d’abord, si les termes “fichier de syndication” ou “RSS” vous sont peu familiers, vous pouvez consulter le tutoriel RSS, RDF, ATOM et syndication de contenu sur ce site pour en savoir plus. Après cette lecture, vous saurez qu’un fichier RSS est en fait un fichier au format XML respectant la syntaxe RSS.

Pour consulter cette syntaxe du langage RSS 2.0, allez ici : http://www.stervinou.com/projets/rss/, cette traduction française de la norme du RSS 2.0 vous sera précieuse. La version originale en anglais est là : http://blogs.law.harvard.edu/tech/rss

Ensuite, ne vous affolez pas, j’ai réussi à en faire donc c’est que ce n’est pas trop compliqué ! Le fichier DOIT être écrit (codé) en UTF-8. Il vous faut donc un logiciel adapté :

Multi-plateformes (Linux, Mac Os X, Windows) : Nvu, logiciel libre et gratuit.
Windows :
- Unired (Version française, gratuit)
- HTML-Kit fait aussi l’affaire.
Mac Os 9 et X : BBEdit Lite ou complet, gratuit pour la version lite.

Ensuite, comme rien ne vaut un bon exemple, en voici deux :
Fil RSS du site de Sophie commenté pour décrire les balises

<?xml version="1.0"  encoding="UTF-8" ?>
/* annonce le langage et l'encodage, l'UTF-8 est bien pour pouvoir utiliser les accents et autres caractères du français, attention à bien utiliser un logiciel qui permet d'enregistrer le document en UTF-8, je ne crois pas que Notepad le fasse sous Windows.*/

<rss version="2.0">
/* la version du langage utilisé, ici j'utilise la norme RSS 2 ci-dessus */

    <channel>
/* le channel c'est la description du site source du fil de nouvelles */

		<title>Le labyrinthe de Sophie</title> 
/* titre du site source obligatoire */

		<description>Mon site personnel contient des photos (de voyage, de nuit, de friches industrielles, de nature  et d'autres), des images 3D, mes expériences professionnelles, mes films, livres, citations et liens préférés</description>
/* description du site source obligatoire */

		<link>http://sophie-g.net/f_titre.htm</link>
/* lien vers le site source obligatoire */

		<language>fr</language>
/* le langage est optionnel, mais c'est pas mal de le préciser */

		<category>Site personnel</category>
/* optionnel, autant de catégories qu'on veut, surtout utile pour les sites web 'moteurs de recherche' ou agrégateurs de fils de nouvelles */
		
		<category>Photographie</category>
		<category>Image</category>
		<category>Architecture</category>
		<category>Voyage</category>
		<category>CSS</category>
		<image>
/*Image optionnelle, apparait quand on fait 'plus d'infos' sur un site, il y a une taille maximale à ne pas dépasser, voir la norme */
		    <url>http://sophie-g.net/pct/sign2.gif</url>
		    <link>http://sophie-g.net/</link>
		    <title>Le labyrinthe de Sophie</title> 
		    <width>20</width>
		    <height>35</height>
		</image>
		<copyright>copyright Sophie G 2004</copyright>
		<generator>Handcoded, baby</generator>
/* Encore des trucs optionnels pour finir le channel */

		<item>
/* Début d'un item de nouvelle */

		    <title>Rayons de soleil</title> 
/* titre ou description sont la seule info obligatoire de l'item */


		    <guid isPermaLink="false">rayonsSoleil20040821</guid>
/* identifiant unique de l'item, optionnel mais très utile pour éviter qu'une modification mineure sur un item le fasse redevenir 'nouveau' dans les lecteurs. Soit un lien permanent sous la forme d'une url (http://sophie-g.net/photo/cieux/ray3.htm) avec isPermaLink="true", soit une chaine de caracteres avec isPermaLink="false"*/

		    <description><![CDATA[<a href="http://sophie-g.net/photo/cieux/ray3.htm"><img src="http://www.sophie-g.net/info/pct/i_rayon3.jpg" width="70" height="70" align="right" alt="Rayons de soleil" border="0" /></a>]]>Des petits rayons de soleil. [Photo - 21 Août 2004]</description>
/* Dans la description, si on veut 'coller' directement du html, il faut l'encadrer avec <![CDATA[ avant et ]]> après. Si on est en utf-8, ne pas mettre de caractères accentués en html de type &eacute; en dehors de ces balises CDATA...*/

		    <pubDate>Sat, 21 Aug 2004 19:30:00 GMT</pubDate>
/* date de publication */

		    <link>http://sophie-g.net/photo/cieux/ray3.htm</link>
/* lien vers la page du site dont on parle, où il y a par exemple l'info complète */

		    <category>Photos</category>
		    <category>Cieux</category>
/* des catégories qui ont la même utilité que celles du channel */

		</item>
/* comme c'est du xml, on ferme toutes les balises */

		<item>
/* et on continue avec l'item suivant */

		    <title>Petit drageon</title> 
		    <guid isPermaLink="false">petitDrageon20040821</guid>
		    <description><![CDATA[<a href="http://sophie-g.net/photo/nature/survive.htm"><img src="http://www.sophie-g.net/info/pct/i_survivor.jpg" width="70" height="70" align="right" 
alt="Drageon" border="0" /></a>]]>Un petit drageon d'arbre qui combat l'asphalte du trottoir. [Photo - 21 Août 2004]</description>
		    
			<pubDate>Sat, 21 Aug 2004 19:00:00 GMT</pubDate>
		    <link>http://sophie-g.net/photo/nature/survive.htm</link>
		    <category>Photos</category>
		    <category>Nature</category>
		</item>
		<item>
/* etc...*/
		</item>

    </channel>
</rss>
/* on n'oublie pas de fermer ses balises, n.b. la balise channel contient tous les items, on ne la ferme qu'à la fin */

Fil RSS assez simple de l’annuaire Ouvaton

<?xml version="1.0"  encoding="UTF-8" ?>

  <rss version="2.0">
    <channel>
      <title>Annuaire non officiel des sites d'Ouvaton</title>

      <link>http://lannuaire.ouvaton.org/</link>

      <description>Les derniers sites inscrits dans l'annuaire</description>

      <language>fr</language>

      <category>Annuaire</category>

      <image>
      	<url>http://lannuaire.ouvaton.org/Images/OvtAnn.gif</url>
      	<title>Annuaire non officiel des sites d'Ouvaton</title>
        <link>http://lannuaire.ouvaton.org/</link>
      </image>

      <item>
        <title>Traduction anglais-français de sites et documents</title>
        <link>http://www.Traduire-en-Francais.com</link>
        <description>Traduction et localisation anglais-français de site internet-web, logiciel informatique, document technique, commercial ou touristique par un traducteur freelance indépendant spécialisé dans ces domaines.</description>
        <pubDate>Mon, 30 Aug 2004 12:01:11 GMT</pubDate>
      </item>

      <item>
        <title>* GERY MANUTENTION | TRANSPORTS DECHETS | MANUTENT</title>
        <link>http://gerymanut.com/</link>
        <description>Gery manutention, drome, rhone-alpes, tout type de transports, dechets DIB et ordures menagers, convoi exceptionnel, manutention</description>
        <pubDate>Thu, 02 Sep 2004 10:55:00 GMT</pubDate>
      </item>

    </channel>
  </rss>

Une fois que votre fichier RSS est fait, il faut mieux le valider en utilisant un validateur :
http://rss.scripting.com/
http://www.feedvalidator.org/

Pour que votre fichier RSS ne soit pas considéré comme un simple fichier xml au passage d’un visiteur, vous devez écrire un fichier .htaccess à la racine de votre site qui contiendra cette ligne :

Ou ajouter cette ligne à votre .htaccess si vous en avez déjà un.

Et voila, c’est pas plus compliqué que cela.

Ceci dit, on peut continuer à jouer avec RSS et php :

On peut installer sur son site un fabricateur automatique de Flux qui rajoute un item quand il faut. Voici, par exemple, le script que j’ai fait et qui rajoute un item lorsqu’un nouveau site est inscrit dans l’annuaire :

<?
/* ATTENTION:
Le fichier MonFil.rss DOIT exister avec toutes les entêtes,
ce script ne fait QUE RAJOUTER un item

Les informations ajoutees sont a passer dans des variables : $titre, $url, $presentation (qu'il sera bon de tester pour verifier leur conformation a la norme)

L'entrée ajoutée au fil sera de la forme :
<item>
  <title> $titre </title>
  <link> $url </link>
  <description> $presentation </description>
  <pubDate> date du jour formatée </pubDate>
</item>
*/
// configuration du script
$fich="MonFil.rss";

// script, ne pas modifier cette partie
$LesLignes=file($fich);
$Total=count($LesLignes);
//print "$Total<br>";
   for ($i = 0; $i <= $Total; $i++)
   {
      if (strpos($LesLignes[$i],"/channel")!=0)
      {
      $Ligne=$i-1;
      break;
      //print "Ligne: $Ligne, suivante: ".strip_tags($LesLignes[$i])."<br>";
      }
   }
$LesLignes[$Ligne+1]=utf8_encode("      <item>");
$LesLignes[$Ligne+2]=utf8_encode("        <title>".stripslashes($titre)."</title>");
$LesLignes[$Ligne+3]=utf8_encode("        <link>$url</link>");
$LesLignes[$Ligne+4]=utf8_encode("        <description>".stripslashes($presentation)."</description>");
$LesLignes[$Ligne+5]=utf8_encode("        <pubDate>".date("D, d M Y H:i:s ")."GMT</pubDate>");
$LesLignes[$Ligne+6]=utf8_encode("      </item>");
$LesLignes[$Ligne+7]=utf8_encode("");
$LesLignes[$Ligne+8]=utf8_encode("    </channel>");
$LesLignes[$Ligne+9]=utf8_encode("  </rss>");

$Total=count($LesLignes);
//print "$Total<br>";
/* OUVRIR LE FICHIER */
$fp=fopen("$fich","w+");
fseek($fp,0);
   /* ECRIRE LE NOUVEL ENREGISTREMENT */
   for ($i = 0; $i <= $Total; $i++)
   {
   $string=Chop($LesLignes[$i])."\n";
   fputs($fp,$string);
   }

/* FERMER LE FICHIER */
fclose($fp);
?>

Il existe aussi des Editeurs Rss en ligne :
http://www.webreference.com/cgi-bin/perl/rssedit.pl
http://www.webdevtips.com/webdevtips/codegen/rss.shtml

Mais bon, c’est tellement plus rigolo de faire ces trucs tout seul !

Aller, bon flux, bon aggrégateur et tout ce genre de choses.

P.-S.

Tutoriel publié par Old P’pou

Ouvaton, coopérative de services internet

ouvaton

Langue d'affichage

rechercher sur le site

devenir

actuel

webmail

panel

Mots-clés :

Ecrire un fichier de syndication au format RSS 2.0

P.-S.

Dans la même rubrique