Générer les supports de cours
Installer les makefiles
Dans l'arborescence logidee-tools
Si vous avez une copie de l'arborescence logidee-tools
obtenue soit depuis les sources soit simplement en copiant
/usr/share/logidee-tools, alors vous pouvez
placer vos documents XML dans le sous-répertoire xml
et sans rien modifier, vous n'avez qu'à lancer
make makefiles depuis la racine de l'arborescence
logidee-tools. Vous devriez voir ceci :
$ make makefiles
Creating Makefile in doc
Creating Makefile in xml
$
Dans une arborescence à part
Si vous avez choisi (et c'est un choix très raisonnable) d'avoir
vos documents dans une arborescence à part, alors vous devez préparer
cette arborescence afin de pouvoir utiliser logidee-tools sur vos
documents XML. Pour effectuer cette tâche vous allez utiliser
setup-logidee-tools (correspondant à bin/setup
dans l'archive source). Ce petit script doit être lancé depuis la racine
de l'arborescence de documents. Il accepte en paramètre une liste des
sous-répertoires contenant des documents XML. Vous pouvez également
préciser à l'aide du paramètre « -r » le répertoire où sont
présents les fichiers de logidee-tools que vous souhaitez utiliser.
Si vous ne précisez pas ces paramètres, le script va vous interroger
de manière interactive. Deux exemples d'utilisation :
$ setup-logidee-tools -r /usr/share/logidee-tools \
programmation outils reseau
Creating Makefile in programmation
Creating Makefile in outils
Creating Makefile in reseau
$ setup-logidee-tools
Where is the main directory of logidee-tools ?
Main directory of logidee-tools: /usr/share/logidee-tools
Which directories may contain xml documents ?
Give a space delimited list of directories : programmation \
outils reseau
Creating Makefile in programmation
Creating Makefile in outils
Creating Makefile in reseau
$
Note |
Dans tous les cas, il est souhaitable que les
documents XML soient dans des sous-répertoires de premier niveau de
l'arborescence des documents. Ceci est souhaitable pour harmoniser les
inclusions de documents et des images. Le détail de ces problèmes est
donné dans la partie traitant de la rédaction des documents.
|
Utiliser les makefiles
Générer les PDF et autres pages HTML n'est qu'une question d'appeler
les bonnes cibles des fichiers Makefile que l'on vient d'installer.
Voici les cibles génériques qui vous seront les plus utiles :
-
make pdf : génère tous les documents PDF possibles, y
compris les diaporamas ;
-
make ps : génère tous les documents PostScript
possibles ;
-
make 2pp : génère tous les documents PostScript
possibles en mode 2 pages par feuille ;
-
make tex : génère tous les documents LaTeX
possibles ;
-
make html : génère tous les documents HTML
possibles ;
-
make slideshow : génère tous les diaporamas
possibles ;
-
make check : vérifie la validité de l'ensemble des
fichiers « *.xml » vis à vis de la DTD ;
-
make clean : supprime tous les fichiers intermédiaires
créés mais conserve les .ps, .pdf et .html générés;
-
make realclean : supprime tous les fichiers
intermédiaires et tous les fichiers générés.
Voici une revue d'ensemble des autres cibles disponibles :
-
make formations : génère tous les supports de cours
« formation*.pdf » à partir des documents
« formation*.xml » ;
-
make formations_show : génère tous les diaporamas
« formation*_slideshow.pdf » à partir des documents
« formation*.xml » ;
-
make formations_2pp : génère tous les supports
de cours « formation*_2pp.ps » en version 2 pages par feuille
à partir des documents « formation*.xml » ;
-
make themes : génère tous les supports de cours
« theme*.pdf » à partir des documents
« theme*.xml » ;
-
make themes_show : génère tous les diaporamas
« theme*_slideshow.pdf » à partir des documents
« theme*.xml » ;
-
make themes_2pp : génère tous les supports
de cours « theme*_2pp.ps » en version 2 pages par feuille
à partir des documents « theme*.xml » ;
-
make fichier : génère le support de cours
« fichier.pdf » et le diaporama
« fichier_slideshow.pdf » à partir de
« fichier.xml » ;
-
make fichier.pdf : génère le PDF adéquat à partir
de « fichier.xml » ;
-
make fichier_2pp.ps : génère le fichier
« fichier_2pp.ps » avec 2 pages par feuille à partir
de « fichier.xml » ;
-
make module.html : génère les pages HTML
« module.html/*.html » à partir de « module.xml ».
Le répertoire module.html est prêt à l'emploi, vous
pouvez le copier sur votre site web sans rien changer ;
-
make module.txt : génère une version texte
« module.txt » à partir de « module.xml » ;
-
make fichier.xml-check : vérifie la validité de
« fichier.xml ».
Il est possible de définir des variables d'environnement pour altérer la
génération des documents.
- CHARTE : valeur par défaut « default ». Cette variable
permet de choisir la charte graphique utilisée pour générer les documents.
- TRAINER : valeur par défaut « false ». En positionnant
cette variable à « true » vous incluerez les notes réservées
aux formateurs.
- SELECTION : valeur par défaut « all ». En positionnant cette
variable à un mot-clé vous n'incluerez que les données
spécifiques à ce mot-clé (cf attribut "restriction") et laisserez de côté
les données spécifiques aux autres mots-clés.
- CYCLE : valeur par défaut « false ». En positionnant cette
variable à « true », vous indiquez que la présentation doit
utiliser en cycle une série de fonds d'écran indiquées dans la charte
graphique.
- LANG : valeur par défaut « en » (langue anglaise). En
positionnant cette variable à « fr » vous pouvez générer des
documents totalement en langue française.
Exemple :
$ make formations SELECTION=debian TRAINER=true LANG=fr