Changes between Version 2 and Version 3 of document

Timestamp:

Apr 21, 2011, 10:52:33 PM (15 years ago)

Author:

g7moreau

Comment:

Makefile

document

@@ -24 +24 @@
 de séparer le code source, gérer par un gestionnaire de code source,
 des fichiers temporaires ainsi que des fichiers finaux.
-Ainsi, seul le fichier source est important à sauver,
+Ainsi, seul les fichiers sources sont importants à sauver,
 à archiver, à transmettre...
 
@@ -67 +67 @@
  - {{{/chemin/du/projet/doc}}} :
    dossier où seront placés les documents finis.
+
+On remarque que tous ces fichiers sont placés dans des sous dossiers
+qui sont au même niveau que le dossier {{{/src/}}}.
+C'est une bonne manière de procéder.
+
+== {{{Makefile}}} ==
+
+La commande {{{make}}} interprète par défaut le fichier {{{Makefile}}}
+du dossier courant.
+Ce programme est un moteur d'inférence qui applique les règles
+selon les contraintes les liants.
+Il faut savoir qu'il y a une règle de base implicite qui se base sur la date
+de chaque fichier.
+Ainsi, la modification d'un fichier, d'une figure... entraîne
+la reconstruction du document final mais aussi des figures intermédiaires
+si nécessaire...
+
+Cependant, la compilation d'un document TeX peut être long.
+Il faut compiler plusieurs fois,lancer le gestionnaire de bibliographie {{{BibTeX}}},
+recompiler...
+Il est le plus souvent inutile de refaire tous ses étapes pour le moindre changement,
+il y a donc dans le {{{Makefile}}} des cibles pour gagner du temps
+et ne faire que des compilations partielles.
+
+Attention cependant pour la version finale de bien compiler suffisamment !
+Il y un cible {{{touch}}} qui modifie la date du document principal
+et permet de relancer la compilation de celui-ci par {{{make}}}
+même sans modification de celui-ci
+({{{make}}} fonctionne par défaut sur la date des fichiers
+et non sur un système de checksum type {{{md5sum}}}).
+
+Après cette longue introduction, voici les cibles utiles :
+
+ - {{{all}}}       -> compilation complète
+ - {{{dossier}}}   -> création des dossiers du projet
+ - {{{clean}}}     -> nettoyage partiel
+ - {{{pdf}}}       -> compilation simple avec dépendance -> pdf
+ - {{{dvi}}}       -> compilation simple avec dépendance -> dvi
+ - {{{xpdf}}}      -> visualisation du résultat pdf
+ - {{{xdvi}}}      -> visualisation du résultat dvi
+ - {{{gv}}}        -> visualisation du résultat ps
+ - {{{warning}}}   -> liste de tous les warnings
+ - {{{review}}}    -> liste de toutes les remarques
+ - {{{pdflatex}}}  -> compilation du source tex -> pdf
+ - {{{latex}}}     -> compilation du source tex -> dvi
+ - {{{bibtex}}}    -> compilation du source bibtex
+ - {{{protect}}}   -> protection du dossier source
+ - {{{unprotect}}} -> suppression de la protection
+
+Ce {{{Makefile}}} a été conçu il y de nombreuses années (début 2000).
+De nombreux logiciels nouveaux sont apparus
+et une mise à jour de celui-ci peut s'avérer nécessaire dans le détail.
+
+De nos jours, on n'utilise quasiment plus {{{latex}}} sauf dans des cas spécifiques.
+Le plus souvent, on compile directement avec {{{pdflatex}}}.
+Les cibles les plus utiles au début sont donc {{{pdflatex}}} et {{{xpdf}}}.
+On se place donc dans le dossier {{{src}}} contenant le {{{Makefile}}},
+il suffit alors de faire
+{{{
+make pdflatex
+make xpdf
+}}}
+
+La cible {{{review}}} est particulière puisque lié au paquetage [wiki:review]
+décrit sur ce même site.
+
+== Téléchargemet ==
+
+La dernière version du
+[http://servforge.legi.grenoble-inp.fr/svn/soft-latex-review/trunk/Makefile Makefile]
+est accessible directement :
+{{{
+wget http://servforge.legi.grenoble-inp.fr/svn/soft-latex-review/trunk/Makefile
+}}}