Jaxe pour UVED

Jaxe a été présenté lors du séminaire inter-UNT sur les chaînes éditoriales les 18 et 19 septembre 2007 à Angers. Une vidéo de la présentation est disponible sur ce site.

Introduction

Remarque: ce texte n'est pas à jour en 2012 !

L'UVED (Université Virtuelle Environnement et Développement Durable) soutient la création de contenus de cours en ligne destinés à être rassemblés sous une interface commune. Pour permettre techniquement l'utilisation de contenus réalisés par divers organismes, le groupe technique a choisi de se baser sur XML, et a défini un schéma XML pour l'UVED. Toutes les productions UVED doivent respecter ce schéma afin de pouvoir être intégrées, à la fois dans UVED et pour d'autres projets.

Jaxe, un éditeur XML configurable pour un langage XML donné, est l'une des solutions permettant de créer des contenus en XML. Il propose une interface graphique conviviale, tout en permettant la création de documents XML valides (c'est à dire conformes au schéma XML).

Jaxe est téléchargeable ci-dessous avec le schéma UVED et le fichier de configuration correspondant (s'il était téléchargé directement sur le site de Jaxe il ne comprendrait pas le schéma et le fichier de configuration).

Configuration requise

    Un système (Mac, UNIX, Windows ou autre) avec une version de récente de Java (au moins 1.5). Pour tester la version de java de votre système, vous pouvez taper "java -version" sous la ligne de commande.

Installation

• Télécharger le fichier d'archive - Jaxe version 3.1 avec la configuration UVED 2.0 du 16/9/2008 et inter-UNT du 21/11/2008 :
  • Sur MacOS X: jaxe-uved2-macosx.dmg
  • Sur UNIX: jaxe-uved2-unix.tar.gz
  • Sur Windows: jaxe-uved2-windows.zip
  Remarque: il existe des versions plus récentes de Jaxe, et la configuration UVED doit normalement toujours marcher avec. Pour les utiliser, il suffit de recopier les éléments suivants du dossier config: UVED2.xsd, UVED2_config.xml, UVED2_vers_interunt.xsl et UVED2_XSL, et de recopier le fichier plugins/jaxeuved.jar.
• Décompacter le fichier. En général il suffit de double-cliquer dessus ou de faire un clic droit et de choisir "décompacter ici", mais il peut être nécessaire d'utiliser un programme comme Stuffit Expander, ou la commande "tar xvzf jaxe-uved-unix.tar.gz" sur UNIX, ou encore 7-Zip sur Windows.
• Placer le dossier résultant où on le souhaite sur le disque dur (par exemple dans /Applications sur MacOS X ou dans Program Files sur Windows).
• Sur Windows, lancer le fichier assocXMLJaxe.bat pour que les fichiers XML s'ouvrent directement avec Jaxe quand on double-clique dessus. Sur Mac, on peut faire le lien en choisissant le menu "Lire les informations" d'un fichier XML, en choisissant Jaxe dans "Ouvrir avec", et en cliquant sur "Tout modifier".

Comment utiliser Jaxe

Pour l'utilisation de Jaxe, voir le guide utilisateur.

Pour comprendre l'organisation des documents UVED, voir le modèle, et la documentation du schéma UVED générée automatiquement.

Organisation des dossiers

L'arborescence des contenus se fait dans l'ordre Contenus/Chapitre/Partie/Sous-partie. L'ensemble des fichiers XML doit se trouver dans un dossier projet, contenant un fichier XML avec le plan du cours (l'élément CONTENUS), et un dossier pour chaque chapitre du cours. Chaque dossier de chapitre contient un fichier XML avec le chapitre, et les dossiers des différentes parties. Chaque dossier de partie contient un fichier XML pour la partie et les dossiers des sous-parties. Les images doivent se trouver dans le dossier du fichier XML qui les référence (ou un sous-dossier particulier). Les fichiers XML doivent contenir un chapitre, partie ou sous-partie avec un label identique au nom du dossier et du fichier XML. Par exemple on peut avoir un dossier etoiles contenant un fichier etoiles.xml qui contient une partie avec le label etoiles.

Pour obtenir un site avec la charte graphique UVED

Placer un dossier site au même niveau que le dossier projet. Dans ce dossier site, placer le dossier medias (version 2012) (ancienne version). L'aperçu HTML de Jaxe va alors générer un dossier html dans le dossier site, avec le site correspondant à la charte graphique.

Modèle de projet

Un modèle de projet en XML est disponible ici : modele_v3.zip

Envoi des contributions sur un serveur FTP

Il est possible d'ajouter un menu pour envoyer une contribution automatiquement sur un serveur FTP, en ajoutant l'élément suivant sous le menu plugins dans le fichier de configuration de Jaxe :

    <FONCTION classe="pluginsjaxe.EnvoiContrib" titre="Envoi sur le serveur">
        <PARAMETRE nom="serveur" valeur="adresse.du.serveur"/>
        <PARAMETRE nom="dossier" valeur="dossier/destination/sur/le/serveur"/>
    </FONCTION>

Convertisseur de module du langage UVED 2.0 vers le langage inter-UNT

Il est possible avec Jaxe d'exporter un fichier UVED vers le langage inter-UNT, mais cela peut être un peu long de convertir un module entier, avec de nombreux fichiers XML, d'un langage à l'autre. Nous avons donc réalisé un convertisseur pour transformer un module entier, et copier automatiquement tous les fichiers associés vers le dossier de destination.

Téléchargement: ConversionInterUNT.zip

Utilisation: pour le lancer, il suffit de double-cliquer sur le fichier ConversionInterUNT.jar avec MacOS X ou Windows. Avec Linux, on peut le lancer avec un clic droit sur l'icône, en choisissant le menu pour ouvrir le fichier jar avec la machine Java. Le module UVED doit se trouver dans un dossier projet. On sélectionne le fichier XML principal dans le dossier projet, et le dossier de destination dans lequel les fichiers XML convertis et les fichiers associés seront copiés.

Le code source de Jaxe

Est disponible sur SourceForge.