\chapter*{Introduction}

\ifframabookversion
\else
\setlength{\parskip}{4pt plus 1.0pt}
\fi

\begin{epigraphe}{L'ecclésiastique Si \textbf{42} 14}
  Mieux vaut la malice d'un homme\\ que la bonté d'une
  femme\footnote{%
    Les épigraphes de ce document sont tirées de l'Ancien et du Nouveau
    testament.  Ces citations sont insérées par pure provocation de ma
    part, et ont ---~parfois~--- un lien avec le titre du chapitre.}.
\end{epigraphe}

%\minisommaire

\section*{Il était une fois...}

Tout a commencé lorsqu'au tout début des années 1990, j'utilisais sur
un ordinateur PC 286 une version du logiciel Word Perfect pour
m'initier à ce qu'on appelait alors le « traitement de texte ». Ce
logiciel ---~qui existe toujours, édité par la société Corel~---
proposait à l'époque sous le désormais célèbre MS-DOS, une interface
composée d'un vague aperçu du document, et surtout laissait à
l'utilisateur la possibilité de « voir les codes » c'est-à-dire de
visualiser le document avec une sorte de langage à balises en
permettant un contrôle très souple.

Un peu plus tard, avec la prolifération de Windows 3.1 et l'engouement
soudain et bien nautel pour les interfaces graphiques, je me laissais
convaincre ---~faible que j'étais~--- d'utiliser le logiciel de
traitement de texte devenu très célèbre aujourd'hui dans sa version
d'alors : la version~2.0 (avec une petite lettre derrière qui avait
toute son importance à l'époque)... Cette version, je ne l'appris
qu'un peu plus tard, avait la particularité intéressante de comporter
un bug très sérieux qui empêchait à partir d'un certain volume de
données, la sauvegarde !  Il n'y a avait alors aucune solution pour
sauvegarder ni récupérer son document ; les plus teigneux d'entre nous
se hasardaient à supprimer quelques lignes et tentaient à nouveau une
sauvegarde, mais en vain...

À cette époque où les logiciels édités par la société dont nous
tairons le nom ici, faisaient l'objet de railleries non
dissimulées\footnote{Parmi celles-ci, même si elles n'apparurent que
  quelques années après, on pourra noter la célèbre intervention du
  patron de General Motors en réponse à une provocation de Bill
  \textsc{Gates} et le non moins célèbre « Piège dans le cyberespace »
  de Roberto \textsc{Di Cosmo}.}, la plupart des utilisateurs qui
m'entouraient acceptait malgré tout la situation : il était normal
d'utiliser des logiciels qui se vautraient lamentablement et
notoirement sans crier gare.  Cette particularité a fait naître en moi
une certitude : \emph{je n'accepterai pas d'utiliser de tels
  logiciels.}  J'étais alors élève ingénieur et je pressentais qu'une
partie de mon travail serait consacrée à l'élaboration de documents et
à l'utilisation de systèmes informatiques en général, il me fallait
des outils robustes pour y parvenir.

C'est au cours de mon DEA (qu'on appelle aujourd'hui master recherche)
à l'université Jean \textsc{Monnet} et à l'École des Mines de
Saint-Étienne que j'ai découvert à la fois Unix (dans sa version
Solaris) puis Linux. C'est alors que le mot « latèque » fut lâché pas
loin de moi au début de ma thèse (1993-94). Il était apparemment
question d'un logiciel indispensable pour produire des formules
mathématiques, et surtout il semblait évident que \LaTeX{} était
\emph{le} choix incontournable pour produire des documents
scientifiques. À vrai dire la question n'avait même pas l'air de se
poser !

J'entrepris donc d'installer cette « chose » qu'était \LaTeX{} à la
fois sur un système Mac avec une distribution nommée Oz\TeX{} et sur un
système Solaris, avec la distribution fournie par l'association
Gutenberg. Il avait fallu pour cela soudoyer l'administrateur système
pour qu'il accepte de créer un utilisateur privilégié \texttt{texadm}
dont le but était d'administrer la distribution...

Début 1994, je commençais ma thèse avec bien évidemment la ferme
intention de la rédiger avec \LaTeX{}. Courant 1995, enthousiasmé par
ce que je découvrais, j'entrepris de rédiger un guide d'initiation à
\LaTeX{} pour mes collègues de laboratoire, guide qui est à l'origine
du présent manuel. C'est au cours de l'année 1997, après environ deux
ans de pratique et d'initiation au monde de la typographie, que je me
confortais dans l'idée que \LaTeX{} était effectivement le logiciel de
choix pour la rédaction d'un document « sérieux » : contrôle global de
la mise en page, gestion de la bibliographie, des index (nom communs
et auteurs), légèreté des fichiers manipulés et surtout : \emph{la
  beauté du résultat}.  Depuis, c'est pour moi l'argument
le plus fort et le plus irréfutable pour utiliser \LaTeX{}.

Aujourd'hui maître de conférence en informatique à l'école nationale
d'ingénieurs de Saint-Étienne, j'utilise \LaTeX{} pour la rédaction de
documents scientifiques et de supports pédagogiques.  Après maintenant
plusieurs années de pratique, je continue à apprendre et à découvrir,
tout en étant encore ébloui par l'ensemble des extensions proposées
par les contributeurs du projet, ensemble d'extensions qui font de
\LaTeX{} un joyeux bazar, mais aussi un outil extraordinaire évoluant
dans le sens de la véritable ergonomie\footnote{Pas celle qui
  consiste à ajouter une entrée dans un menu, ou un son à l'apparition
  d'une boîte de dialogue.}, un outil unique dont le souci permanent
est « la belle ouvrage ».

\section*{Organisation du manuel}

Ce manuel est une introduction au « traitement de texte » \LaTeX{} ;
il ne s'agit pas d'un manuel de référence, mais il a pour but de
donner les bases pour utiliser \LaTeX{} et si possible d'y prendre
goût.  Ainsi trouvera-t-on les informations nécessaires pour
\emph{commencer} en \LaTeX{} et quelques conseils sur la rédaction des
documents.  Pour votre confort, nous avons eu l'idée lumineuse de
diviser ce manuel en chapitres et annexes. La première partie présente
les bases de \LaTeX{} :
\begin{description}
\item[Principes de base] expose les concepts fondamentaux de \LaTeX{}
  à lire impérativement pour comprendre le reste ;
\item[Ce qu'il faut savoir] présente les outils standard, ceux qu'il
  faut connaître pour rédiger un document simple ;
\item[Mathématiques] ou comment produire des équations ;
\item[Un pas vers la sorcellerie] pénètre insensiblement dans
  les rou\-a\-ges de \LaTeX{} ; à lire si vous voulez utiliser \LaTeX{} de
  manière satisfaisante ;
\item[Graphisme] permet de comprendre comment insérer des gra\-phi\-ques
  dans vos documents ;
\item[Documents scientifiques] donne quelques conseils utiles pour rédiger des 
  articles, des bibliographies, produire des index et des présentations ;
\item[Documents en français] fournit quelques notions élémentaires de
  typographie et présente les principaux aspects du package
  \ltxpack{french} ;
\item[À vous de jouer !] une conclusion sous  forme de conseils
pour chercher des informations sur \TeX{} et \LaTeX{}.
\end{description}
\begin{nota}
  La deuxième partie a pour but d'aborder les aspects plus complexes
  de \LaTeX{} en prenant comme prétexte d'expliquer comment ce manuel
  a été produit.  Ne la lisez pas avant d'avoir lu la première...
  Toute exposition ---~même non prolongée~--- à la deuxième partie peut
  provoquer des troubles du comportement et des traumatismes
  irréversibles.
\end{nota}

Viennent ensuite les annexes :
\begin{description}
\item[Générer des documents en PDF] comme son nom l'indique explique
  la méthode utilisée pour générer la version pdf de ce manuel ;
\item[Mémento] est un fourre-tout qui propose une liste non exhaustive
  d'extensions utiles, les raccourcis de Auc\TeX{}, et la configuration
  de \soft{aspell} pour \soft{emacs} ;
\item[Symboles] une liste des symboles mathématiques disponibles en
  standard et avec l'extension \ltxpack{amssymb}.
\end{description}
Il est conseillé de lire dans l'ordre les premiers chapitres jusqu'aux
mathématiques. Les suivants peuvent se lire indépendamment les uns des
autres. Encore une fois, la deuxième partie du manuel n'est à lire
qu'après avoir maîtrisé les concepts de base. Un index en fin de
document constitue un bon point d'entrée pour retrouver des
informations. Enfin, à l'instar des auteurs de la FAQ française de
\LaTeX{}, je n'ai pas fait d'effort particulier pour traduire
systématiquement tous les termes du jargon de \LaTeX{} et de
l'informatique en général.


% \section*{Système \TeX}
% \label{sec-installation}

% Bien que 90 \% des informations données dans ce manuel soient
% indépendantes du système d'exploitation, le système sous-jacent aux
% exemples est un \unix. En particulier, la distribution de \LaTeX{}
% utilisée est la distribution te\TeX{} (\url{http://www.tetex.org}). Si
% le logiciel qui vous permet de dialoguer avec votre ordinateur est
% édité par une entreprise basée à Redmond aux États-Unis, alors vous
% pouvez installer la version Mik\TeX{} (\url{http://www.miktex.org}) ou
% Protext (\url{http://www.tug.org/protext}) pour ne citer que
% celles-ci.

\section*{Ce qu'il faudrait que vous sachiez}
\label{sec-a-savoir}

La lecture de ce manuel qui s'adresse aux débutants, ne demande aucun
pré-requis à propos de \LaTeX{}. Le lecteur devra cependant posséder
une connaissance de base d'un système d'exploitation en tant
qu'utilisateur, c'est-à-dire savoir manipuler des fichiers. Être
capable de créer un fichier PostScript encapsulé sur son système, à
partir d'un logiciel de dessin ou de manipulation d'image, est
également souhaitable.


\section*{Ce que vous ne saurez pas}
\label{sec-manque}

Ce fabuleux manuel que vous avez entre les mains souffre tout de même
de quelques lacunes ; parmi celles-ci :
\begin{itemize}
\item il manque une explication claire de la manière dont \TeX{} et
  \LaTeX{} gèrent les fontes. Vous ne trouverez d'ailleurs nulle part
  le mot \MF ;
\item vous n'apprendrez pas comment installer et administrer une
  distribution \LaTeX{} sur un système \unix{} ;
\item vous ne trouverez pas de « catalogue » ou d'inventaire des
  extensions existantes, utiles ou inutiles, compatibles ou
  incompatibles, etc. ;
\item la question de l'\oe uf ou la poule est également occultée,
  ainsi que celle des liens entre Dieu et la science ;
\item ...
\end{itemize}
\begin{nota}
  Il est important de ne pas fonder de faux espoirs sur le contenu de
  ce manuel : son titre est un mensonge éhonté.
  \ifframabookversion \else D'autre part, les images de la couverture
  mises à disposition par
  \textsc{Knuth}\footnote{\url{http://www-cs-faculty.stanford.edu/~uno/graphics.html}}
  sont dessinées par Duane \textsc{Bibby} et n'ont rien à voir avec le
  sujet du présent manuel puisqu'il s'agit de dessins censés
  représenter les programmes \TeX{} et \MF.  \fi
\end{nota}




\section*{\TeX{} ?}
Le mathématicien Donald Ervin \textsc{Knuth} ---~à qui l'on doit de
nombreux ouvrages de mathématiques et d'algorithmique (notamment
\emph{The Art of Computer Programing}~\cite{taocp})~--- a conçu dans les
années 70 un système de traitement de texte nommé \TeX{} après avoir
été déçu par la manière dont ses articles étaient imprimés par les
systèmes du moment.  \TeX{} ---~accessible au public depuis le début des
années 80~--- est un environnement complexe de programmation composé
d'un processeur de macro (\emph{macro processsor}) et de quelques
centaines de primitives.  Un premier ensemble de macros pré-compilées
est apparu assez rapidement sous le nom de \emph{format plain}.

On pourra noter que \TeX{} n'est ni un \emph{traitement de texte}
(\textsc{Knuth} le nomme « typesetting system » que l'on pourrait
traduire par système de composition) ni un langage de programmation
compilé. Voici quelques citations de \textsc{Knuth} à propos de
\TeX{}\footnote{Tiré du chapitre introductif « The Name of the Game »
  du \TeX{}Book.} :
\begin{unecitation}
  Des mots anglais comme « technology » sont dérivés de racines grecques
  commençant par les lettres $\tau\epsilon\chi$... ; ce même mot grec
  voulant dire à la fois \emph{art} et technologie. D'où le nom
  \TeX{}, qui est la forme en majuscules de $\tau\epsilon\chi$.
\end{unecitation}
Au sujet de la prononciation du « X » de \TeX{} :
\begin{unecitation}
  {[...]} C'est le son « ch » en allemand comme dans \emph{ach} ; c'est le
  « j » espagnol [...]. Lorsque vous le dites correctement à votre
  ordinateur, l'écran doit devenir légèrement humide.
\end{unecitation}
Votre humble serviteur se contente lui de le prononcer « TeK » pour
contrecarrer l'aspect caoutchouteux et éviter d'avoir à nettoyer son
écran régulièrement.

Enfin pour ce qui est du logo lui-même \textsc{Knuth} fait remarquer
que ce dé\-pla\-ce\-ment du E est là pour rappeler qu'il s'agit de
typographie, et insiste sur le fait que dans une situation où l'on
veut parler de \TeX{} sans avoir les moyens d'abaisser le E, il faudra
écrire « \texttt{TeX} ».

La version actuelle de \TeX{} est 3.1415926 (les versions comme vous
l'avez compris tendent vers $\pi$) ; dans la préface de son livre «
\TeX{} : the program » \textsc{Knuth} estimait que le dernier bug
avait été trouvé et corrigé le 27 novembre 1985 et proposait une
récompense de \nombre{20,48}\,\$ à qui en trouvait un
nouveau. Aujourd'hui la somme de dollars hexadecimaux a été figée à
\nombre{327,68}\,\$. Les amateurs de puissances de 2 apprécieront...


\section*{\LaTeX{} ?}
\label{sec-latex}

En 1985, quelques années après la diffusion publique de \TeX{}, Leslie
\textsc{Lamport} crée un format composé de macros permettant d'avoir
une vision de plus haut niveau d'un document, appelé \LaTeX{} et
portant le numéro de version~2.09.  Aujourd'hui, \LaTeX{} est un
standard de fait, et seuls quelques sorciers produisent encore des
documents uniquement avec \TeX.  Cependant, \LaTeX{} étant une «
surcouche » de \TeX{} ---~contenant donc des appels à des macros de
\TeX~--- il est parfois utile de connaître quelques-uns des concepts de
\TeX{} pour se tirer d'un mauvais pas. Voici ce que dit
\textsc{Lamport} à ce propos dans son livre~\cite{lamport94} :
\begin{unecitation}
  Imaginez \LaTeX{} comme une maison dont la charpente et les clous
  seraient fournis par \TeX{}. Vous n'en avez pas besoin pour vivre
  dans la maison, mais ils sont pratiques pour y ajouter une nouvelle
  pièce.
\end{unecitation}
Un peu plus loin :
\begin{unecitation}
  \LaTeX{} a été conçu pour permettre à un auteur de faire abstraction
  des soucis de mise en page, et se concentrer sur l'écriture. Si vous
  passez beaucoup de temps sur la forme, vous faites un mauvais usage
  de \LaTeX{}.
\end{unecitation}

Aujourd'hui et depuis 1994, une équipe mi-européenne mi-améri\-caine
(autour de Frank \textsc{Mittelbach}) a pris en main le développement
de \LaTeX{} ; la version de \LaTeX{} parue en 1994 se nomme
\LaTeXe.  Le but à long terme est de concevoir un système
nommé \LaTeX{}3.


\section*{Licence}
\label{sec-licence}

On peut souligner que \TeX{} et \LaTeX{} sont des logiciels faisant
partie de la famille des logiciels libres et sont donc ---~entre
autres~--- gratuits.  Ce qui caractérise les logiciels libres
(\emph{free software}) est également l'aspect \emph{ouvert} des
logiciels. Il est donc possible d'avoir les sources Web\footnote{Le
  langage Web conçu par \textsc{Knuth} est qualifié de langage de «
  programmation littéraire. » À partir d'un document source Web, on
  peut produire le code Pascal ou C du programme ainsi qu'une
  documentation en \TeX{} de ce code.} de \TeX.  Les macros de
\LaTeX{} sont quant à elles distribuées sous forme de code source
\TeX. Le fait de pouvoir obtenir les sources d'un logiciel peut
sembler secondaire à la plupart des utilisateurs ; il faut comprendre
que c'est parce que \emph{rien n'est caché} que l'amélioration de
l'existant et la création d'extensions sont possibles.

Le fait qu'un logiciel soit libre ne veut pas dire qu'on puisse en
faire tout à fait ce que l'on veut. Il reste la propriété de son
auteur et toute modification doit être documentée ; chacune de ces
modifications doit également donner lieu à un nom de fichier différent
de celui du fichier initial avant modification. Ceci pour assurer
cohérence et portabilité au système (voir à ce sujet
\url{ftp://ftp.lip6.fr/pub/TeX/CTAN/macros/latex/base/lppl.txt} pour
la licence de \LaTeXe).


\section*{\ref{nbraisons} bonnes raisons pour  ne pas utiliser \LaTeX}
\label{sec-pas-utiliser}

Il existe plusieurs raisons pour lesquelles il est « impératif » de ne
pas utiliser \LaTeX{} :
\begin{enumerate}
\renewcommand{\theenumi}{\Toutelettre{enumi}}
\renewcommand{\labelenumi}{\arabic{enumi}. }
\item vous utilisez un traitement de texte uniquement pour faire vos
  cartes de v\oe{}ux, votre courrier, pour noter quelques idées, etc.
  ;
\item vous adorez les souris (1 ou 3 boutons indifféremment) et vous
  pensez que la seule manière d'écrire des équations est de les
  utiliser (les souris) de manière intensive ;
\item vous pensez qu'\unix{} c'est « prise de tête » et « pas
  convivial » et/ou vous avez une aversion particulière pour tout
  langage de programmation ;
\item vous trouvez normal : \primo que votre logiciel préféré ne
  puisse pas lire le document que vous aviez produit avec la version
  précédente, et/ou \secundo que la nouvelle version vous oblige à
  changer de système d'exploitation, et \tertio que la nouvelle
  version dudit système d'exploitation vous oblige à changer
  d'ordinateur, et \quarto que votre nouvel ordinateur...
\item vous ne savez pas où se trouve la touche \verb+\+ sur 
  %\verb+\+
  votre clavier ; \label{nbraisons}
\end{enumerate}
si vous vous reconnaissez dans une de ces catégories, mieux vaut vous
contenter de votre système actuel.

\section*{Quelques bonnes raisons d'utiliser \LaTeX}

Il n'est pas question ici de convaincre le lecteur de la supériorité
de \TeX{} et \LaTeX{} par rapport à un autre système, de toutes
manières, vous lisez ce manuel, donc vous êtes inconsciemment
convaincu. Laissons donc la parole au concepteur de \TeX{} :
\begin{unecitation}[D. E. Knuth in the \TeX book \cite{texbook}]
  By preparing a manuscript in \TeX{} format, you will be telling a
  computer exactly how the manuscript is to be transformed into pages
  whose typographic quality is comparable to that of the world's
  finest printers.
\end{unecitation}
Les documents générés par \TeX{} ou \LaTeX{} sont d'une qualité
typographique exceptionnelle (avec possibilité de réglage très
fin\footnote{À titre indicatif l'unité interne de mesure de \TeX{} est
  le \emph{scaled point}, noté \texttt{sp} dans le \TeX{}book, qui vaut
  1/65536 points ; 1 point valant environ 1/72\ieme{} de pouce, 1 pouce
  valant 2.54 cm, l'unité de base est approximativement 50 \AA, ce qui
  laisse de la marge vis à vis de la résolution des imprimantes
  actuelles.}), ceci grâce notamment à :
\begin{itemize}
\item un dessin de fontes très soigné ;
\item des détails typographiques (tirets, ligatures,...) ;
  \begin{itemize}
  \item avez-vous ---~bien~--- regardé ces tirets (page 19--23) ?
  \item et le « f{i} » de fin, le « f{f}l » de souffle ou le « f{l} »
    de trèfle ?
  \end{itemize}
\item un algorithme de césure très performant ;
\item des formules mathématiques particulièrement réussies ;        
\item ...
\end{itemize}

D'autre part, \LaTeX{} est un des rares logiciels de traitement de
texte orienté vers la production de documents \emph{scientifiques}.
Car outre les équations et autres formules, \LaTeX{} possède un 
nombre important de fonctionnalités axées autour de la rédaction
d'\emph{article} et la génération de \emph{bibliographie} et
d'\emph{index}.

Enfin, \LaTeX{} est particulièrement adapté à la production de gros
documents. Pas seulement parce que la manipulation d'un document
\LaTeX{} exige par essence peu de mémoire, mais parce que les
mécanismes de \emph{macros} et de \emph{référence croisée}
(\emph{cross reference} en anglais) permettent de garder un contrôle
global et très souple du document.
\begin{description}
\item[référence croisée] : \LaTeX{} permet de faire référence de
  manière \emph{symbolique} à toute partie du document faisant l'objet
  d'une numérotation. Ainsi, le numéro des titres, figures, tableaux,
  équations, pages, références bibliographiques, items d'énumération,
  théorèmes,... peut être mentionné à plusieurs endroits dans un
  document de manière très simple, sans se soucier du numéro lui-même.
\item[macros] : sans doute l'aspect le plus puissant de \LaTeX. Il
  faut savoir que \textbf{tout} processus qui mène à la génération
  d'un document est une séquence de commandes ou macros. Chaque
  utilisateur peut donc modifier l'allure d'un document, en modifiant
  l'une des ces macros. On peut bien évidemment définir ses propres
  macros pour mettre en page une partie spécifique d'un document.
  L'idée forte autour des macros est qu'on peut \emph{a priori}
  séparer le fond de la forme lors de la rédaction d'un document.
\end{description}


\section*{Les limites du \WYS}

\LaTeX{} est le contraire d'un \WYS\footnote{Pour « what you see is
  what you get » terme désignant les logiciels permettant à
  l'utilisateur de voir à l'écran ce qu'il obtiendrait sur le
  papier. Le premier traitement texte \WYS{} serait \soft{Bravo} mis
  au point sur la machine Alto du Xerox Paolo Alto Research Center en
  1974.}, puisqu'un source \LaTeX{} est un document texte composé du
texte lui-même et des commandes de mise en page. \textsc{Lamport}
présente ce type d'approche comme étant une mise en page
\emph{logique} par opposition à la mise en page
\emph{visuelle}\footnote{Pour faire un peu de mauvais esprit, les
  logiciels du type \WYS\ ont d'ailleurs été qualifiés par Kernighan
  (dixit \textsc{Lamport} dans son livre sur \LaTeX) de ``what you see
  is all what you've got'' !}.

On pourrait cependant dire que \LaTeX{} est un Wywsiewyg (what you
will see is exactly what you get) puisqu'après compilation on peut
visualiser à l'écran une image \textbf{exacte} du document futur sur
papier.

Voici donc un exemple\footnote{\textsc{Lamport} propose un exemple
  analogue à celui-ci dans son manuel.} parmi d'autres qui met en
évidence les limites du \WYS\ et les avantages de la mise en page
logique : \newcommand{\mafct}[2]{\mathcal{F}_{\alpha,\beta}(#1,#2)}
supposons que dans un document apparaisse un certain nombre de fois,
une fonction quelconque ayant deux arguments. La notation étant un
point délicat dans l'élaboration de documents scientifiques, on pourra
définir une macro \verb+\mafct+ permettant de produire une telle
fonction.  Ainsi les séquences \verb+\mafct{1}{2.5}+ et
\verb+\mafct{x}{t}+ produiront respectivement $\mafct{1}{2.5}$ et
$\mafct{x}{t}$.
\renewcommand{\mafct}[2]{\mathsf{F}^{\alpha\beta}[#1,#2]} Mais si l'on
a besoin de changer de notation, il suffira de redéfinir la commande
\verb+\mafct+ pour produire aux endroits nécessaires :
$\mafct{1}{2.5}$ et $\mafct{x}{t}$.  Et le tour est joué !

Un autre exemple : imaginons que votre document comporte beaucoup de
mots techniques que vous voulez mettre en évidence d'une manière
particulière. Vous écrirez alors dans votre document
\verb+\jargon{implémentation}+ en ayant préalablement défini la macro
\verb+\jargon+ de manière à ce qu'elle mette en italique le mot du
vocabulaire technique. Les 235 mots de jargon auxquels vous faîtes
référence dans votre document pourront être mis en évidence autrement
qu'en italique si vous changez d'avis, et cela sans avoir à passer sur
les 235 occurrences des mots du jargon, mais juste en changeant la
définition de la macro \verb+\jargon+. Avec un peu d'entraînement vous
arriverez même à faire en sorte que cette macro insère automatiquement
le mot du jargon dans l'index de votre document...

Voici un exemple un peu plus tordu : dans le titre du paragraphe
intitulé « \ref{nbraisons} bonnes raisons de ne pas [...] » un peu
plus haut dans ce chapitre, je n'ai pas écrit «
\ref{nbraisons}\footnote{Là non plus d'ailleurs.} » en toutes lettres
dans le document source.  En réalité le titre du paragraphe est
produit par : « \verb+\ref{nbraisons}+ \texttt{bonnes raisons}... »
qui affiche en français le nombre correspondant aux nombres de bonnes
raisons de ne pas utiliser \LaTeX{}. Si jamais j'avais à rajouter
d'autres entrées dans cette liste de bonnes raisons, il ne sera pas
nécessaire de refaire la numérotation...
\begin{nota}
  Vous trouverez le long de ce manuel, d'autres exemples mettant en
  évidence, les faiblesses du \WYS. Ce « nota », vous avertissant d'un
  point important en est un autre exemple. Car au moment où l'auteur
  tape ces lignes, la présence du « panneau danger » est un détail
  ---~il s'agit simplement d'un nota. Et l'auteur a écrit :
\begin{ltxcode}
  \begin{nota}
    Vous trouvez le long de ce manuel...
  \end{nota}
\end{ltxcode}
\end{nota}
Pour en finir avec les macros, on peut dire qu'il s'agit d'une «
gé\-né\-ra\-li\-sa\-tion » des styles du célèbre logiciel « Mot » de la société
« Micrologiciel ». La lecture de ce document et en particulier la
deuxième partie devrait vous convaincre que les macros permettent
d'aller bien au-delà de ces fameux styles...

Pour les accros du \WYS, une équipe de développeur a mis en \oe
uvre une version \emph{What you see is what you Mean} (\emph{sic}) de
\LaTeX{} nommé LyX, dont je vous invite à prendre connaissance à
\url{http://www.lyx.org}.

\section*{Comment imprimer ce manuel ?}
\label{preface-impression}

Avec une imprimante\footnote{Arf arf (comme disait Frank
  \textsc{Zappa}).},  
%
\ifframabookversion en utilisant la version « papier » produite à
partir de ce document, version prévue pour être imprimée sur du papier
au format~A5.\else en utilisant exclusivement les fichiers proposés
sur \url{http://www.enise.fr/cours/info/latex}. Ce manuel est conçu
pour être imprimé en deux pages logiques par page physique (\emph{2up
  printing} comme disent nos amis anglosaxons). En d'autres termes,
chaque page de ce document doit apparaître sur une page au format~A5.
Quatre solutions ---~et quatre fichiers associés~--- sont possibles :
\begin{enumerate}
\item une version destinée à être reliée du long coté de la
  feuille~A4, c'est la solution pour ceux qui ne disposent pas de
  massicot ; le fichier portant le nom \verb+guide-latex-0.pdf+ est en
  outre généré pour présenter la page impaire (dite belle page) à
  droite (cf. figure\vref{fig-reliure-longue}) ;
\item une version pour ceux qui disposent d'un massicot : dans ce cas,
  il faudra « plier » le document et le relier au niveau de cette
  pliure (voir figure\vref{fig-reliure-courte-1ex}). Le fichier
  correspondant se nomme \verb+guide-latex-1.pdf+ ;
\item une version contenant 2 exemplaires (fichier
  \verb+guide-latex-2.pdf+). On reliera ces deux exemplaires comme
  indiqué à la figure\vref{fig-reliure-courte-2ex} ;
\item une version au format PostScript \verb+guide-latex.ps.gz+ pour
  ceux qui voudraient faire « à leur sauce »...
\end{enumerate}
\begin{nota}
  Attention, les deux derniers fichiers au format Pdf, sont prévus pour
  être imprimés en recto verso en demandant à l'imprimante de retourner
  la feuille du côté court. Il faudra donc veiller à ce que le pilote
  d'imprimante utilise cette option.
\end{nota}
\begin{figure}[tb]
  \begin{changemargin}{-1.5cm}{-2.2cm}
    \centering
    \subfloat[Reliure longue]{%
      \begin{minipage}{.55\textwidth}
        \begin{center}
          \includegraphics[width=\textwidth]{reliure-longue}
          \label{fig-reliure-longue}
        \end{center}
      \end{minipage}}\\
    \subfloat[Reliure courte « 1 exemplaire »]{%
      \begin{minipage}{.55\textwidth}
        \begin{center}
          \includegraphics[width=\textwidth]{reliure-courte-1ex}
          \label{fig-reliure-courte-1ex}
        \end{center}
      \end{minipage}}
    \subfloat[Reliure courte « 2 exemplaires »]{%
      \begin{minipage}{.55\textwidth}
        \begin{center}
          \includegraphics[width=\textwidth]{reliure-courte-2ex}
          \label{fig-reliure-courte-2ex}
        \end{center}
      \end{minipage}}
  \end{changemargin}
  \caption{Les versions imprimables}
  \label{fig-prints}
\end{figure}
\fi

\section*{Que pouvez-vous faire de ce manuel ?}

\begin{description}
\item[Nom de l'auteur :] Vincent \textsc{Lozano} ;
\item[Titre :] Tout ce que vous avez toujours voulu savoir sur
  \LaTeX{} sans jamais avoir osé le demander ;
\item[Date :] \today
\item[Copyleft :] ce manuel est libre selon les termes de la Licence
  Art Libre (LAL) :\begin{center}\url{http://www.artlibre.org}\end{center}
\end{description}
La LAL stipule en résumé que vous pouvez copier ce manuel. Vous pouvez
également le diffuser à condition :
\begin{itemize}
\item d'indiquer qu'il est sous la LAL ;
\item d'indiquer le nom de l'auteur de l'original : Vincent
  \textsc{Lozano} et de ceux qui auraient apporté des modifications ;
\item d'indiquer que les sources peuvent être téléchargés sur
  \url{http://cours.enise.fr/info/latex}.
\end{itemize}
Enfin vous pouvez le modifier à condition :
\begin{itemize}
\item de respecter les conditions de diffusion énoncées ci-dessus ;
\item d'indiquer qu'il s'agit d'une version modifiée et si possible la
  nature de la modification ;
\item de diffuser vos modifications sous la même licence ou sous une
  licence compatible.
\end{itemize}

\framanouvellepage

\section*{En avant !}
\label{sec-en-avant}

Comme beaucoup de logiciels puissants, \LaTeX{} n'est pas toujours
simple à utiliser.  En fait lorsque l'on va dans son sens, \LaTeX{}
est toujours agréable et permet effectivement comme le souligne
\textsc{Lamport} de ne pas se soucier de problèmes de mise en page.
Lorsque l'on veut changer un comportement, et que la solution consiste
à choisir une autre option d'une commande, tout va encore très bien.
Cependant, même si les choix de \LaTeX{} répondent à des conventions
en vigueur chez tous les bons imprimeurs, il arrive un jour où l'on
désire avoir une mise en page particulière qu'apparemment \LaTeX{} est
incapable de fournir.  À ce stade, plusieurs solutions s'offrent à
vous :
\begin{itemize}
\item inclure un \emph{package} qui répond à votre problème
  (\LaTeX{} étant un système ouvert, une multitude de packages plus
  ou moins standardisés sont disponibles pour réaliser des
  opérations variées voire farfelues);
\item demander à un \TeX nicien\footnote{ou un \TeX pert, mais c'est
    assez rare.} de vous dépanner ;
\item si les deux premières solutions sont inefficaces, vous n'avez
  plus qu'à faire le détective et mettre le nez dans le code%
  \footnote{C'est la solution la plus plaisante pour ceux qui ont
    certaines velléités pour pisser\llap{xxxxx} du code...} pour trouver
  la commande qui vous fait du tort et la modifier. Vous aurez besoin
  à ce stade de connaissance de la première couche du système, à
  savoir \TeX{}. On touche sans doute ici à un des défauts de \LaTeX{}
  : si d'autres logiciels sont incapables de faire des choses
  compliquées, il est parfois difficile de faire faire à \LaTeX{} des
  choses simples (vous en serez probablement convaincu après la
  lecture de la deuxième partie de ce manuel).
\end{itemize}


\section*{Conventions typographiques}
\label{sec-convention-typo}

Certaines conventions utilisées dans ce manuel nécessitent d'être
quelque peu éclaircies. Les extraits de code \LaTeX{} qui parsèment
le document peuvent apparaître comme ceci :
\begin{ltxcode}
  % attention les yeux
  Ceci est \emph{déjà} du code \LaTeX.
\end{ltxcode}
Le choix s'est porté sur la fonte « \texttt{machine à écrire} » de
\LaTeX{}. Le code est également souvent présenté sous la forme
suivante, avec un petit numéro sur la barre centrale auquel on se
réfère parfois :
\begin{ltxexemple}
  % attention les yeux
  Ceci est \emph{déjà} du
  code \LaTeX.
\end{ltxexemple}
\begin{note}
  Certaines parties sont présentées sous forme de « notes » pour
  éclaircir un point sans que la lecture soit indispensable au premier
  abord.
\end{note}
\begin{nota}
  Si la lecture est indispensable, on aura recours au pictogramme
  ci-contre pour attirer l'attention du lecteur distrait...
\end{nota}
Les \softwi{logiciels} et les \ltxpack{packages} de \LaTeX{} sont
typographiés comme indiqués ci-avant. Les mots en anglais sont
produits \anglais{like this}. Pour mettre en évidence les parties
génériques d'une commande on utilisera \marg{cette notation}. Par
exemple :
\begin{ltxcode}
  Ceci est \emph{ø\marg{texte à mettre emphase}ø} du code \LaTeX.
\end{ltxcode}
Quelques rares fois sont insérées des commandes Unix, comme ceci :
\begin{unixcom}
  grep -wi bidule /tmp/truc.dat | sort -n
\end{unixcom}
On trouve même dans une des annexes, des commandes pour \soft{emacs} :
\begin{emacscom}
  M-x doctor
\end{emacscom}
Et, comble de l'horreur, des extraits de \texttt{Makefile} :
\begin{makefile}
  bidule : bidule.o truc.o
  ø$\longmapsto$ø gcc -o $@ $^
\end{makefile}
Dans la version papier apparaissent des renvois sur des chapitres ou
des paragraphes, comme celui-ci dirigeant le lecteur vers la
production de formules
\makeatletter%
\let\voirOrig\v@ir%
\let\v@ir\v@irpapier
\voir[Ch.]{chap-maths}{mathématiques}
\let\v@ir\voirOrig
\makeatother
avec \LaTeX{}.
 
\section*{Remerciements}
\label{sec-merci}

La rédaction de cet ouvrage qui est initialement le guide local du
laboratoire d'informatique graphique et d'ingénierie de la vision
situé à Saint-Étienne, a débuté en 1995. Je tiens ici à remercier les
membres de cette équipe de recherche qui m'ont fait part de leurs
remarques et encouragements. Les personnes participant au forum
\texttt{fr.comp.text.tex} m'ont indirectement apporté énormément
d'informations qui ont enrichi ce document, qu'elles en soient ici
remerciées.

Je voudrais également remercier Benjamin \textsc{Bayart} qui m'a aidé
à créer certaines des extensions utilisées dans ce manuel, en
particulier la version initiale de la boîte entourant les « mini »
tables des matières en tête de chapitre ; ainsi que Guillaume
\textsc{Connan} pour ses remarques sur l'annexe concernant le format
Pdf et pour ses encouragements.

Un merci particulier à Denis \bsc{Bitouzé} pour sa lecture attentive
ses conseils précieux et les nombreuses corrections qu'il a apportées
à la première partie du manuel. Denis m'a mis sur la voie de la
rédemption, j'ai fait une croix sur \ltxpack{a4wide},
\ltxenv{eqnarray}, et toutes ces horreurs qui faisaient de moi un
pauvre pécheur...

\ifframabookversion%
Je tiens à remercier particulièrement Didier \textsc{Roche} et Alexis
\textsc{Kauffmann} de FramaSoft de m'avoir accordé leur confiance pour
créer un nouveau volume dans la collection FramaBook. \fi%
Un grand merci au groupe de relecture %
\ifframabookversion\else%
du projet FramaBook \fi%
mené par Vincent « \textsc{Vim} ». Ce groupe ---~et en particulier
\textsc{Papiray} et Antoine \textsc{Blanche}~--- non content de
débusquer de nombreuses coquilles qui se tapissaient sournoisement au
fond des paragraphes, a également corrigé de vilaines répétitions. Je
tiens donc à les remercier ici bien chaleureusement, d'autant que les
échanges ont été fructueux : l'accentuation correcte de
\textsl{Genèse}, le genre de \textsl{nota}, de longues discussion sur
\textsl{pré-requis} et \textsl{en-tête} et j'en passe...


La lecture des « grands classiques » de la littérature autour de
\TeX{} et \LaTeX{} m'a inconsciemment influencé dans la rédaction de
ce document. La lecture du \TeX{}book de \textsc{Knuth}~\cite{texbook}
m'a bien évidemment donné l'idée de créer le panneau danger
\includegraphics[height=2ex]{notabene}, la lecture quasi compulsive du
\emph{\LaTeX{} Companion} de \textsc{Goossens}, \textsc{Mittelbach} et
\textsc{Samarin}~\cite{ltx-comp}
a très certainement influencé beaucoup de passages de
cet ouvrage aussi bien pour le fond que la forme. Enfin la lecture de
plusieurs manuels en ligne a également dû orienter certains de mes
choix (Le « Not So Short Introduction to \LaTeX{} » possède par
exemple un chapitre que l'on peut traduire par « ce qu'il faut savoir
»)...


Avant de commencer je tiens à signaler que même si ce document a mis
plusieurs années à mûrir, il est dans un style tout à fait douteux. La
preuve, sur ma machine, la commande :
\begin{ltxcode}
  grep -E -i 'on peut|permet'   *.tex | wc -l
\end{ltxcode}
donne $343$ (plus d'une occurrence par page) ce qui dénote un style
assez pauvre.




\vspace{\stretch{1}} \hfill Bonne lecture et bon
courage\footnote{Cette ligne est une illustration de la mise en page
  logique, elle est censée être au 2/3 du blanc restant sur la page,
  quelle que soit la taille de ce blanc bien sûr.} !
\vspace{\stretch{2}}

\ifframabookversion
\else
\setlength{\parskip}{0pt plus 1.0pt}
\fi


%%% Local Variables: 
%%% mode: latex
%%% TeX-master: "../framabook"
%%% End: 
