Aller au menu - Aller au contenu

Icône Les notes

Mise à jour : 15/10/2010
Difficulté : Facile Facile Durée d'étude : 5 heures Creative Commons BY-NC-SA
20 808 visites depuis 7 jours, dont 544 sur ce chapitre classé 16/786
Nous allons aborder ensemble le chapitre traitant des différentes notes et références possibles dans LaTeX.

Ce chapitre vous permettra de :
  • citer des textes
  • insérer des paragraphes de code brut dans vos documents
  • créer des minipages
  • composer des notes de bas de page.
Les références internes seront abordées elles aussi dans ce chapitre.

Ce court chapitre est le dernier de la partie 2, c’est le dernier chapitre présentant des commandes « simples ». La partie 3 et le tp introduisant des commandes aux utilisations plus ardues, prenez le temps de vous entrainer lors de ce chapitre et reproduisez les exemples donnés afin de continuer de vous familiariser avec les commandes et les packages.

LaTeX n’est pas un langage difficile mais il s’acquiert par la pratique, ne la négligez pas.
Sommaire du chapitre :
Icône du chapitre
Chapitre précédent Sommaire Chapitre suivant

Citation, code brut et url

Cette première sous-partie développe simplement les manières de créer des citations de texte, de code ainsi que la façon de compiler une URL cliquable.

Les citations simples


Fréquemment, vos rapports nécessiteront que vous citiez des propos. Pour vous permettre cela, deux environnements vous sont proposés : quote et quotation.

Code : TeX
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce condimentum tempor risus cursus aliquet.
Nulla porttitor arcu in dolor tristique euismod. Cras arcu mi, adipiscing non ornare id, tristique ut ante.
\begin{quote}Tout individu a droit à la vie, à la liberté et à la sûreté de sa personne.\end{quote}
consectetur adipiscing elit. 
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Nulla volutpat metus ut magna aliquam nec porttitor neque sodales. 
\begin{quotation}Tout individu a droit à la vie, à la liberté et à la sûreté de sa personne.  \end{quotation}
sit amet suscipit tortor pulvinar sed. Proin laoreet, 
orci iaculis ullamcorper pulvinar, lectus sapien accumsan nulla, 
ut condimentum orci diam sit amet justo.

les citations simples

Le code source donné ci-dessus vous montre la différence entre quote et quotation : le nombre de tabulations avant le premier mot.

Les citations de code


Trois méthodes majeures se partagent les différents types de citations de code.

La commande \verb


Pour insérer du code dans un paragraphe, le plus simple reste d’utiliser la commande \verb. Cette commande a la particularité de délimiter le texte concerné par son application par le caractère venant juste après verb.

Les trois premières lignes de codes donnent donc le même résultat et la quatrième ne fonctionne pas (le & est le délimiteur dans la quatrième ligne et, étant donné qu'il y a déjà un & dans le code, LaTex comprendra mal l'instruction et n'encadrera que le premier mot «lapin») :

Code : TeX
1
2
3
4
\verb[lapin & lapin {} [
\verb|lapin & lapin {} | %les usagers utilisent la majeure parti du temps le signe |
\verb(lapin & lapin {} (
\verb&lapin & lapin {} &


L’environnement verbatim(tab)


L’environnement verbatim, accompagné du package du même nom, permet d’encadrer de gros volumes de code. Petit souci : il remplace les tabulations par des espaces.

Code : TeX
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
\documentclass{article}

\usepackage[latin1]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[francais]{babel}
\usepackage{verbatim}
\begin{document}

\begin{verbatim}
votre code
\end{verbatim}
\end{document}


Afin d’éviter ce désagrément et de choisir le nombre d’espaces liés à une tabulation, vous pouvez utiliser l’environnement \begin{verbatimtab}[nombre_d’espace_par_tabulation] fourni par le package supplémentaire moreverb.

Code : TeX
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
\documentclass{article}

\usepackage[latin1]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[francais]{babel}
\usepackage{verbatim}
\usepackage{moreverb}
\begin{document}

\begin{verbatimtab}[10]
votre code
\end{verbatimtab}
\end{document}

L’environnement lstlisting


L’environnement lstlisting permet de mettre en forme de façon colorée et d’utiliser de nombreuses options pour afficher du code.

Dans un premier temps dans l’en-tête du document, vous devez appeler le package listings avant d’utiliser la commande \lstset et de la paramétrer pour qu’elle mette en forme votre code selon vos souhaits.

La commande \lstset se place avant \begin{document} et possède un grand nombre d’arguments paramétrables.

Code : TeX
1
2
3
4
5
6
7
8
\lstset{ %
language=nom_du_langage,        % choix du langage
basicstyle=\footnotesize,       % taille de la police du code
numbers=left,                   % placer les numéros de lignes à droite (right) ou à gauche (left)
numberstyle=\normalsize,        % taille de la police des numéros
numbersep=7pt,                  % distance entre le code et sa numérotation
backgroundcolor=\color{white},  % Couleur du fond. Possibilité d’utilisation du package color
}


Les langages compatibles avec la commande sont mis à jour constamment sur la page de wikibooks consacrée au package listings. Allez y jetez un coup d’œil à chaque fois que vous utiliserez ce package.

Le code à afficher s’insère dans votre document via l’environnement lstlisting.

Petit exemple ci-dessous de traitement de code C (tiré du tutoriel de C du site du zéro) avec lstlisting.
Code : TeX
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
\documentclass{article}

\usepackage[latin1]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[francais]{babel}

\usepackage{listings}
\lstset{
language=C,
basicstyle=\footnotesize,
numbers=left,
numberstyle=\normalsize,
numbersep=7pt,
}

\begin{document}

\begin{lstlisting}
if (age == 2)
{
  printf("Salut bebe !");
}
else if (age == 6)
{
  printf("Salut gamin !");
}
else if (age == 12)
{
  printf("Salut jeune !");
\end{lstlisting}


\end{document}


citation de code


Gestion des urls


LaTeX gère les urls de façon très efficace, vous permettant de rendre interactifs vos documents.

Pour insérer une Url, il vous suffit d’utiliser le package url ainsi que la commande \url{adresse}, rien de plus compliqué que celà.

Minipage et texte encadré

Il peut être parfois utile de faire ressortir une portion de texte de façon singulière. L’environnement minipage et la commande \fbox vous permettent d’encadrer du texte et de le mettre en valeur.

Répétons le une fois de plus, ce n’est pas parce que vous saurez faire des cadres après ce paragraphe qu’il faut en mettre partout.

Restez sobre, vos lecteurs vous en remercieront.

La commande \fbox



La commande \fbox{mon bout de texte} a déjà été vue précédemment. Elle permet d’encadrer des portions de texte.

Bien que nous ayons vu la commande dans le chapitre précédent, nous n’avons pas vu les paramètres applicables à celle-ci. \fbox est une commande puissante, pour laquelle il est possible de paramétrer des tas de choses. Néanmoins nous limiterons l’usage de \fbox à l’encadrement de texte dans ce cours.

Les deux paramètres qui nous intéressent ici sont l’écart entre le texte et la bordure ainsi que l’épaisseur de cette dernière.

Petite démonstration de la méthode permettant de changer ces deux paramètres et capture d’écran du résultat ci-dessous.
Code : TeX
1
2
3
\setlength{\fboxsep}{8mm} % Commande permettant de définir l’écart
\setlength{\fboxrule}{2mm} % Commande permettant de définir l’épaisseur du trait
\fbox{Un lapin}

texte encadré

L’environnement minipage



Une minipage est un encart de texte de largeur choisie encadré en noir. A l’intérieur de cet encart de texte, vous pourrez disposer et utiliser des environnements comme si cette minipage était un document à part entière.

En quelque sorte, une minipage est un document dans un document. Il vous est même possible d’insérer une minipage dans une minipage (mais nous allons éviter de faire des choses qui ne servent à rien). :D

L’environnement minipage est dépendant de deux paramètres : sa largeur et son alignement.

Pour ce qui est de la largeur, il est facile de comprendre le rôle du paramètre, il s’exprime en cm. Le paramètre d’alignement quant à lui est plus fin à comprendre. L’alignement est vertical et défini par rapport au niveau du texte. Trois alignements vous sont proposés.

Un schéma vaut mieux qu’un long discours pour visualiser les trois alignements proposés.

alignements possibles des minipages


Ici, une démonstration d’une minipage centrée de 5cm de large et centrée verticalement obtenue via la commande :
Code : TeX
1
2
3
4
5
\fbox{ %fbox est utilisé pour voir les bords de la minipage
\begin{minipage}[c]{5cm}
Un petit paragraphe sur les lapins.
\end{minipage}
}


exemple de mminipage


Notes de bas de pages, références internes

Cette sous-partie traite des notes de bas de pages ainsi que des références internes dans les documents.

Ces deux éléments, souvent négligés, montrent à votre lectorat que votre texte est structuré et bien pensé.

Notes de bas de pages



Il existe deux écoles pour l’insertion de notes de bas de page.

La commande \footnote



La première consiste à utiliser la commande \footnote{texte de la note} tout simplement aux emplacements où renvoyer vers une note de bas de page est souhaité.

Cette commande est très intuitive, la seule chose à paramétrer ici est l’espacement entre l’exposant renvoyant à la note et le mot ou le groupe de mots concernés, trois solutions sont disponibles :
  • coller l’exposant au mot concerné
  • utiliser une espace, qui peut parfois être trop large
  • insérer via la commande \, une espace plus fin.


Code : TeX
1
2
3
un canard\,\footnote{bestiole qui fait coin}
un ornithorynque\,\footnote{bestiole qui fait rire}
un ours\,\footnote{bestiole qui fait mal}


pieds de page (méthode simple)


La commande \footnotemark



Ici l’opération se passe en deux temps. Dans un premier temps vous marquerez les éléments concernés par des notes de bas de pages via la commande \footnotemark[numéro_de_la_note] , les notes de bas de pages correspondantes aux numéros sont données par la commande \footnotetext[numéro_de_la_note]{Texte correspondant} .

Ici deux compilations sont nécessaires, l’une pour que LaTeX liste les marques, l’autre pour que LaTeX associe les notes de bas de pages aux marques. Cette méthode est souvent salvatrice lorsque des erreurs apparaissent avec \footnote . Utilisez-la préférentiellement.

Ci-dessous un code source de démonstration ainsi qu’une capture d’écran prise après deux compilations.

Code : TeX
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
un canard\,\footnotemark[1]

un ornithorynque\,\footnotemark[18]

un ours\,\footnotemark[32]


\footnotetext[1]{bestiole qui fait coin}
\footnotetext[18]{bestiole qui fait rire}
\footnotetext[32]{bestiole qui fait mal}


pieds de page (méthode avancée)


Les références internes



LaTeX vous permet d’écrire des références internes de façon simple, pour ce faire trois commandes sont à connaitre.

La commande \label{nom_choisi} sert à marquer un endroit.

Les commandes \ref{nom_choisi} et \pageref{nom_choisi} vous permettent d’appeler la page ou la référence de l’élément marqué dans une autre zone de votre document.

Petite démonstration (avec rendu en suivant) :

Code : TeX
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
\documentclass{report}

\usepackage[latin1]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[francais]{babel}

\begin{document}

\part{Partie}

\chapter{Chapitre}
\section{Section}
\subsection{Une sous-section}
\label{patate} 
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
 Donec nec condimentum libero. Phasellus condimentum porttitor congue.
 Morbi eget quam sed justo egestas lobortis. Aenean et erat metus.
\chapter{Chapitre}
\section{Section}
\subsection{Une sous-section}
Ici nous parlerons de la sous section \ref{patate} vue à la page \pageref{patate} .
\end{document}


Sur la page où la référence est faite, nous pouvons lire :

référence interne

Q.C.M.

L'environnement verbatimtab nécessite l'utilisation de combien de package(s) ?
Est-il possible d'encadrer une minipage avec un liseré noir ?
La commande url{} nécessite l'utilisation de combien de package(s) ?

Statistiques de réponses au QCM

Les citations et références diverses n’ont maintenant plus aucun secret pour vous. Vous pourrez dès à présent mettre en valeur de façon forte certaines parts de vos publications via des minipages et relier les pages entres elles via des références internes.

Ce chapitre est le dernier de la partie deux, nous allons attaquer ensemble notre premier gros exercice d’application : la composition d’un livre (court, rassurez-vous) contenant l’intégralité de la déclaration universelle des droits de l’homme et du citoyen.

Jeune Zéro, après cette épreuve tu seras un Padawan ! :D
Chapitre précédent Sommaire Chapitre suivant

Partager

8 commentaires pour "Les notes"
Note moyenne : 3.61 / 4 (536 votes)
Pseudo Commentaire
Hors ligne Kazu- # Posté le 19/07/2010 à 15:49:30
Manifeste!
Avatar

Études : INSA Lyon

Y a-t-il une manière d'aligner le texte par rapport à la minipage?

L'exemple que j'ai en tête, c'est quand dans un WYSIWYG on met une image, on peut choisir d'aligner le texte par rapport à l'image(le texe borde donc l'image, sans laisser de blanc).

On peut faire pareil avec la minipage ? Car là ça laisse un espace plutôt disgracieux.
Hors ligne Ha-Zherty # Posté le 24/07/2010 à 17:02:19
C'est pas faux
Avatar

Avis : Très bon

Comment peut-on ajouter de nouveaux mots-clés à un language pour qu'ils soient colorisés à l'aide de lstlisting?

[EDIT]: En postant, je me suis rendu compte qu'il fallait que je poste sur le fofo. Désolé.

(X)HTML/CSS: |||||||||| 100% :)
PHP/SQL: |||||||||| 30% :-°
C/C++: |||||||||| 30% :-°
 
Hors ligne 33xiT # Posté le 03/11/2010 à 20:02:49
PHP fanatic
Avatar

Avis : Bon

Les URL ne fonctionnent pas chez moi... L'URL apparait mais celle-ci n'est pas cliquable... Une idée ?
Merci.

Edit : j'ai trouvé, c'est parce que mon document était en mode « draft » ^^ :p
 
Hors ligne Morphilos # Posté le 01/01/2011 à 14:30:55

Avis : Très bon

Études : ESIEE Engineering Paris

Bonjour, j'ai un petit problème avec les fbox, en effet, j'aimerais encadrer une image (j'ai eu le même problème en voulant encadrer du code), j'ai donc écrit ce code :
Code : TeX
1
2
3
4
5
6
7
8
9
\fbox{
\begin{figure}[h]
\begin{center}
 \includegraphics[height=4cm]{images/bonjour.png} 
\end{center}
 \caption{Capture d'écran de la Console du code de l'Exercice 1}
 \label{Capture d'écran de la Console}
\end{figure}
}


Cela me génère trois erreurs à la compilation, la première étant : LaTeX Error : Not in outer par mode, et voici la capture d'écran des deux suivantes :

http://img832.imageshack.us/i/capturerw.png/

Merci d'avance,

Morphilos
Hors ligne remontees # Posté le 15/11/2011 à 21:57:42
Vive Symfony2 !
Avatar

Désolé, mais j'ai rien compris aux délimitateurs. Un exemple aurait été le bienvenu. Sinon, bravo pour ce superbe cours ! :)

Pensez à indiquer les messages qui vous ont aidé et à indiquer vos problèmes résolus ;)
XHTML 1.0/CSS <= 2 : IIIIIIIIII
PHP/MySQL : IIIIIIIIII
Javascript : IIIIIIIIII
HTML5/CSS3 : IIIIIIIIII



Citation
Je sais plus ce que j'écrivais ! :)
Qui que quoi dont où
Alors j'ai activé la prévisualisation automatique !
Citation : Moi
Eh oui

Et maintenant je suis tranquille !



Mon site : http://remontees.free.fr
 

Voir tous les commentaires