Ajout d'une nouvelle entrée dans Logiciels -> LaTeX : aide.tml
« Documentation essentielle et aide ». Table des matières
* Les FAQ
* Documents essentiels
* Quel package utiliser ?
* Documentation du package
* À l'aide !
This commit is contained in:
noirel
parent
f7ea0a0dc9
commit
7c02daf3c0
1 changed files with 261 additions and 0 deletions
261
logiciels/latex/aide.tml
Normal file
261
logiciels/latex/aide.tml
Normal file
|
|
@ -0,0 +1,261 @@
|
||||||
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||||
|
<!DOCTYPE html
|
||||||
|
PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
|
||||||
|
"tuteurs://DTD/tml.dtd">
|
||||||
|
<html>
|
||||||
|
<head>
|
||||||
|
<title>Doc et aide</title>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
|
||||||
|
<h1>Documentation essentielle et aide avec LaTeX</h1>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
La pléthore de documents disponibles sur l'internet est bien classée
|
||||||
|
dans la liste des reproches habituellement faits à l'encontre de LaTeX.
|
||||||
|
LaTeX est en quelque sorte victime de son succès et du souci de ses
|
||||||
|
utilisateurs de partager leurs connaissances et leurs trucs si chèrement
|
||||||
|
acquis. Si cela part d'un bon sentiment, on n'évite pas deux écueils :
|
||||||
|
premièrement, le débutant en quête de renseignements se noie dans les
|
||||||
|
tonnes de réponses que peuvent lui donner quelques mots-clefs comme
|
||||||
|
« <code>interligne double LaTeX</code> » tapés à la sauvette dans
|
||||||
|
Google ; et deuxièmement, dans les pages traitant le sujet, beaucoup
|
||||||
|
donnent de mauvais conseils. Il faut reconnaître malgré tout que
|
||||||
|
l'énorme avantage des documents électroniques est qu'ils sont capables
|
||||||
|
d'évoluer avec le logiciel alors que la plupart des livres ne sont plus
|
||||||
|
d'actualité (le <em>LaTeX companion</em> est la plus belle exception à
|
||||||
|
cette règle).
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Cette page espère faire le tri et je soutiens que les informations
|
||||||
|
pertinentes concernant LaTeX peuvent être trouvées dans la plupart des
|
||||||
|
cas, en se limitant à seulement quelques documents que nous allons
|
||||||
|
présenter ici.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h2>Les <acronym title="Frequently asked questions">FAQ</acronym></h2>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Si vous vous posez une question, il y a fort à parier qu'elle est
|
||||||
|
traitées dans les <acronym title="Frequently asked
|
||||||
|
questions">FAQ</acronym> qui regroupent les interrogations les plus
|
||||||
|
courantes au sujet de LaTeX.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<dl>
|
||||||
|
<dt>
|
||||||
|
<a href="http://www.tex.ac.uk/cgi-bin/texfaq2html">FAQ anglophone</a>
|
||||||
|
</dt>
|
||||||
|
<dd>
|
||||||
|
La FAQ la plus recommandable car à jour, d'utilisation aisée et efficace,
|
||||||
|
disponible dans de nombreux formats (elle est même souvent présente
|
||||||
|
dans les répertoires de documentation des distributions LaTeX, sous le
|
||||||
|
nom <tt>uktug-faq</tt>).
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
<dt>
|
||||||
|
<a href="http://www.grappa.univ-lille3.fr/FAQ-LaTeX/">FAQ
|
||||||
|
francophone</a> (ancienne)
|
||||||
|
</dt>
|
||||||
|
<dd>
|
||||||
|
Pour ceux pour qui la lecture de l'anglais est difficile, cette FAQ
|
||||||
|
francophone est d'utilisation facile mais on déplorera quelques
|
||||||
|
inexactitudes et du code qui commence à dater singulièrement.
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
<dt>
|
||||||
|
<a href="http://faqfctt.fr.eu.org/">FAQ
|
||||||
|
francophone</a> (nouvelle et en cours de rédaction)
|
||||||
|
</dt>
|
||||||
|
<dd>
|
||||||
|
Bien plus récente que la FAQ grappa, cette nouvelle FAQ est
|
||||||
|
malheureusement encore inachevée et elle n'existe pas au format HTML
|
||||||
|
ce qui nuit à l'efficacité de la consultation (étant donné sa
|
||||||
|
taille). Des efforts devraient aller dans le bon sens à l'avenir.
|
||||||
|
</dd>
|
||||||
|
</dl>
|
||||||
|
|
||||||
|
<h2>Documents essentiels</h2>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Nous donnons une liste de documents sûrs et couvrant la plupart des
|
||||||
|
domaines abordés lorsque l'on utilise LaTeX.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<dl>
|
||||||
|
<dt>Introduction à LaTeX</dt>
|
||||||
|
|
||||||
|
<dd>
|
||||||
|
Le document électronique le plus fiable pour commencer à apprendre
|
||||||
|
LaTeX est <em>The not so short introduction to LaTeX2e</em> (elle est
|
||||||
|
disponible en <a
|
||||||
|
href="www.ctan.org/tex-archive/info/lshort/english/lshort.pdf">anglais</a>
|
||||||
|
et en <a
|
||||||
|
href="http://www.ctan.org/tex-archive/info/lshort/french/flshort-3.20.pdf">français</a>).
|
||||||
|
Le livre le plus simple (mais peu utile à long terme, donc je me
|
||||||
|
contente de le citer sans le conseiller) pour débuter est le livre
|
||||||
|
original de Leslie Lamport <em>LaTeX2e, a document preparation
|
||||||
|
system</em>. On regrettera que le <em>LaTeX companion</em> ne soit
|
||||||
|
pas plus adapté à une introduction pas à pas. Plus d'informations aux
|
||||||
|
questions « <a
|
||||||
|
href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=man-latex">Online
|
||||||
|
introductions : LaTeX</a> » et, pour les livres, « <a
|
||||||
|
href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=books">Books on
|
||||||
|
TeX and its relations</a> ».
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
<dt>Graphiques</dt>
|
||||||
|
|
||||||
|
<dd>
|
||||||
|
En ce qui concerne l'insertion de graphiques (externes,
|
||||||
|
c'est-à-dire généralement produits par un programme annexe, XFig,
|
||||||
|
etc.), le document <a
|
||||||
|
href="ftp://cam.ctan.org/tex-archive/info/epslatex/english/epslatex.pdf">Using
|
||||||
|
imported graphics in LaTeX2e</a> est tout simplement excellent.
|
||||||
|
Les autres possibilités du package <code>graphicx</code> sont décrites
|
||||||
|
dans la documentation du package (rotations, mises à l'échelle,
|
||||||
|
etc.) : le fichier <tt><a
|
||||||
|
href="ftp://tug.ctan.org/pub/tex-archive/macros/latex/required/graphics/grfguide.pdf">grfguide</a></tt>
|
||||||
|
(remarque : pour la gestion des couleurs, préférez le package bien plus
|
||||||
|
moderne <code>xcolor</code>).
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
<dt>Symboles, caractères spéciaux</dt>
|
||||||
|
|
||||||
|
<dd>
|
||||||
|
Là encore, la réponse est simple : quel que soit le symbole recherché,
|
||||||
|
la quête doit commencer sur <a
|
||||||
|
href="http://www.tex.ac.uk/tex-archive/info/symbols/comprehensive/symbols-a4.pdf">The
|
||||||
|
comprehensive LaTeX symbol list</a>.
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
<dt>Mathématiques</dt>
|
||||||
|
<dd>
|
||||||
|
Pour faire un tour quasi exhaustif des méthodes existantes concernant
|
||||||
|
l'écriture de formules mathématiques vous pouvez consulter
|
||||||
|
premièrement la documentation d'<code><a
|
||||||
|
href="ftp://tug.ctan.org/pub/tex-archive/info/italian/amsldoc/amsldoc.pdf">amsmath</a></code>
|
||||||
|
qui décrit pas mal de choses ; deuxièmement, un coup d'oeil un peu
|
||||||
|
plus panoramique pourra être jeté sur le thème depuis
|
||||||
|
<code><a
|
||||||
|
href="ftp://tug.ctan.org/pub/tex-archive/info/math/voss/mathmode/Mathmode.pdf">Mathmode</a></code>.
|
||||||
|
</dd>
|
||||||
|
</dl>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Si les mauvaises habitudes sont déjà prises, vous pouvez consulter
|
||||||
|
— à défaut du docteur — la liste des péchés capitaux de
|
||||||
|
LaTeX. Ce document existe <a
|
||||||
|
href="ftp://tug.ctan.org/pub/tex-archive/info/l2tabu/english/l2tabuen.pdf">en
|
||||||
|
anglais</a> et en <a
|
||||||
|
href="ftp://tug.ctan.org/pub/tex-archive/info/l2tabu/french/l2tabufr-heavy.pdf">en
|
||||||
|
français</a>.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h2>Quel package utiliser ?</h2>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
De manière très similaire à ce qui a été décrit pour les packages, le
|
||||||
|
nombre grandissant des packages introduit bien de la confusion dans
|
||||||
|
l'esprit de l'utilisateur. Lire toutes les documentations n'est pas
|
||||||
|
vraiment envisageable. Les outils suivants peuvent vous aider à trouver
|
||||||
|
la perle rare, l'aiguille dans la botte de foin.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<dl>
|
||||||
|
|
||||||
|
<dt>
|
||||||
|
<a href="http://www.ctan.org/search.html#byDescription">Chercher un
|
||||||
|
package par mot-clef sur le <acronym title="Comprehensive TeX
|
||||||
|
archive network">CTAN</acronym></a>
|
||||||
|
</dt>
|
||||||
|
<dd>
|
||||||
|
Vous pouvez chercher un package avec un mot-clef pertinent
|
||||||
|
(« <code>verbatim</code> », ou « <code>bibliography</code> », par
|
||||||
|
exemple).
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
<dt>
|
||||||
|
<a href="http://texcatalogue.sarovar.org/">The TeX catalogue online</a>
|
||||||
|
</dt>
|
||||||
|
<dd>
|
||||||
|
Liste presqu'exhaustive des packages connus sur le CTAN. La liste
|
||||||
|
peut être présentée par ordre alphabétique, par thème (mathématiques,
|
||||||
|
figures, par exemple), accompagnée de courtes descriptions.
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
</dl>
|
||||||
|
|
||||||
|
<h2>Documentation du package</h2>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
La plupart des distributions intègre — ou du moins donne la
|
||||||
|
possibilité d'intégrer — les documentations des packages. Elles
|
||||||
|
se trouvent généralement dans un répertoire <code>$TEXMF/doc</code>, où
|
||||||
|
<code>$TEXMF</code> désigne l'emplacement de l'arborescence TeX de votre
|
||||||
|
système. Les formats utilisés sont PDF, PostScript, DVI et parfois
|
||||||
|
HTML. Des exemples classiques sont <code>/usr/share/texmf</code> ou
|
||||||
|
<code>C:\MikTeX\texmf</code>. Sur les machines Unix, un programme peut
|
||||||
|
vous aider à accéder rapidement à une documentation tapez
|
||||||
|
(<code>$</code> désigne le <em>prompt</em>)
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<pre>
|
||||||
|
$ texdoc <var>nom du package</var>
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Par exemple « <code>texdoc listings</code> ». Attention aux pièges
|
||||||
|
fameux : la documentation d'<code>amsmath</code> s'appelle
|
||||||
|
<tt>amsldoc</tt> et celle de <code>graphicx</code> s'appelle
|
||||||
|
<tt>grfguide</tt>. En outre, certains packages ont leur documentation
|
||||||
|
intégrées au fichier <tt>.sty</tt> (c'est le cas des packages de Donald
|
||||||
|
Arseneau comme <code>framed</code>). <code>fp</code> constitue une
|
||||||
|
autre exception : sa documentation est un fichier texte appelé
|
||||||
|
<tt>readme.fp</tt>.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Une autre possibilité est d'aller trouver la documentation
|
||||||
|
sur le <a href="http://www.ctan.org/">CTAN</a>. Elle est généralement
|
||||||
|
disponible directement en PDF, sinon apprenez comment obtenir de
|
||||||
|
l'information à partir des fichiers <tt>.dtx</tt> grâce à la <a
|
||||||
|
href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=pkgdoc">FAQ
|
||||||
|
(« Documentation of packages »)</a>.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h2>À l'aide !</h2>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Malgré ces quelques documents extrêmement précieux, vous n'avez toujours
|
||||||
|
pas trouvé la commande, l'environnement ou le package de vos rêves :
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>Consultez Usenet, votre question a sans doute été posée.
|
||||||
|
<a href="http://groups.google.fr/">Google groupes</a> vous en dira
|
||||||
|
long pourvu que vos mots-clefs soient pertinents. Songez à restreindre
|
||||||
|
les réponses au groupe <tt>fr.comp.text.tex</tt> avec
|
||||||
|
<code>group:fr.comp.text.tex</code> ou la recherche avancée.</li>
|
||||||
|
<li>Si votre recherche n'aboutit pas, posez votre question sur ces
|
||||||
|
groupes : <tt>fr.comp.text.tex</tt> et <tt>comp.text.tex</tt> (si vous
|
||||||
|
êtes familier avec l'anglais). Pensez à respecter la <a href="http://www.sri.ucl.ac.be/SRI/rfc1855.fr.html#313">netiquette</a> et à
|
||||||
|
préparer un <a
|
||||||
|
href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=minxampl">exemple
|
||||||
|
complet minimal</a> !</li>
|
||||||
|
<li>Si vous êtes élève, ancien élève ou étudiant de l'École normale
|
||||||
|
supérieure, vous pouvez soit contacter les tuteurs informatiques en
|
||||||
|
respectant les mêmes consignes que pour Usenet : respect de la
|
||||||
|
netiquette et préparation d'un exemple complet et minimal ; soit poser
|
||||||
|
votre question sur forum.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<div class="metainformation">
|
||||||
|
Auteur : Josselin Noirel.
|
||||||
|
Dernière modification le <date value="$Date: 2005-11-30 18:54:55 $" />.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
Loading…
Add table
Reference in a new issue