Introduction

ESUP-Lecture permet de rendre n'importe quel flux XML.

Voir le Configuration guide et sa partie consacrée au fichier mappings.xml pour comprendre comment associer une feuille de style XSLT à un ou des flux XML suivant leur URL, leur DTD, etc.

Par défaut, ESUP-Lecture est livré avec 2 XSLT que les établissements peuvent enrichir.

Depuis la version 2.0 RC5 ESUP-Lecture utilise JQuery pour ajouter de l'ergonomie à la lecture des items. Pour activer au pas ces comportements il faut mettre des classes css sur certains éléments. Ces classes sont positionnables dans les fichiers XSLT. Cette page à pour vocation d'expliquer le comportement associé à ces classes.

Comportements

Comportements de base

Exemple de XSLT :

<?xml version="1.0"?>
 <xsl:stylesheet version="1.0"
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:b="http://purl.org/rss/1.0/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
    <xsl:output method="html" encoding="utf-8" />
    <xsl:template match="/">
        <div class="lecture-clikable lecture-highlightable">
            <h1>
                <xsl:value-of select="/b:item/b:title" />
            </h1>
            <div class="lecture-link">
                Lien :
                <a href="{/b:item/b:link}">
                    <xsl:value-of select="/b:item/b:link" />
                </a>
                <br />
            </div>
            <xsl:value-of select="/b:item/b:description"
                disable-output-escaping="yes" />
        </div>
    </xsl:template>
</xsl:stylesheet>

Mise en surbrillance des items

Pour mettre en surbrillance un item au passage de la souris il suffit d'ajouter la classe lecture-highlightable à la div entourant le contenu de l'item.

Autres fichiers utilisés :

• esup-lecture.js --> pour gérer les événements de la souris
• esup-lecture.css --> pour la définition de la css ajoutée dynamiquement par JQuery

Gestion du clic sur les items

Pour rendre un item cliquable il faut faire deux choses :

• Ajouter la classe lecture-clikable à la div entourant le contenu de l'item.
• Ajouter la classe lecture-link à une div contenant la balise <a> correspondant au contenu lié à l'item

Autres fichiers utilisés :

• esup-lecture.js --> pour
  • Gérer le clic de la souris qui a deux effets :
    • Charger l'état de l'item (passer de non lu à lu par ex.)
    • Afficher dans une nouvelle fenêtre le contenu lié à l'item
  • Masquer le contenu de la balise div avec la classe lecture-link
  • Changer la forme du curseur de la souris

Comportements ajoutés par personnalisation