-------------------------------- Avant propos ---------------------------------

Ceci est le fichier LISEZMOI du livre �� Apprendre �� programmer en TeX ��

Tous les fichiers fournis dans ce paquet sont sous licence �� LPPL v1.2 ��

R��sum�� : le pr��sent paquet contient tous les fichiers permettant de compiler le
         livre �� Apprendre �� programmer en TeX ��. Il n'est pas n��cessaire
         d'effectuer la compilation pour obtenir les fichiers de sortie puisque
         ceux-ci sont ��galement fournis :
             - apprendre-a-programmer-en-tex.pdf
             - progtexcode.txt

---------------------------------- Foreword -----------------------------------

This is the README file of the book "Apprendre �� programmer en TeX"

All the files of this bundle are under "LPPL v1.2" licence

Abstract: this package contains all the files needed to compile the book
          "Apprendre �� programmer en TeX". It is not necessary to perform a
          compilation to obtain the output files since they are also provided:
              - apprendre-a-programmer-en-tex.pdf
              - progtexcode.txt

The text below is available in French only.

-------------------------------------------------------------------------------

I) Prendre le large

D��s le d��but, c'��tait pr��vu apr��s 4 ans grand maximum : lib��rer le code source
du livre et par la m��me occasion, en faire don �� la communaut�� LaTeX. J'ai bien
conscience que les 4 ans sont pass�� depuis un bon moment, et c'est donc avec un
l��ger retard que je me d��cide �� agir. Tout le �� Mat��riel �� de ce livre (code
source, fichiers pdf, fichiers g��n��r��s par la compilation, fichiers n��cessaires
�� la compilation) va enfin prendre l'air et naviguer de par le monde via
internet, ce qui sera bien plus profitable que de dormir au fin fond d'un
r��pertoire de mon disque dur.



II) Cons��quences

1) La premi��re cons��quence est, je l'esp��re en secret, que davantage
d'utilisateurs de LaTeX oseront jeter un ��il �� ce livre et s'essaieront �� la
programmation !

2) La deuxi��me cons��quence est que la licence change. Tout le Mat��riel se
trouve d��sormais sous la �� LaTeX project public license �� (LPPL) version 1.2,
mais ce changement implique la chose suivante : il n'est plus possible
d'utiliser dans le Mat��riel la police �� chasse fixe �� Luximono �� qui ��tait
employ��e dans le livre, car elle n'est pas sous licence libre.

Faire un choix de police de remplacement n'a pas ��t�� facile mais finalement,
GoMono a ��t�� adopt��e. Cette police est quasiment identique �� LuxiMono,
exception faite de la lettre "l", mais c'est sans grande importance car elles
ont les m��mes chasses : �� peinr 52sp de diff��rence �� l'��chelle 0.8 qui est
utilis��e dans ce livre. C'est une diff��rence insigifiante.

Pour les codes figurant dans le texte du livre, la police GMC a ��t�� cr����e �� 
partir de GoMono en multipliant par 0.8 la dimension horizontale de tous les
glyphes.

3) Enfin, la derni��re cons��quence est que le fichier pdf produit apr��s
compilation du code source n'est pas exactement celui qui a servi �� imprimer le
livre. Il n'y a que tr��s peu de modifications :

  a) les polices �� chasse fixe sont l��g��rement diff��rentes, comme expliqu��
  ci-dessus.
  Cela ne devrait pas entra��ner de modification de la mise en page car la chasse
  de GoMono est extr��mement proche de celle de Luximono ;

  b) les mentions Luximono sont chang��es pour GoMono ;

  c) la licence est modifi��e (voir page r��elle 6) ;

  d) quelques corrections ont ��t�� faites (coquilles, erreurs dans les codes,
  etc.), mais une infime partie en regard de ce qui resterait �� faire !



III) Compilation

Selon la LPPL 1.2, quiconque peut compiler et distribuer le Mat��riel sous le
nom originel, sous r��serve qu'aucun changement n'y ait ��t�� apport��.

Pour que la compilation puisse ��tre effectu��e le plus simplement possible, les
7 fichiers n��cessaires �� la compilation se trouvent dans le dossier /source, et
on y trouve en plus le fichier manderlbrot.tex qui a servi �� g��n��rer le pdf o��
est dessin�� l'ensemble de Mandelbrot �� l'aide d'une version modifi��e de TeX.

Par ailleurs, toujours par souci de simplicit�� :
   - tout le code source est dans un seul fichier �� livre.tex ��, qui est le
     code source �� compiler avec l'ex��cutable pdflatex ;
   - seules les fontes GMC et les fontes de libertine-legacy sont �� installer
     �� la main.

Pour installer ces fontes, il faut aller dans le r��pertoire /fonts o�� se
trouvent des fichiers zipp��s permettant ces installations. La proc��dure est
donn��e pour GNU-linux avec TeXlive car je ne connais ni windows ni mikTeX.

1) Installation des fontes "libertine-legacy"

  a) d��zipper le fichier libertine-legacy.zip

  b) copier les r��pertoires /fonts et /tex dans le texmf personnel (permettre
  d'��crire �� l'int��rieur des dossiers existants)

  c) aller dans /fonts/maps/dvips/libertine-legacy et lancer dans la console la
  commande suivante
          updmap -user --enable Map=libertine-legacy.map

2) Installation des fontes GMC :

   a) d��zipper le fichier GMC.zip

   b) copier les r��pertoires /fonts et /tex dans le texmf personnel (permettre
   d'��crire �� l'int��rieur des dossiers existants)

   c) aller dans /fonts/maps/dvips/GMC et lancer dans la console la
   commande suivante :
          updmap -user --enable Map=GMC.map

On peut s'assurer que l'installation s'est correctement d��roul��e en examinant
la sortie g��n��r��e par la commande
          updmap -user --listmaps

Quoi qu'il en soit, afin que tout ceux qui ne peuvent compiler ce code source
puissent y acc��der, les 2 fichiers dignes d'int��r��t qui sont g��n��r��s �� la
compilation se trouvent dans le r��pertoire /output, c'est-��-dire :
  - apprendre-a-programmer-en-tex.pdf (le fichier pdf de sortie)
  - progtexcode.txt (le fichier qui contient les 454 codes comment��s expos��s
    dans les exemples de ce livre).



IV) Conclusion

Bonne lecture et surtout, prenez du plaisir avec (La)TeX !

N'h��sitez pas �� poser des questions si certaines choses ne sont pas claires,
que ce soit �� moi directement ou dans un forum o�� les contributeurs se parlent
dans la langue de Moli��re !

Bien ��videmment, toute contribution est encourag��e, de m��me que tout retour
voire un petit remerciement qui vaudra largement le prix auquel est vendu ce
livre (car il est toujours possible de l'acheter sur lulu.com) ; pour ce faire,
passer par l'email ou le d��p��t sur framagit :
      unbonpetit@netc.fr
      https://framagit.org/unbonpetit/apprendre-a-programmer-en-tex/

Christian Tellechea