« LaTeX/Structure du document » : différence entre les versions

 

Si vous vous rappelez du cours d'instruction précédent, le préambule est la partie se trouvant au tout début du fichier source LaTeX avant la commande <code>\begin{document}</code>. Elle contient normalement les commandes qui affectent le document entier.

% simple.tex – Un exemple d'article simple pour illustrer la structure d'un document.

\documentclass{article}

\begin{document}

...

La première ligne est un commentaire (signalé par le symbole <code>%</code>). La commande de <code>\documentclass</code> prend un paramètre, qui est dans ce cas ''article'', parce que c'est le type de document que nous voulons produire. Les autres classes existantes sont ''book'', ''report'', ''thesis'' etc. Il est également possible de créer vos propres classes, comme souvent les éditeurs de journal le font, en fournissant simplement leur propre fichier de classe qui indique à LaTeX comment composer le contenu. Mais nous nous contenterons de la classe standard d'article pour l'instant. La commande <code>\usepackage</code> est une commande importante qui demande à LaTeX d'utiliser quelques macro-commandes externes. Dans cet exemple, j'ai indiqué <code>times</code> qui signifie que LaTeX emploiera les polices postscript de type 1, qui paraissent plus jolies :).

 

 

<span id="babel6">Voici</span> une autre possibilité de commencer le document en plaçant l'option de langue dans le préambule :

% simple.tex – Un exemple d'article simple pour illustrer la structure d'un document.

\documentclass[frenchb]{article}

\begin{document}

...

ainsi chaque nouvelle commande <code>\usepackage</code> saura automatiquement (si besoin est) qu'elle doit utiliser l'option <code>frenchb</code>

ici plus besoin donc de rajouter l'option <code>frenchb</code> au paquet <code>babel</code>.

Toutes ces informations, Latex les désigne collectivement sous le nom d{{'}}''entrée en matière''.

Un exemple :

\title{Comment structurer un document \LaTeX{}}

\author{Andrew Roberts\\

 

\maketitle

 

La commande <code>\title</code> est assez simple à utiliser. Mettez simplement le titre que vous voulez entre les accolades.

 

Parce que beaucoup d'articles de recherche ont un résumé, certaines classes de document disposent d'un environnement permettant de définir une partie du contenu comme étant le résumé. Celui-ci devrait apparaître dans un ordre logique, c'est-à-dire après l'entrée en matière, mais avant les sections principales du corps du document.

\begin{abstract}

Votre résumé commence ici...

...

\end{abstract}

 

Cet environnement <code>abstract</code> est disponible pour les classes <code>article</code> et <code>report</code>, mais ''pas'' pour la classe <code>book</code>. Il est toutefois simple d'en bricoler un :

 

Les commandes pour insérer des sections sont assez intuitives. Naturellement, certaines commandes sont appropriées à différentes classes de documents. Par exemple, un livre a des chapitres mais un article n'en a pas. Voici une énumération de certaines des commandes de structure utilisées dans ''simple.tex''.

\section{Introduction}

Cette section contient...

\subsubsection{Information de l'article}

Cette sous-sous-section contient...

 

Comme vous pouvez le voir, les commandes sont assez intuitives. Notez que vous n'avez pas besoin d'indiquer les numéros de section, Latex s'occupera de cela pour vous ! En outre, pour les sections, vous n'avez pas besoin de préciser à quel bloc appartient tel contenu, en utilisant des commandes comme <code>\begin</code> ou <code>\end</code> par exemple.

 

La numérotation des sections est réalisée automatiquement par Latex, ainsi ce n'est pas la peine de rajouter explicitement de numéro ; il suffit juste d'insérer le titre que vous voulez entre les accolades. Si vous ne voulez pas de numérotation de section, ajoutez un astérisque « * » après la commande de section, mais avant la première accolade ouvrante, par exemple :

\section*{Un titre sans numéro}

dans ce cas-là, le titre ne figure pas dans la table des matières. Pour qu'il y figure, il faut ajouter la commande <code>\addcontentsline{toc}{''niveau''}{\protect\numberline{}''titre''}</code>, par exemple

\section*{Préface}

\addcontentsline{toc}{section}{\protect\numberline{}Préface}

 

== La bibliographie ==

 

Par exemple, pour un fichier <code>test.tex</code> :

\documentclass{article}

 

 

\end{document}

Entre la première et la deuxième compilation du fichier <code>.tex</code>, exécuter en ligne de commande :

# <code>makeindex test</code> (ou bien utiliser la commande <code>makeindex</code> de l'éditeur de texte) ;