Cette contrib a pour vocation de montrer comment vous pouvez rendre vos fils RSS lisibles en ligne. De la même manière que l’excellent pluggin pour firefox FeedView.
Deux exemples de l’utilisation de la méthode II sont disponibles ici :
http://www.cassiopea.org/backend.ph...
http://www.educa21.be/backend.php3?...
Méthode I : ajouter un css au xml
La méthode la plus simple pour styliser vos flux rss consiste à faire un appel vers une feuille de style en haut de votre fichier backend.html [1] :
<?php echo '<?xml version="1.0" encoding="#CHARSET"?>
<?xml-stylesheet type="text/css" href="chemin/xml.css" ?>'; ?>
Puis de créer une feuille de style CSS qui habillera le xml, par exemple :
Cette feuille de style permettra de mettre en forme les balises xml de votre fil rss avec toutes les potentialités du css, ce qui améliore déja de beaucoup l’affichage de votre flux. Le problème c’est que malgré la feuille de style, ce qui s’affiche dans le navigateur est toujours du xml, et vos titres ne seront donc pas cliquables. Pour cela il faut générer du html a partir du backend.
Méthode II : générer du html a partir du fil rss avec la technologie xsl
Installation rapide
- décompressez l’archive.
- copiez le répertoire /xml/ par ftp dans le répertoire ou vous avez installé spip
- ajoutez en haut de votre squelette backend.html l’appel à la feuille xsl, à l’aide de l’instruction suivante.
<?php echo '<?xml version="1.0" encoding="#CHARSET"?>
<?xml-stylesheet type="text/xsl" href="xml/xml.xsl" ?>'; ?>
Personalisation & explications
Cette méthode vous permet de générer du html lors de l’affichage dans le navigateur, et donc de le mettre en forme selon vos souhait, comme n’importe quelle page web.
Pour cela il est nécessaire d’ajouter un appel vers le fichier xml en haut de votre backend :
<?php echo '<?xml version="1.0" encoding="#CHARSET"?>
<?xml-stylesheet type="text/xsl" href="xml/xml.xsl" ?>'; ?>
Ensuite vous pouvez construire un fichier xsl qui va générer le html. Le langage xsl fonctionne un peu comme des boucles spip ;-). Voici un exemple de fichier xsl :
<?xml version="1.0" encoding="iso-8859-1"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html"/>
<xsl:template match="/rss" >
<xsl:for-each select="channel">
<html xml:lang="{language}">
<head>
<title><xsl:value-of select="title" /></title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<link rel='stylesheet' href='custom/style/xml/xsl.css' type='text/css'/>
</head>
<body>
<div class="channel">
<h1><a href="{link}"><xsl:value-of select="title" /></a></h1>
<p class="descriptif_rss"><xsl:value-of select="description" /></p>
<xsl:for-each select="item">
<div class="post">
<a href="{link}" title="{description}"><xsl:value-of select="title" /> </a>
<p class="descriptif"><xsl:value-of select="description" /></p>
</div>
</xsl:for-each>
</div>
<hr />
</body>
</html>
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
Il s’agit globalement d’une page html, dans lesquel des boucles vont être effectuées pour chaque « item » présent dans votre fichier backend. Voici une portion du code ci-dessus, qui montre assez clairement ces « boucles » :
<xsl:for-each select="item">
<div class="post">
<a href="{link}" title="{description}"><xsl:value-of select="title" /> </a>
<p class="descriptif"><xsl:value-of select="description" /></p>
</div>
</xsl:for-each>
En haut de notre fichier xsl, nous avons bien entendu placé un appel vers une feuille de style css, pour habiller le code html produit, et le tour est joué !
Discussions par date d’activité
5 discussions
Bonjour !
Ne sachant pas si je poste dans le bon forum je m’en excuse d’avance.
Mon site : un squelette avec frames et boutons sous flash qui fonctionne très bien (merci spip 1.8.3 ! ;)
Mon problème : Le flux RSS du lien
feed ://www.monsite/backend.php3
répertorie les articles modifiés oki.
Mais si je clique sur les liens je suis redirigé vers l’article (et l’article seul)
Ce que je voudrais : Que les liens des articles du flux RSS redirige systématiquement vers ma page d’accueil.
Ma question : Savez-vs quel fichier et comment je dois modifier le code ?
Merci d’avance pour toute contribution
Max
RESOLU
par ici
Répondre à ce message
Très intéressant comme tutoriel pour manipuler mon premier fichier xsl. Merci
une petite correction, dans le fichier xsl, le lien sur la feuille de style n’est pas :
href=’custom/style/xml/xsl.css’
mais :
href=’xml/xsl.css’
Cette contrib m’interresse au plus haut point, dans le sens où j’ai souvent affaire à des personnes qui ne connaissent pas l’existence de feed reader.
J’avais par contre un soucis en faisant un copier/coller de l’entête.
J’ai donc fait une recherche sur le format xsl et j’ai fini par faire le lien légèrement différement vers le fichier xsl dans mon backend.html
Avec cette entête, j’ai réussit à afficher la mise en forme du fil rss que je n’affichait pas avec l’entête que vous proposez.
j’obtenais une horrible page avec uniquement le contenu sans retour chariot, sans mise en forme, rien...
Si cette manip peut servir à quelqu’un... ;-)
Amusante coincidence, je travaillait a l’export de ma contrib pour wikini, et j’étais bloqué par un problème de charset, résolu par ta manip.
Après renseignements, il semblerais en effet qu’il est important de spécifier le charset dans le header(), sans quoi le navigateur prend le charset préféré du navigateur...
Répondre à ce message
B’jour, Est-il possible de récupérer le code qui génère la petite fenètre « Cette page est un flux de syndication destiné à être inclus dans un agrégateur rss ou un autre site web
(...) »
C’est une combinaison de plusieurs codes :
1. ajouter
<textInput><:texte_syndication:><textInput>
dans backend.html, dans les éléments propres à l’ensemble du flux. exemple :2. ajouter
'texte_syndication' => 'Cette page est un flux de syndication...',
dans vos fichiers langues de spip (exemple local_fr.php3).3. ajouter dans le fichier xml.xsl, avant
<xsl:for-each select="item">
4. ajouter le style css dans xml.css :
Et voila !
Merci je vais essayer de suite !
Répondre à ce message
Hello,
Ca ne marche pas (testé sous spip 1.8.1 et firefox).
Soyez plus précis svp , faut-il remplacer les lignes déjà présentes dans le backend.html :
ou faut-il rajouter les lignes que vous indiquez en supplement ?
Oui il faut remplacer ces premières lignes.
Répondre à ce message
Pour ceux qui ont besoin d’aide sur XSL, je vous conseille le labo de Zvon. Description de tout les méthodes, fonctions etc.. et des tests en ’live’.
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 :
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.
Suivre les commentaires : |