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
$

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.

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.