222 lines
8.6 KiB
XML
222 lines
8.6 KiB
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||
<!DOCTYPE html
|
||
PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
|
||
"tuteurs://DTD/tml.dtd">
|
||
<html>
|
||
<head>
|
||
<title>Comment faire ?</title>
|
||
</head>
|
||
<body>
|
||
|
||
<h1>Comment faire du LaTeX ?</h1>
|
||
|
||
<p> Cette page a pour but d'apprendre à se servir de LaTeX. Vous y
|
||
verrez quel est le principe de LaTeX, et comment utiliser l'utiliser sur
|
||
les machines de l'École. Les principales commmandes de LaTeX sont
|
||
expliquées <a href="manuel.html">ailleurs</a>. Mais prenons d'abord le
|
||
temps de comprendre son fonctionnement...</p>
|
||
|
||
<h2>Écrire, compiler, visualiser</h2>
|
||
|
||
<p> La composition d'un texte avec LaTeX est regroupée en trois temps.
|
||
D'abord, on rédige le texte en question (ainsi que les commandes de mise
|
||
en page destinée à LaTeX). Ensuite, on compile le document, c'est-à-dire
|
||
qu'on le donne à LaTex pour qu'il fasse la mise en page. Enfin, on
|
||
visualise le résultat, pour corriger des fautes, l'imprimer, l'envoyer
|
||
par mail... </p>
|
||
|
||
<table class="tableau">
|
||
|
||
<tr>
|
||
<td>Fonction</td>
|
||
<td>Commande</td>
|
||
<td>Exemple</td>
|
||
<td>Astuces</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>Écrire</td>
|
||
<td><code>éditeur <em>fichier.tex</em></code></td>
|
||
<td><code>kate bla.tex</code></td>
|
||
<td>Ne pas oublier de sauvegarder avant de compiler ! Sinon, les
|
||
modifications n'apparaîtront pas...</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>Compiler</td>
|
||
<td><code>latex <em>fichier.tex</em></code></td>
|
||
<td><code>latex bla.tex</code></td>
|
||
<td>Plutôt que de retaper à chaque fois la
|
||
commande, utilisez les flèches! <strong>En cas d'erreur</strong>, taper
|
||
<code>x</code> pour arrêter la compilation.</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>Compiler (pdf)</td>
|
||
<td><code>pdflatex <em>fichier.tex</em></code></td>
|
||
<td><code>pdflatex bla.tex</code></td>
|
||
<td>Même chose que la commande précédente, mais produit un fichier pdf
|
||
au lieu d'un fichier dvi.</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>Résultat</td>
|
||
<td><code>xdvi <em>fichier.dvi</em></code></td>
|
||
<td><code>xdvi bla.dvi</code></td>
|
||
<td>Mettez un <code>&</code> à la fin de la ligne pour garder la
|
||
fenêtre en tâche de fond il suffit alors de cliquer sur la fenêtre DVI
|
||
pour remettre à jour après une compilation, sans avoir à retaper
|
||
<code>xdvi monfichier.dvi</code>. </td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>Imprimer</td>
|
||
<td><code>dvips <em>fichier.ps</em></code></td>
|
||
<td><code>dvips bla.dvi</code></td>
|
||
<td>Vérifier que personne n'est en train d'imprimer, avec la commande
|
||
<code>lpq</code> ; et surtout, si vous avez lancé une impression avant
|
||
de vous rendre compte qu'il n'y avait pas de papier, annulez-la avec la
|
||
commande <code>lprm</code>.</td>
|
||
</tr>
|
||
|
||
</table>
|
||
|
||
<h3>Taper son texte</h3>
|
||
|
||
<p>Il faut utiliser un <a href="&url.tuteurs;unix/editeurs/">éditeur de
|
||
texte</a>. Si par exemple vous utilisez <code>kate</code> et que vous
|
||
voulez éditer le fichier <code>rapport.tex</code>, tapez :</p>
|
||
|
||
<pre>kate rapport.tex</pre>
|
||
|
||
<p> Ce fichier, auquel on donne le nom que l'on veut, a obligatoirement
|
||
le suffixe <code>.tex</code>, pour l'identifier. <code>rapport.tex</code>
|
||
est le fichier <strong>source</strong>, c'est-à-dire le fichier qui sera
|
||
interprété par le compilateur ; c'est donc celui où on écrit le texte
|
||
agrémenté de quelques commandes. </p>
|
||
|
||
<h3>Compiler le fichier <code>.tex</code></h3>
|
||
|
||
<p> Ça veut dire le « passer à la moulinette » : le compilateur, ici
|
||
LaTeX, interprète le source à l'aide des commandes qui y ont été insérées
|
||
et qui lui indiquent la manière dont il faut mettre le texte en page.
|
||
Tapez dans un <a
|
||
href="&url.jargon;#xterm">terminal</a> : </p>
|
||
|
||
<pre>latex document.tex</pre>
|
||
|
||
<p> Sur l'écran vont se mettre à défiler diverses choses. Si tout va
|
||
bien, le programme va « rendre la main » et le prompt réapparaît. Si
|
||
vous tapez <code><a
|
||
href="&url.tuteurs;unix/repertoires.html#ls">ls</a></code> vous verrez
|
||
que de nouveaux fichiers sont apparus : outre le
|
||
<code>document.tex</code>, il y a un <code>document.aux</code>, un
|
||
<code>document.log</code> et un <code>document.dvi</code>. C'est le
|
||
dernier qui nous intéresse, car il contient le résultat graphique de la
|
||
compilation. </p>
|
||
|
||
<p> <strong>S'il y a une erreur</strong> : LaTeX interrompt la
|
||
compilation en donnant un message d'erreur. Dans ce cas, il faut taper
|
||
<code>x</code> dans la fenêtre où on a lancé la compilation, afin que le
|
||
programme rende la main (qu'on puisse à nouveau taper des commandes
|
||
derrière le prompt). Il faut ensuite éditer le source (dans une autre
|
||
fenêtre pour simplifier la tâche), corriger l'erreur indiquée, sauver le
|
||
document (pour enregistrer la modification) et recompiler. </p>
|
||
|
||
<p> Vous pouvez aussi obtenir un fichier pdf à la place du fichier dvi
|
||
en tapant : </p>
|
||
|
||
<pre>pdflatex document.tex</pre>
|
||
|
||
<p class="continue"> au lieu de <code>latex document.tex</code>. C'est
|
||
souvent préférable, mais attention, certains packages ne marchent
|
||
pas avec pdfLaTeX. Le principal est pstricks : si vous souhaitez
|
||
utiliser pdfLaTeX, vous pouvez utiliser TikZ à la place. Inversement,
|
||
certains packages ne fonctionnent pas avec LaTeX tout court
|
||
(principalement, ceux qui servent à insérer dans un document LaTeX un
|
||
fichier pdf extérieur), et le changement de format (A5...) ou
|
||
d'orientation (paysage...) du papier est plus facile en pdf.</p>
|
||
|
||
<h3>Visualiser son document</h3>
|
||
|
||
<p> Pour visualiser le résuptat de la compilation, qui est le fichier
|
||
<code>.dvi</code>, tapez : </p>
|
||
|
||
<pre>xdvi document.dvi &</pre>
|
||
|
||
<p class="continue">ou encore (plus agréable sous KDE)</p>
|
||
|
||
<pre>kdvi document.dvi &</pre>
|
||
|
||
<p> Le <code>&</code> met le programme lancé en tâche de fond; il
|
||
rend donc la main et on peut taper de nouvelles commandes dans la fenêtre
|
||
où on a lancé le programme, ici <code>xdvi</code> (resp.
|
||
<code>kdvi</code>). Cela vous évite
|
||
d'avoir à relancer le <code>dvi</code> à chaque fois que vous recompilez.
|
||
</p>
|
||
|
||
<p> Si vous avez compilé votre document avec la commande
|
||
<code>pdflatex</code>, tapez à la place <code>xpdf document.pdf
|
||
&</code> ou <code>kpdf document.pdf</code>.</p>
|
||
|
||
<p> Une nouvelle fenêtre va apparaître, qui montre le résultat de la
|
||
compilation. On peut alors relire le document, voir ce qui ne va pas et
|
||
faire la correction dans le source, recompiler et cliquer sur la fenêtre
|
||
<code>dvi</code> : le document recompilé est remis à jour. On procède
|
||
ainsi jusqu'à obtenir le résultat souhaité. </p>
|
||
|
||
<h3>Imprimer avec <code>dvips</code></h3>
|
||
|
||
<p> Reportez-vous au chapitre <a
|
||
href="&url.tuteurs;unix/imprimer.html#dvips">Imprimer</a>. Bien souvent,
|
||
vous pouvez aussi imprimer directement depuis le lecteur dvi ou pdf, qui
|
||
propose cette fonction quelque part dans ses menus.</p>
|
||
|
||
<h2><a name="accents">Les accents et LaTeX</a></h2>
|
||
|
||
<p> Vous pouvez taper indifféremment vos accents avec <code>compose</code> et
|
||
<code>méta</code>. Il peut arriver (selon les configurations) que
|
||
certains accents ne soient pas compris, pour différentes raisons. Si vous
|
||
avez des problèmes, ou si vous voulez faire apparaître des accents
|
||
étrangers, marquez les accents de la manière suivante dans votre
|
||
fichier : <code>\ accent lettre</code>. </p>
|
||
|
||
<p> Par exemple, <code>\'a</code> donnera « á »; <code>\'u</code>
|
||
donnera « ú ». </p>
|
||
|
||
<p> Le codage des accents est le même que celui de compose, à l'exception
|
||
de la cédille (<code>fa\c{c}ade</code> donne façade). Allez voir la page
|
||
des tuteurs consacrée aux <a
|
||
href="&url.tuteurs;unix/accents.html">accents</a> pour savoir comment on
|
||
les tape et pour avoir un tableau des divers accents avec LaTeX. </p>
|
||
|
||
<p> Cela dit, nous vous encourageons à taper vos accents en 8 bits
|
||
(c'est-à-dire, avec la touche Compose, ou naturellement sur un clavier
|
||
AZERTY) ; pour cela, ajoutez systématiquement dans l'entête de votre
|
||
document les deux lignes suivantes: </p>
|
||
|
||
<pre>
|
||
\usepackage[latin1]{inputenc} % accents 8 bits dans le source
|
||
\usepackage[T1]{fontenc} % accents dans le DVI
|
||
</pre>
|
||
|
||
<p> La première ligne demande que les caractères accentués soient
|
||
reconnus comme de l'isolatin1 (par opposition au codage ASCII, qui ne
|
||
contient pas les caractères accentués), la seconde, que soient utilisées
|
||
les fontes de LaTeX incluant les accents. </p>
|
||
|
||
<div class="encadre"> De plus en plus, les systèmes d'exploitation modernes
|
||
codent les lettres accentuées en <a
|
||
href="&url.tuteurs;faq/utf8.html">UTF-8</a> au lieu de latin1. Si
|
||
votre fichier est codé ainsi, remplacez <code>latin1</code> par
|
||
<code>utf8</code> dans les deux lignes d'en-tête données plus haut.
|
||
Vous aurez probablement à faire cela si vous utilisez LaTeX sur un
|
||
Linux installé récemment sur votre machine personnelle, et plus
|
||
probablement encore si c'est une Ubuntu. </div>
|
||
|
||
<div class="metainformation"> Auteurs : Marc Mezarobba (2007),
|
||
François-Xavier Coudert (2002), Émilia Robin (1998). Dernière
|
||
modification le <date value="$Date: 2007-09-01 17:42:23 $"/>. </div>
|
||
|
||
</body>
|
||
</html>
|