Changes between Version 2 and Version 3 of document


Ignore:
Timestamp:
Apr 21, 2011, 10:52:33 PM (10 years ago)
Author:
g7moreau
Comment:

Makefile

Legend:

Unmodified
Added
Removed
Modified
  • document

    v2 v3  
    2424de séparer le code source, gérer par un gestionnaire de code source,
    2525des fichiers temporaires ainsi que des fichiers finaux.
    26 Ainsi, seul le fichier source est important à sauver,
     26Ainsi, seul les fichiers sources sont importants à sauver,
    2727à archiver, à transmettre...
    2828
     
    6767 - {{{/chemin/du/projet/doc}}} :
    6868   dossier où seront placés les documents finis.
     69
     70On remarque que tous ces fichiers sont placés dans des sous dossiers
     71qui sont au même niveau que le dossier {{{/src/}}}.
     72C'est une bonne manière de procéder.
     73
     74== {{{Makefile}}} ==
     75
     76La commande {{{make}}} interprète par défaut le fichier {{{Makefile}}}
     77du dossier courant.
     78Ce programme est un moteur d'inférence qui applique les règles
     79selon les contraintes les liants.
     80Il faut savoir qu'il y a une règle de base implicite qui se base sur la date
     81de chaque fichier.
     82Ainsi, la modification d'un fichier, d'une figure... entraîne
     83la reconstruction du document final mais aussi des figures intermédiaires
     84si nécessaire...
     85
     86Cependant, la compilation d'un document TeX peut être long.
     87Il faut compiler plusieurs fois,lancer le gestionnaire de bibliographie {{{BibTeX}}},
     88recompiler...
     89Il est le plus souvent inutile de refaire tous ses étapes pour le moindre changement,
     90il y a donc dans le {{{Makefile}}} des cibles pour gagner du temps
     91et ne faire que des compilations partielles.
     92
     93Attention cependant pour la version finale de bien compiler suffisamment !
     94Il y un cible {{{touch}}} qui modifie la date du document principal
     95et permet de relancer la compilation de celui-ci par {{{make}}}
     96même sans modification de celui-ci
     97({{{make}}} fonctionne par défaut sur la date des fichiers
     98et non sur un système de checksum type {{{md5sum}}}).
     99
     100Après cette longue introduction, voici les cibles utiles :
     101
     102 - {{{all}}}       -> compilation complète
     103 - {{{dossier}}}   -> création des dossiers du projet
     104 - {{{clean}}}     -> nettoyage partiel
     105 - {{{pdf}}}       -> compilation simple avec dépendance -> pdf
     106 - {{{dvi}}}       -> compilation simple avec dépendance -> dvi
     107 - {{{xpdf}}}      -> visualisation du résultat pdf
     108 - {{{xdvi}}}      -> visualisation du résultat dvi
     109 - {{{gv}}}        -> visualisation du résultat ps
     110 - {{{warning}}}   -> liste de tous les warnings
     111 - {{{review}}}    -> liste de toutes les remarques
     112 - {{{pdflatex}}}  -> compilation du source tex -> pdf
     113 - {{{latex}}}     -> compilation du source tex -> dvi
     114 - {{{bibtex}}}    -> compilation du source bibtex
     115 - {{{protect}}}   -> protection du dossier source
     116 - {{{unprotect}}} -> suppression de la protection
     117
     118Ce {{{Makefile}}} a été conçu il y de nombreuses années (début 2000).
     119De nombreux logiciels nouveaux sont apparus
     120et une mise à jour de celui-ci peut s'avérer nécessaire dans le détail.
     121
     122De nos jours, on n'utilise quasiment plus {{{latex}}} sauf dans des cas spécifiques.
     123Le plus souvent, on compile directement avec {{{pdflatex}}}.
     124Les cibles les plus utiles au début sont donc {{{pdflatex}}} et {{{xpdf}}}.
     125On se place donc dans le dossier {{{src}}} contenant le {{{Makefile}}},
     126il suffit alors de faire
     127{{{
     128make pdflatex
     129make xpdf
     130}}}
     131
     132La cible {{{review}}} est particulière puisque lié au paquetage [wiki:review]
     133décrit sur ce même site.
     134
     135== Téléchargemet ==
     136
     137La dernière version du
     138[http://servforge.legi.grenoble-inp.fr/svn/soft-latex-review/trunk/Makefile Makefile]
     139est accessible directement :
     140{{{
     141wget http://servforge.legi.grenoble-inp.fr/svn/soft-latex-review/trunk/Makefile
     142}}}