ExplorEQR version 0.11 alpha
Outil d'exploration des arborescences d'exercices au format EQR.
Copyright (C) 2009 Jean Marc Wehrlen, courriel jmarc.wehrlen chez Free en France.
Programme écrit en langage java version 1.6.0, interface graphique développée avec netbeans 5.5.
TÉLÉCHARGEMENT :
ExplorEQR est inclus dans ExoQRJ à partir de la version 0.3 r4. Consultez le fichier "Lisez-moi" sur ExoQRJ
pour en savoir plus, vous y trouverez également des liens pour
télécharger ExoQRJ (et donc ExplorEQR), ainsi qu'un lien
à la rubrique "Liste des dossiers fournis" avec ExoQRJ pour
revenir à ce fichier "Lisez-moi" sur ExplorEQR.
SOMMAIRE:
1) PRÉSENTATION SUCCINTE
2) LISTE DES FICHIERS FOURNIS
3a) LISTE DES DOSSIERS FOURNIS, avec leur contenu
3b) PRECISIONS SUR LA STRUCTURE DU DOSSIER "exercices"
4) INSTALLATION
5) PROBLEMES D'ACCENTS
6) RACCOURCIS CLAVIER
7) INDICATION DE LICENCE
8) LICENSE INDICATION in English
9) LICENCE DE JAVA
1) PRÉSENTATION SUCCINTE
ExplorEQR est un programme qui permet de visualiser l'arborescence d'un
dossier et de ses sous-dossiers d'exercices au format EQR.
Les exercices
sont listés avec un résumé en une ligne
du thème traité par l'exercice.
Dans la barre de titre on voit le nombre total de fichiers eqr de
l'ensemble de l'arborescence (dans l'illustration, il s'agit de tous
les fichiers contenus dans les sous-répertoires du dossier
"exercices"). Ceci donne immédiatement une idée de la "richesse" en
fichiers EQR d'une arborescence donnée.
Sur demande, un
résumé plus détaillé de l'exercice, avec uniquement les questions et les prompts,
apparaît (double-clic, menu popup "Montrer", bouton ou ALT + M).
On peut ouvrir autant de résumés d'exercices que l'on veut, ce qui permet de les comparer.
Par défaut, ExplorEQR tente d'ouvrir en priorité le
sous-dossier nommé "exercices" qui se trouve dans le dossier parent d'ExplorerEQR. En cas d'absence d'un tel
sous-dossier "exercices", il ouvre le dossier dans lequel
est placé ExplorEQR ; il faut alors chercher et définir
un dossier d'exercices eqr en naviguant à l'aide de la
fenêtre d'ouverture de dossier (menu popup "Racine", bouton ou
ALT + R).
Cet outil est destiné à expliciter les exercices dont les
noms de fichiers peuvent parfois, par la force des choses,
paraître sibyllins. Cependant, les
résumés "détaillés" ne comprennent pas les
réponses attendues, afin d'éviter que des
utilisateurs finaux d'ExoQRJ, par exemple, en prennent connaissance, involontairement ou non. Pour
voir tous les détails d'un exercice, y compris les
réponses et éventuellement les sons, utiliser
EcriQRJ.
ExplorEQR est destiné à fonctionner en tant que
sous-ensemble du projet ExoQRJ, bien qu'il puisse chercher des dossiers
"exercices" en dehors du projet ExoQRJ duquel il fait partie (avec la
fonction "Racine..."). En cas de changement de la racine de
l'arborescence, il est conseillé de viser effectivement une
arborescence de fichiers EQR et de ne pas tenter d'ouvrir une vue de
votre système de fichiers comprenant des dizaines de milliers de
fichiers quelconques (le temps d'analyse de l'arborescence avant
affichage pouvant alors être assez long, l'opération
pouvant même saturer certains composants du programme).
2) LISTE DES FICHIERS FOURNIS
* ExplorEQR_0.11_alpha.jar (qui est "le programme" proprement dit).
* ExplorEQR_0.11_alpha ; ne sert que sous Linux. C'est un script bash
pour lancer le programme ExplorEQR contenu dans l'archive jar (fonctionne
à condition
qu'il y ait un lien dynamique nommé java1.6 dans le PATH vers
.../jre.../bin/java, sinon changer "java" à la place de "java1.6" dans le script
bash - voir les détails dans la partie INSTALLATION).
* splashExplorEQR_0.11.jpg : image se lançant pendant le chargement
du programme (et de la machine virtuelle java) - uniquement
invoqué dans le script pour Linux.
* historique.txt : fichier de traçabilité de l'évolution des versions et releases.
* lisez-moi.html ; ce fichier.
3a) LISTE DES DOSSIERS FOURNIS, avec leur contenu
* Le dossier "licences" : contient "GNU_GPL_licenceV2.txt" (la licence
GNU/GPL version 2 en version originale
(anglais)) et "licence_traduction_français.txt" (une
traduction non officielle
en français de la licence GNU/GPL (copyright FSF France)).
* Le dossier "sources" : contient les archives du projet netbeans (pour
l'interface graphique) et 4 fichiers sources du programme ExplorEQR, originalement écrits sous Linux au format UTF-8 ; de
ce fait, la consultation sous d'autres systèmes d'exploitation
avec un autre format pour les fichiers textes
est possible, mais le retour à la ligne ne se fera
peut-être pas comme prévu, et il peut y avoir des
problèmes de représentation des lettres accentuées
et des c-cédilles. Les fichiers sources sont : Exercise.java,
LearningItem.java, NewFrame.java et TitleViewer.java.
3b) PRECISIONS SUR LA STRUCTURE DU DOSSIER "exercices"
Le dossier "exercices" contient des fichiers au format .eqr,
représentant les exercices à faire avec l'aide d'ExoQRJ.
Pour les exercices avec sons, il existe des sous-dossiers regroupant
les sons. Ces sons peuvent être sous différents formats
(wav, mp3, ogg, au, aiff) et fonctionnent avec ExoQRJ et EcriQRJ, même si le
système d'exploitation utilisé ne connaît
normalement pas certains formats (sauf avec Windows 98).
Dans le dossier "dictees", il y a aussi un sous-dossier
"fiches_papier", dans lequel se trouve des documents à imprimer
en direction des élèves et des enseignants (ou des
apprenants et des adultes hors contexte scolaire), dans le cas
où un scénario pédagogique demanderait la
préparation d'un exercice ou l'apprentissage d'une leçon.
ExplorEQR recherche les extensions .eqr des fichiers avant d'en
extraire le "titre". Pour ExplorEQR, en cas d'absence d'extension .eqr,
le fichier est réputé ne pas être au format EQR ;
ExplorEQR liste néanmoins ces fichiers lorsqu'il expose une
arborescence, en indiquant qu'ils ne sont pas au format EQR.
Rappel : en cas de changement de la racine de l'arborescence, il est conseillé
de viser effectivement une arborescence de fichiers EQR et de ne pas
tenter d'ouvrir une vue de votre système de fichiers comprenant des
dizaines de milliers de fichiers quelconques (le temps d'analyse de
l'arborescence avant affichage pouvant alors être assez long,
l'opération pouvant même saturer certains composants du programme).
4) INSTALLATION
ExplorEQR faisant partie du projet ExoQRJ, l'installation d'ExoQRJ installera automatiquement ExplorEQR.
A la base, quel que soit le système d'exploitation, il y a trois étapes :
A) Installez java 1.6 (si ce n'est déjà fait). La procédure est expliquée pour ExoQRJ sous Windows - sous Linux.
B) Copiez le répertoire ExoQRJ_<référence version> sur votre système.
C) Lancez le programme.
Sous Windows :
Allez dans le sous-répertoire ExplorEQR et
double-cliquez sur le fichier ExplorEQR_0.11_alpha.jar (le fichier avec
l'icône de tasse de café).
Sous Linux :
- En ligne de commande : dans le sous-répertoire ExplorEQR,
vérifiez que le fichier ExplorEQR_0.11_alpha est
exécutable (sinon tapez "su", le mot de passe administrateur,
puis "chmod 755 ExplorEQR_0.11_alpha"), puis tapez
"./ExploprEQR_0.11_alpha" (sans l'extension .jar ; il s'agit d'un
fichier de script qui lance ExplorEQR avec un lien nommé java1.6
qui doit être dans /usr/bin, voir ici en cas de besoin).
ou tapez "java -jar ExplorEQR_0.11_alpha.jar" ou encore "java1.6 -jar
ExplorEQR_0.11_alpha.jar" si vous avez le lien java1.6 dans /usr/bin.
- Avec l'interface graphique : dans le sous-répertoire
ExplorEQR, vérifiez que le fichier ExplorEQR_0.11_alpha est
exécutable (sinon, clic droit, propriétés, onglet
"droits d'accès" ou "permissions", cochez "exécutable"), puis
double-cliquez sur ce fichier.
Autres systèmes d'exploitation :
Il faut installer le jre
(Java Runtime Environment) version 1.6 ou compatible, à
télécharger sur internet, aller dans le sous-répertoire ExplorEQR du projet ExoQRJ, et lancer l'archive jar
contenue dans ce
répertoire, selon les habitudes propres à votre
système d'exploitation. Merci d'avance de m'informer si les
programmes ont été installés et lancés sous
d'autres systèmes d'exploitation, je pourrais ainsi
compléter la documentation.
5) PROBLEMES D'ACCENTS
En passant d'une distribution Linux à
l'autre, ou de Windows à Linux ou réciproquement, les
caractères accentués dans les fichiers .eqr peuvent ne
pas être représentés correctement. Il en est de
même dans les fichiers source. Cela vient du fait que les
différents sytèmes n'utilisent pas exactement la
même norme pour les caractères accentués dans les
fichiers .txt (et .eqr est au format .txt). J'ai personnellement
été confronté à deux formats
utilisés en France, soient iso 8859-15 (ou assimilé) et utf-8. J'ai
limité l'usage des accents dans les noms de fichiers et dans le
code source (c'est pourquoi les noms de variables et les commentaires
sont en globish). D'autre part, il n'y a pas de problèmes
d'accent dans l'utilisation des fichiers .eqr, car ceux-ci sont
automatiquement convertis par le programme (il essaie la norme
éventuellement indiquée dans l'attribut "encoding", sinon la
norme iso 8859-15 et la norme utf-8). Certains éditeurs de texte
permettent de convertir des fichiers d'une norme à l'autre (ex.
Kate ou KWrite : menu Outils->Encodage).
6) RACCOURCIS CLAVIER
ALT + M : montrer le résumé détaillé d'un
exercice (si un exercice est sélectionné) ou
déplier le dossier (si c'est un dossier qui est
sélectionné).
Entrée : idem que ALT + M.
ALT + R : changer la racine de l'arborescence.
Control + Q : quitter
Il y a un menu popup qui apparaît avec un clic droit dans l'interface, et qui reprend toutes ces fonctionnalités.
7) INDICATION DE LICENCE
ExplorEQR_0.11 et les fichiers associés au format xml
d'extension .eqr sont des logiciels libres ; vous pouvez les
redistribuer et/ou les modifier au titre des clauses de la Licence
Publique Générale GNU, telle que publiée par la
Free Software Foundation, version 2 de la Licence. Ces programmes sont
distribués dans l'espoir qu'ils seront utiles, mais SANS AUCUNE
GARANTIE ; sans même une garantie implicite de COMMERCIABILITE ou
DE CONFORMITE A UNE UTILISATION PARTICULIERE. Voir la Licence Publique
Générale GNU pour plus de détails. Vous devriez
avoir reçu un exemplaire de la Licence Publique
Générale GNU avec ce programme ; si ce n'est pas le cas,
écrivez à la Free Software Foundation Inc., 51 Franklin
Street, Fifth Floor, Boston, MA 02110-1301, USA.
8) LICENSE INDICATION in English
ExplorEQR_0.11 and the associated xml formatted .eqr files are
free software; you can redistribute them and/or modify them under the
terms of the GNU General Public License as published by the Free
Software Foundation, version 2 of the License.
These programs are distributed in the hope that they will be useful,but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
9) LICENCE DE JAVA
ExplorEQR a besoin de Java (version 1.6 minimum) pour fonctionner.
A titre d'information, la licence (en Anglais) pour le jre 1.6 release
3 livré dans certains packages de ExoQRJ est fournie dans le dossier "jre", lorsque ce
dernier est présent.
Si vous avez vous-même téléchargé ou
disposez de Java, indépendemment d'ExoQRJ ou d'ExplorEQR,
reportez-vous à la licence contenue dans la documentation de
votre version de Java.
