Table des matières

Page précédente Sommaire Page suivante

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 :

Voici une revue d'ensemble des autres cibles disponibles :

Il est possible de définir des variables d'environnement pour altérer la génération des documents.

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.