Images et références croisées en LaTeX

Introduction

Dans cette partie du cours sur LaTeX, nous allons évoquer les points suivants:

  • comment intégrer une image avec une légende (note: le placement de l'image est automatique)

    • les commandes LaTeX pour intégrer une image

    • quelques commandes LaTeX pour le formatage (position sur la page, taille)

    • gérer le chemin de destination à l'image (par exemple si elle est dans un dossier)

    • les commandes LaTeX pour ajouter une légende

  • comment gérer des références croisées en LaTeX

    • faire référence à une figure

    • faire référence à une section, sous-section ou sous-sous-section

Intégrer une figure avec une légende


Vue d'ensemble

Voici une représentation des éléments nécessaires pour ajouter une figure. Une figure est une image intégrée dans votre texte pour appuyer votre propos. Elle contient en LaTeX au moins:

  • la balise \begin{figure}

  • l'image insérée via \includegraphics{ } et indiquant le nom et le dossier où est votre image ( il s'agit de nomImage.png dans le code ci-contre)

  • la légende avec \caption{ }, entre accolade on ajoute le texte de la légence (il s'agit de Ma légende dans le code ci-contre)

  • nous verrons dans la partie sur les références croisées l'utilisation de \label{ }

  • la balise \end{figure}

\begin{figure} [h]

\centering

\includegraphics[width=1\textwidth]{nomImage.png}

\caption{Ma légende}

\label{labelFigure}

\end{figure}

Indiquer le début et la fin d'une figure

Code minimum nécessaire

Le début et la fin d'une figure en LaTeX sont indiqués avec

  • la balise \begin{figure}

  • la balise \end{figure}

Cela permettra notamment de faire une liste des figures avec la commande \listoffigures. Cela génére l'équivalent d'un sommaire pour les figures.

Par ailleurs, vos figures auront un numéro de figure, mis à jour automatiquement.


\begin{figure}




\end{figure}

Attributs: position de la figure dans le texte

La mise en place de la figure se fait automatiquement en LaTeX, en prenant en compte la place nécessaire demandée. On ajoute alors entre crochet un attribut après \begin{figure}.

Les attributs possibles sont:

  • h pour "here". Dans la mesure du possible, la figure sera intégrée à l'endroit où il y a le begin figure dans le code source. Le code est alors: \begin{figure} [h]

  • t pour "top". La figure sera intégrée à en haut d'une page. Le code est alors: \begin{figure} [t]

  • b pour "bottom". La figure sera intégrée en bas d'une page. Le code est alors: \begin{figure} [b]

  • p pour "page". La figure sera intégrée dans une page séparée. Le code est alors: \begin{figure} [p]


\begin{figure} [h] % h ou t ou b ou p




\end{figure}

Attributs: centrer, aligner à droite, aligner à gauche

On peut ajouter une ligne qui permet de centrer, aligner à droite ou aligner à gauche:

Les attributs possibles sont:

  • \centering pour centrer la figure

  • \raggedright pour aligner la figure à droite

  • \raggedleft pour aligner la figure à gauche


\begin{figure} [h] % h ou t ou b ou p

\centering % \centering ou \raggedright ou \raggedleft




\end{figure}

Intégrer une image

Code minimum nécessaire

On inclut une image avec la commande:

  • \includegraphics{nomImage.png}

L'information (ici nomImage.png) permet de trouver l'image. Vous verrez plus d'informations par la suite à ce sujet


Par ailleurs, il faut impérativement, avant la balise \begin{document} ajouter le package graphicx qui permet d'insérer des images:

  • \usepackage{graphicx} à ajouter avant \begin{document} dans votre document LaTeX

\begin{figure} [h]

\includegraphics{nomImage.png}



\end{figure}

Attributs: largeur de l'image par rapport à la largeur de la page

On peut avoir besoin de modifier la largeur de l'image. Une possibilité est de le faire en indiquant un pourcentage par rapport à la largeur de la page avec l'attribut [width=1\textwidth] de \includegraphics:

  • width signifie largeur

  • \textwidth prend la valeur de la largeur du texte dans la mise en page du document

  • le nombre, entre 0 et 1 devant \textwidth indique pourcentage (0=0%, 1=100%, 0.5=50%, 0.67=67%)

Quels exemples possibles:

  • 100% de la largeur du texte: \includegraphics[width=1\textwidth]{nomImage.png}

  • 90% de la largeur du texte: \includegraphics[width=0.9\textwidth]{nomImage.png}

  • 85% de la largeur du texte: \includegraphics[width=0.85\textwidth]{nomImage.png}

  • 62% de la largeur du texte: \includegraphics[width=0.62\textwidth]{nomImage.png}

  • 50% de la largeur du texte: \includegraphics[width=0.5\textwidth]{nomImage.png}

  • 18% de la largeur du texte: \includegraphics[width=0.18\textwidth]{nomImage.png}

\begin{figure} [h]

\includegraphics[width=1\textwidth]{nomImage.png}



\end{figure}

Gérer l'intégration de l'image en fonction de son emplacement

Si l'emplacement est à la racine, dans le même dossier que le code source

Si l'image et le fichier latex sont au même niveau (cf ci-dessous pour une illustration dans Overleaf), il suffit de mettre dans \includegraphics le nom de l'image:

  • \includegraphics{nomImage.png}


Un exemple pour l'illustration ci-dessous, où l'image s'appelle picture.jpg:

  • \includegraphics{picture.jpg}

Cela fonctionne également avec la modification de la taille vue précédemment, par exemple pour 90% de la largeur du texte:

  • \includegraphics[width=0.9\textwidth]{picture.jpg}

\begin{figure} [h]

\includegraphics{nomImage.png}



\end{figure}

Si l'image est dans un dossier: Solution 1

Si l'image est dans un dossier (cf ci-dessous pour une illustration dans Overleaf), il suffit de mettre dans \includegraphics le nom de l'image précédée du chemin vers l'image:

  • \includegraphics{nomDuDossier/nomImage.png}


Un exemple pour l'illustration ci-dessous, où l'image s'appelle picture.jpg et est dans le dossier Images:

  • \includegraphics{Images/picture.jpg}

Cela fonctionne également avec la modification de la taille vue précédemment, par exemple pour 90% de la largeur du texte:

  • \includegraphics[width=0.9\textwidth]{Images/picture.jpg}


\begin{figure} [h]

\includegraphics{nomDuDossier/nomImage.png}



\end{figure}

Si toutes les images sont dans un même dossier: Solution 2

Si toutes les images sont dans un même dossier, on peut mettre juste après le \usepackage{graphicx} on peut ajouter \graphicspath{ {./nomDuDossier/} }. Par la suite, on pourra appeler les images simplement par leur nom d'image.

A mettre avant \begin{document}

  • \usepackage{graphicx}

  • \graphicspath{ {./nomDuDossier/} }

A mettre entre \begin{figure} et \end{figure} :

  • \includegraphics{nomImage.png}


Un exemple pour l'illustration ci-dessous, où l'image s'appelle picture.jpg et est dans le dossier Images:

A mettre avant \begin{document}

  • \usepackage{graphicx}

  • \graphicspath{ {./Images/} }

A mettre entre \begin{figure} et \end{figure} :

  • \includegraphics{picture.jpg}


\begin{figure} [h]

\includegraphics{nomImage.png}



\end{figure}

Ajouter une légende

Code minimum nécessaire

Le texte de la légende est à mettre entre les accolades de l'instruction \caption{ }.

Par exemple, pour mettre la légende "Ceci est la légende de mon image", on ajoutera après \includegraphics :

  • \caption{Ceci est la légende de mon image}


\begin{figure} [h]

\centering

\includegraphics[width=1\textwidth]{nomImage.png}

\caption{Ma légende}

\end{figure}

Citer la source de l'image dans la légende

Le texte de la légende est à mettre entre les accolades de l'instruction \caption{ }, dans laquelle on va simplement utiliser \cite{} comme dans le texte. La référence sera alors intégrée à la légende.

Par exemple, pour mettre la légende "Ceci est la légende de mon image" et citer la source (code bibtex: thevin2018)

  • \caption{Ceci est la légende de mon image \cite{thevin2018} }


\begin{figure} [h]

\centering

\includegraphics[width=1\textwidth]{nomImage.png}

\caption{Ma légende \cite{bibCode} }

\end{figure}

Les références croisées en LaTeX

Vue d'ensemble

Les références croisées permettent de faire référence à une section, à une figure ou à une sous-section en mettant automatiquement un lien et le numéro de la partie ou de la figure.

Cela se faite en deux temps:

  • définir le label au niveau de la section, de la sous-section ou de la figure avec \label{ }

  • faire référence à ce label dans le texte avec \ref{ }

  • éventuellement faire référence à la page de la figure, la section ou de la sous section avec \pageref{ }


La commande LaTeX \label{ } permet de créer le label, c'est à dire le "code" (sorte de raccourci) pour y faire référence par la suite. On utilise la commande \label avec le nom du label choisi entre accolades (il doit être unique).

Par exemple, pour définir le label avec le code monImage :

  • \label{monImage}


La commande LaTeX \ref{ } permet de faire référence au code défini avec \label, et cela va transformer cette commande en numéro (numéro de section, numéro de figure etc.). On utilise la commande \ref avec le nom du label auquel on fait référence entre accolades :

Par exemple, pour faire référence à ma figure avec le code monImage :

  • La figure \ref{monImage} illustre ce propos.


La commande LaTeX \pageref{ } permet de faire référence au code défini avec \label, et cela va transformer cette commande en numéro de page (page sur laquelle est la section, la figure etc.). On utilise la commande \pageref avec le nom du label auquel on fait référence entre accolades :

Par exemple, pour faire référence à la page sur laquelle est ma figure avec le code monImage :

  • Vous pouvez voir la figure qui illustre ce propos page \pageref{monImage} .


\section{Titre de ma section } \label{leNomDuLabel}



La section \ref{leNomDuLabel}, dans le présent document \pageref{leNomDuLabel}, parle des références croisées.

Figure: code minimum nécessaire

Entre \begin{figure} et \end{figure}, on définit un label unique entre les accolades de \label{ }. Pour créer le label labelFigure, on utilise:

  • \label{labelFigure}


Dans le texte d'un document , la commande LaTeX \ref{ } va transformer cette commande en numéro de figure et la commande LaTeX \pageref{ } va transformer cette commande en numéro de page sur laquelle est la figure.


On utilise les commandes \ref et \pageref avec le nom du label auquel on fait référence entre accolades. Pour faire référence avec le label labelFigure:

  • La figure \ref{labelFigure} illustre ce propos, et est visible page \pageref{labelFigure}.


\begin{figure} [h]

\centering

\includegraphics[width=1\textwidth]{nomImage.png}

\caption{Ma légende}

\label{labelFigure}

\end{figure}


La figure \ref{labelFigure}, dans le présent document \pageref{labelFigure}, parle des références croisées.


Sections: code minimum nécessaire

Juste après la commande \section{ }, on définit un label unique entre les accolades de \label{ }. Pour créer le label maSection, on utilise:

  • \label{maSection}


Dans le texte d'un document , la commande LaTeX \ref{ } va transformer cette commande en numéro de section et la commande LaTeX \pageref{ } va transformer cette commande en numéro de page sur laquelle est la section.


On utilise les commandes \ref et \pageref avec le nom du label auquel on fait référence entre accolades. Pour faire référence avec le label maSection:

  • La section \ref{maSection} fournit une information sur le domaine informatique, et est visible page \pageref{maSection}.


\section{Introduction} \label{sectionIntroduction}


La section \ref{sectionIntroduction}, dans le présent document \pageref{sectionIntroduction}, parle du document en général.


Sous-sections: code minimum nécessaire

Juste après la commande \subsection{ }, on définit un label unique entre les accolades de \label{ }. Pour créer le label maSousSection, on utilise:

  • \label{maSousSection}


Dans le texte d'un document , la commande LaTeX \ref{ } va transformer cette commande en numéro de sous-section et la commande LaTeX \pageref{ } va transformer cette commande en numéro de page sur laquelle est la sous-section.


On utilise les commandes \ref et \pageref avec le nom du label auquel on fait référence entre accolades. Pour faire référence avec le label maSousSection:

  • La sous-section \ref{maSousSection} fournit une information sur la progammation en informatique, et est visible page \pageref{maSousSection}.


\subsection{Etat de l'art} \label{etatDeLart}


La sous-section \ref{etatDeLart}, dans le présent document \pageref{etatDeLart}, parle de l'état de l'art.


Sous-sous-sections: code minimum nécessaire

Juste après la commande \subsubsection{ }, on définit un label unique entre les accolades de \label{ }. Pour créer le label maSousSousSection, on utilise:

  • \label{maSousSousSection}


Dans le texte d'un document , la commande LaTeX \ref{ } va transformer cette commande en numéro de sous-sous-section et la commande LaTeX \pageref{ } va transformer cette commande en numéro de page sur laquelle est la sous-sous-section.


On utilise les commandes \ref et \pageref avec le nom du label auquel on fait référence entre accolades. Pour faire référence avec le label maSousSection:

  • La sous-sous-section \ref{maSousSousSection} fournit une information sur la progammation des boucles, et est visible page \pageref{maSousSousSection}.


\subsubsection{Etat de l'art} \label{sic}


La sous-section \ref{sic}, dans le présent document \pageref{sic}, parle des Sciences de l'information et de la communication.