summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/plain/apprendre-a-programmer-en-tex/README
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/plain/apprendre-a-programmer-en-tex/README')
-rw-r--r--Master/texmf-dist/doc/plain/apprendre-a-programmer-en-tex/README162
1 files changed, 162 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/plain/apprendre-a-programmer-en-tex/README b/Master/texmf-dist/doc/plain/apprendre-a-programmer-en-tex/README
new file mode 100644
index 00000000000..ed792bf0460
--- /dev/null
+++ b/Master/texmf-dist/doc/plain/apprendre-a-programmer-en-tex/README
@@ -0,0 +1,162 @@
+-------------------------------- 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,
+LinuxLibertineMono a été adoptée. Cela donne une certaine cohérence à
+l'ensemble puisque la police du texte est LinuxLibertine. Malheureusement,
+telle qu'elle est conçue, son énorme défaut est de chasser beaucoup trop. Il a
+donc fallu la modifier pour créer deux autres polices plus « condensées » :
+
+ a) pour les caractères dans le corps du texte, j'ai créé une police
+ LinuxlibertineMonoTC où les glyphes de LinuxLibertineMonoT ont été, via
+ fontforge, réduits de 75% horizontalement et 92% verticalement. Ce sont,
+ après bien des essais, les coefficients qui lui permettent de s'insérer au
+ mieux (à mon goût) dans le texte, qui donnent une chasse proche de celle de
+ Luximono et qui rendent le gris typographique acceptable ;
+
+ b) pour les codes figurant dans le texte du livre, la police
+ LinuxlibertineMonoTCC a été créée, toujours à partir de LinuxLibertineMonoT,
+ mais les glyphes ont été davantage réduit horizontalement : 67%
+ horizontalement et 92% verticalement.
+
+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 différentes, comme expliqué ci-dessus.
+ Outre les considérations esthétiques sur lesquelles je ne m'étendrai pas,
+ cela ne devrait pas entraîner de modification de la mise en page car la
+ chasse de LinuxlibertineMonoTC est extrêmement proche de celle de Luximono ;
+
+ b) les mentions Luximono sont changées pour LinuxlibertineMonoTC ;
+
+ c) la licence est modifiée (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 3 fontes sont à installer à la main, à savoir LinuxlibertineMonoTC,
+ LinuxlibertineMonoTCC et les fontes de libertine-legacy.
+
+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 LinuxLibertineMono « condensées » :
+
+ a) dézipper le fichier linlibmonoc.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/linlibmonoc et lancer dans la console les
+ deux commandes suivantes :
+ updmap -user --enable map=LinuxLibertineMonoTC.map
+ updmap -user --enable map=LinuxLibertineMonoTCC.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 \ No newline at end of file