Générer les supports de cours

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
   $

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
$

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 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 : génère les .:pages HTML « module/* » à partir de « module.xml ». Le répertoire module 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 « none ». En positionnant cette variable à un ou plusieurs mots-clés (séparés par des espaces) vous n'incluerez que les données spécifiques à ce(s) mot(s)-clé(s) (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

—- Reproduction interdite - Mentions légales et remerciements.
Document généré avec les outils Logidée.