> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/fr/autres-sujets/28-inserting-images-es.md). # Insérer des images Les images sont des éléments essentiels dans la plupart des documents scientifiques. LaTeX offre plusieurs options pour gérer les images et les faire apparaître exactement comme vous en avez besoin. Cet article explique comment inclure des images dans les formats les plus courants, comment les rendre plus petites ou plus grandes, et comment ajouter des références aux images dans le document. ## Introduction Ci-dessous un exemple sur la façon d'importer une image dans LaTeX. ```latex \documentclass{article} \usepackage{graphicx} \graphicspath{ {images/} } \begin{document} L'univers est immense et il semble homogène, à grande échelle, partout où nous regardons. \includegraphics{universe} Il y a une image d'une galaxie au-dessus \end{document} ``` ![InsertingImagesEx1.png](/files/4b48a18561ec7d91b12d4b92150af4cd03885df6) LaTeX n'a pas la capacité de manipuler les images par lui-même ; c'est pourquoi il faut importer le paquet **graphicx**. Pour utiliser ce paquet, ajoutez la ligne suivante dans le préambule de votre document ```latex \usepackage{graphicx} ``` La commande `\graphicspath{ {images/} }` indique à LaTeX que les images sont enregistrées dans un dossier appelé *images* sous le répertoire courant. La commande `\includegraphics{universe}` est celui qui se charge d'inclure l'image dans le document. Ici, *universe* est le nom du fichier image, sans l'extension ; ainsi *universe.PNG* devient *universe*. Le nom du fichier image ne doit pas contenir d'espaces ni de multiples signes de ponctuation. Remarque : *On peut indiquer l'extension du fichier, mais il est recommandé* de l'omettre. Si l'extension est omise, cela amène LaTeX à rechercher tous les formats pris en charge. Pour plus de détails, consultez la section [Génération d'images en haute et basse résolution](#generando-imgenes-en-alta-y-baja-resolucin). [Ouvrir un exemple dans Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Le chemin vers le dossier d'images Lorsqu'on travaille sur un document qui inclut plusieurs images, une possibilité pour garder votre projet organisé est de les enregistrer dans un dossier séparé. Dans l'exemple d'introduction, cela se fait au moyen de la commande `\graphicspath{ {images/} }` qui indique à LaTeX que les images doivent être recherchées dans le dossier *images*. Le chemin est *relatif* au répertoire de travail courant. Le chemin vers le dossier peut être ***relatif*** (recommandé) si le dossier se trouve dans le même répertoire que le fichier .tex principal ou dans l'un des sous-dossiers, ou il peut être ***absolu*** si l'on doit préciser exactement le chemin. Par exemple : ```latex %Chemin absolu au format Windows : \graphicspath{ {c:/user/images/} } %Chemin absolu au format Unix (Linux, OsX) \graphicspath{ {/home/user/images/} } ``` Notez que cette commande requiert une barre oblique finale `/` à la fin et que le chemin doit être placé entre deux paires d'accolades. Il est aussi possible de définir plusieurs chemins si vous avez enregistré les images dans plus d'un dossier pour mieux organiser. Par exemple, s'il y a deux dossiers, l'un appelé *images1* et l'autre *images2*, utilisez la commande ```latex \graphicspath{ {images1/}{images2/} } ``` Si aucun chemin n'est spécifié, LaTeX recherchera les images dans le dossier courant, où se trouve le fichier .tex. [Ouvrir l'exemple dans Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Modifier la taille et faire pivoter une image Si l'on souhaite spécifier des paramètres supplémentaires lors de l'importation d'une image dans LaTeX pour modifier la largeur, la hauteur, la position, etc. de l'image, c'est possible au moyen de la syntaxe suivante : ```latex Overleaf est un excellent outil professionnel pour éditer en ligne, partager et sauvegarder vos projets \LaTeX. Il offre aussi une documentation d'aide assez complète. \includegraphics[scale=1.5]{lion-logo} ``` ![InsertingImagesEx2.png](/files/92a42d04604e34c54da38bd091200ecc14a5e92c) La commande `\includegraphics[scale=1.5]{lion-logo}` inclut l'image *lion-logo* dans le document, le paramètre supplémentaire `scale=1.5` met l'image à l'échelle de 1,5 fois sa taille originale. Il est aussi possible de redimensionner l'image à une hauteur et une largeur déterminées. ```latex Overleaf est un excellent outil professionnel pour éditer en ligne, partager et sauvegarder vos projets \LaTeX. Il offre aussi une documentation d'aide assez complète. \includegraphics[width=3cm, height=4cm]{lion-logo} ``` ![InsertingImagesEx3.png](/files/b88daf6e242620d48cd990d6c59e76f5ae381d05) Comme vous l'avez probablement déjà deviné, les paramètres entre crochets `[width=3cm, height=4cm]` définissent la largeur et la hauteur de l'image. Différentes unités [de mesure peuvent être utilisées dans ces paramètres. Si seule la valeur de](#gua-de-referencia) , la hauteur sera mise à l'échelle proportionnellement pour conserver le rapport d'aspect de l'image. *width*, la hauteur sera mise à l'échelle proportionnellement pour conserver le rapport d'aspect de l'image. Il est aussi possible de définir la taille de l'image par rapport à d'autres éléments du document. Par exemple, si vous voulez que l'image ait la même largeur que le texte : ```latex Overleaf est un excellent outil professionnel pour éditer en ligne, partager et sauvegarder vos projets \LaTeX. Il offre aussi une documentation d'aide assez complète. \includegraphics[width=\textwidth]{universe} ``` ![InsertingImagesEx5.png](/files/799439818f48c515b81200339f91b83c0f02499b) Au lieu de `\textwidth` vous pouvez utiliser n'importe laquelle des autres unités que LaTeX inclut par défaut : *\columnsep, \linewidth, \textheight, \paperheight, etc*. Consultez la [guide de référence](#gua-de-referencia) pour une meilleure description des unités. Il existe une autre option très courante lorsqu'on inclut des images dans un document : pouvoir les faire pivoter. C'est très facile dans LaTeX : ```latex Overleaf est un excellent outil professionnel pour éditer en ligne, partager et sauvegarder vos projets \LaTeX. Il offre aussi une documentation d'aide assez complète. \includegraphics[scale=1.2, angle=45]{lion-logo} ``` ![InsertingImagesEx4.png](/files/9a604aa2c2ea4454828d7b94db0d8038b0ed853d) Le paramètre `angle=45` fait pivoter l'image de 45 degrés dans le sens inverse des aiguilles d'une montre. Pour faire pivoter l'image dans le sens des aiguilles d'une montre, utilisez un nombre négatif. [Ouvrir un exemple dans Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Positionner l'image Dans la section précédente, on a expliqué comment insérer une image dans votre document, mais parfois la combinaison d'images et de texte dans votre document peut ne pas donner le résultat attendu. Pour changer cela, il faut utiliser un nouvel environnement : ```latex Dans l'exemple suivant, la figure sera positionnée juste sous cette phrase. \begin{figure}[h] \includegraphics[width=8cm]{Plot} \end{figure} ``` ![InsertingImagesEx6.png](/files/be1eb7f7630242312d97bddf0b1b798d196782ce) L'environnement `figure` sert à afficher les images comme éléments flottants dans le document. Cela signifie qu'il suffit d'inclure votre image dans l'environnement *figure* et vous n'avez plus à vous soucier de l'endroit où elle apparaîtra, LaTeX la positionnera de manière à ce qu'elle s'intègre parfaitement au flux du document. Bien que, en principe, cela semble très bien, parfois on veut avoir plus de contrôle sur l'endroit où les images apparaîtront. Un paramètre supplémentaire peut être utilisé pour définir le positionnement de la figure. Dans l'exemple, `begin{figure}[h]`, le paramètre entre crochets définit la position de la figure *ici* (ici, en anglais). Ci-dessous, un tableau présentant une liste de valeurs de position possibles. | Paramètre | Position | | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | h | Définit la position de l'élément flottant « ici ». C'est-à-dire à peu près au même endroit que celui où il apparaît dans le code (cependant, le positionnement n'est pas toujours exact) | | t | Insère la figure en haut de la page. | | b | Insère la figure en bas de la page. | | p | Insère les éléments flottants sur une page séparée, qui ne contient que des figures. | | ! | Outrepasse les paramètres que LaTeX utilise pour déterminer une position « bonne » pour l'image. | | H | Définit l'élément flottant précisément à l'endroit même où il apparaît dans le code ; il faut importer le paquet `float`. C'est dans une certaine mesure équivalent à h!. | Dans l'exemple suivant, on peut voir une image qui apparaît au début du document, bien que le code qui la produit se trouve à la fin du document. ```latex Dans cette image, vous pouvez voir un graphique à barres qui montre les résultats d'une enquête qui a impliqué certaines données importantes étudiées au fil du temps. \begin{figure}[t] \includegraphics[width=8cm]{Plot} \centering \end{figure} ``` ![InsertingImagesEx7.png](/files/9a9aa9ddf1444648d58efd865c8ec1be70f333a4) La commande supplémentaire `\centering` sert à centrer l'image. La valeur d'alignement par défaut est à gauche. Il est aussi possible d'enrouler le texte autour de la figure. Lorsque le document contient de petites images, cela améliore l'apparence du texte. ```latex \begin{wrapfigure}{r}{0.25\textwidth} %this figure will be at the right \centering \includegraphics[width=0.25\textwidth]{mesh} \end{wrapfigure} Il existe plusieurs façons de tracer une fonction de deux variables, selon les informations qui vous intéressent. Par exemple, si vous voulez voir le maillage d'une fonction afin qu'il soit plus facile de voir la dérivée, vous pouvez utiliser un graphique comme celui de gauche. \begin{wrapfigure}{l}{0.25\textwidth} \centering \includegraphics[width=0.25\textwidth]{contour} \end{wrapfigure} D'un autre côté, si vous ne vous intéressez qu'à certaines valeurs, vous pouvez utiliser un tracé de contour, vous pouvez utiliser le tracé de contour, vous pouvez utiliser le contour plot, vous pouvez utiliser le tracé de contour, vous pouvez utiliser le tracé de contour, vous pouvez utiliser le tracé de contour, vous pouvez utiliser le tracé de contour, comme celui de gauche. D'un autre côté, si vous ne vous intéressez qu'à certaines valeurs, vous pouvez utiliser un tracé de contour, vous pouvez utiliser le tracé de contour, vous pouvez utiliser le contour plot, vous pouvez utiliser le tracé de contour, vous pouvez utiliser le tracé de contour, vous pouvez utiliser le tracé de contour, vous pouvez utiliser le tracé de contour, comme celui de gauche. ``` ![InsertingImagesEx8.png](/files/57101a29deb1367d51f2675cc8aee739192d1204) Pour que les commandes de l'exemple fonctionnent, il faut importer le paquet **wrapfig**. Ajoutez au préambule la ligne ```latex \usepackage{wrapfig} ``` Une fois le paquet importé, on peut utiliser l'environnement *wrapfigure* au moyen de la commande `\begin{wrapfigure}{l}{0.25\textwidth} \end{wrapfigure}`. Notez que l'environnement comporte deux paramètres supplémentaires entre accolades. Ci-dessous, le code est expliqué plus en détail. **{l}** Définit l'alignement de la figure. Utilisez l pour gauche et r pour droite. De plus, si la classe book ou une classe similaire est utilisée, au lieu de l et r on peut utiliser o pour le bord extérieur et i pour le bord intérieur de la page. **{0.25\textwidth}** Cela définit la largeur de la boîte qui contient l'image. Ce n'est pas la largeur de l'image elle-même ; celle-ci doit être définie dans la commande includegraphics. Dans l'exemple, des unités relatives sont utilisées, mais des unités normales (cm, mm, in, etc.) peuvent être utilisées. Consultez le guide de référence pour voir une liste des unités possibles. **\centering** Comme expliqué précédemment, mais dans l'exemple ci-dessus l'image sera centrée par rapport à la boîte qui la contient, au lieu de l'être par rapport à la page. Pour des informations plus complètes sur le positionnement des images, consultez l'article [Positionnement des images et des tableaux](/latex/fr/figures-et-tableaux/02-positioning-images-and-tables.md) [Ouvrir l'exemple dans Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Ajouter des étiquettes, des légendes et des références Le fait d'ajouter des légendes avec une brève description de l'image et des étiquettes qui pourront ensuite servir à faire référence à l'image est très utile lorsqu'on travaille sur des documents très longs. ### Légendes Commençons par un exemple d'ajout d'une légende : ```latex \begin{figure}[h] \caption{Exemple d'un tracé paramétrique ($\sin (x), \cos(x), x$)} \centering \includegraphics[width=0.5\textwidth]{spiral} \end{figure} ``` ![InsertingImagesEx9.png](/files/5e1eb01226106a361f5c11c29c317aec619d49cd) C'est très facile, il suffit d'ajouter la commande `\caption{Une légende}` et d'écrire à l'intérieur des accolades le texte à afficher. L'endroit où la légende sera imprimée dépend de l'endroit où la commande est insérée ; si elle est au-dessus de la commande *includegraphics* alors la légende apparaîtra au-dessus de l'image ; si elle se trouve en dessous de cette commande, alors la légende apparaîtra en bas de la figure. Les légendes peuvent aussi être positionnées à côté des figures. Le paquet **sidecap** permet d'utiliser un code très similaire à celui de l'exemple précédent pour ajouter le texte. ```latex \documentclass{article} \usepackage[rightcaption]{sidecap} \usepackage{graphicx} % paquet pour gérer les images \graphicspath{ {images/} } \begin{SCfigure}[0.5][h] \caption{Exemple d'un tracé paramétrique. Cette légende sera à droite} \includegraphics[width=0.6\textwidth]{spiral} \end{SCfigure} ``` ![InsertingImagesEx10.png](/files/1d306b8a2b84c1b57bea0f2b25e6c381ca085a02) Il y a deux nouvelles commandes dans cet exemple : **\usepackage\[rightcaption]{sidecap}** Comme vous le savez probablement déjà, cette commande importe le paquet appelé sidecap, mais il y a un paramètre supplémentaire : rightcaption. Ce paramètre est celui qui définit l'endroit où la légende est imprimée. Dans ce cas, à droite de l'image ; il est aussi possible d'utiliser leftcaption pour déplacer la légende à gauche. Dans les documents qui utilisent des classes de type livre, on peut en outre utiliser les options outercaption et innercaption pour imprimer la légende à l'extérieur ou à l'intérieur par rapport au bord de la page. **\begin{SCfigure}\[0.5]\[h] \end{SCfigure}** Définit un environnement similaire à figure. Le premier paramètre est la largeur de la légende par rapport à la taille de l'image. Le second paramètre h a la même fonction que dans l'environnement figure. Consultez la section sur le positionnement des images pour plus d'informations. Il est possible d'obtenir une gestion plus avancée du format des légendes si on le souhaite. Consultez les [lectures complémentaires](#lecturas-adicionales) pour voir plus de références. ### Étiquettes et références croisées Les figures, comme de nombreux autres éléments dans un document LaTeX (équations, tableaux, graphiques, etc.), peuvent être référencées depuis le texte. C'est très facile : il suffit d'ajouter une étiquette à l'environnement *figure* ou *SCfigure*, puis utiliser cette étiquette pour faire référence à la figure. ```latex \begin{figure}[h] \centering \includegraphics[width=0.25\textwidth]{mesh} \caption{une jolie courbe} \label{fig:mesh1} \end{figure} Comme vous pouvez le voir dans la figure \ref{fig:mesh1}, la fonction croît près de 0. Aussi, sur la page \pageref{fig:mesh1} se trouve le même exemple. ``` ![InsertingImagesEx11.png](/files/cc1b00c9c154632480f20c5baf80b13071b535ab) Il y a trois commandes dans cet exemple qui génèrent des références croisées. **\label{fig:mesh1}** Définit l'étiquette de la figure. Comme les étiquettes peuvent être utilisées pour divers types d'éléments du document, il est recommandé d'utiliser un préfixe, tel que fig: dans l'exemple. **\ref{fig:mesh1}** Cette commande imprime le numéro attribué à la figure. Les numéros sont générés automatiquement et sont mis à jour si une figure est ensuite insérée avant celle qui est référencée. **\pageref{fig:mesh1}** Imprime le numéro de page où apparaît l'image référencée par l'étiquette. La commande `\caption` qui ajoute une légende est obligatoire pour pouvoir ajouter une étiquette et faire référence à la figure. Une autre caractéristique importante de LaTeX est la possibilité de générer automatiquement une *liste des figures*. Cela se fait facilement avec : ```latex \listoffigures ``` ![InsertingImagesEx12.png](/files/65f12fec8ac938e6cb572a44d69847f72aae626a) Cette commande ne fonctionne qu'avec les figures qui ont une légende, puisqu'elle l'utilise pour générer la table. L'exemple précédent liste les images utilisées dans le présent article. Note importante : *Lorsque l'on utilise des références croisées en LaTeX, le projet doit être compilé deux fois ; sinon les références, les références de pages et la table des figures ne fonctionneront pas*. [Ouvrir un exemple dans Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Génération d'images en haute et basse résolution Pour l'instant, lorsque nous introduisons le nom du fichier image dans la commande *\includegraphics* nous omettons l'extension du fichier. Cependant, ce n'est pas nécessaire, même si cela peut être très utile. Si l'extension est omise, LaTeX cherchera tout type d'image pris en charge dans le répertoire d'images prédéfini ; la recherche sera faite dans un certain ordre, lequel peut être modifié. Cela est très utile pour passer de la version brouillon de votre document à la version finale. Dans le brouillon (pendant que vous rédigez votre article, livre, rapport, etc.), il est souhaitable de pouvoir utiliser des images en basse résolution (généralement au format .png) afin que le document se compile plus rapidement. Dans la version finale, en revanche, on préfère inclure les images en haute résolution, afin d'avoir un document de qualité. Cela peut être réalisé de la façon suivante : * Ne pas spécifier l'extension du fichier dans la commande *\includegraphics*, et * Spécifier l'ordre des extensions dans le préambule Ainsi, si l'on a deux versions de la même image, par exemple venndiagram.pdf (en haute résolution) et venndiagram.png (en basse résolution). On peut inclure la ligne suivante dans le préambule pendant la rédaction et le débogage du document - ```latex \DeclareGraphicsExtensions{.png,.pdf} ``` La commande précédente s'assure que si deux images portant le même nom mais avec des extensions différentes sont trouvées, le fichier .png sera utilisé, et si pour une raison quelconque ce fichier disparaît, la version pdf sera l'option suivante. Une fois le document rédigé, pour n'utiliser que la version en haute résolution il faut changer la ligne qui détermine l'extension en : ```latex \DeclareGraphicsExtensions{.pdf,.png} ``` On peut même améliorer la technique décrite ci-dessus : on peut demander à LaTeX de générer des images .png en basse résolution pendant la compilation du document si le PDF n'a pas été converti en PNG auparavant. Pour cela, il faut inclure ce qui suit dans le préambule après `\usepackage{graphicx}`. ```latex \usepackage{epstopdf} \epstopdfDeclareGraphicsRule{.pdf}{png}{.png}{convert #1 \OutputFile} \DeclareGraphicsExtensions{.png,.pdf} ``` Si venndiagram2.pdf existe mais pas venndiagram2.png, le fichier vendiagramm2-pdf-converted-to.png sera créé et chargé à sa place. La commande *convert #1* est responsable de la conversion Il y a quelques points à garder à l'esprit si l'on choisit cette méthode : * Pour que la conversion automatique fonctionne, il faut exécuter *pdflatex* avec l'option `--shell-escape`. * Pour la version finale, il ne faut pas oublier de commenter la ligne `\epstopdfDeclareGraphicsRule`, afin que seules les images en haute résolution soient chargées. Il faut aussi se souvenir de changer l'ordre de priorité. [Ouvrir l'exemple dans Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Guide de référence **Unités et mesures dans LaTeX** | Abréviation | Définition | | ------------ | --------------------------------------------------------------- | | pt | Un point, est l'unité de longueur par défaut. Environ 0,3515 mm | | mm | un millimètre | | cm | un centimètre | | dans | un pouce | | ex | la hauteur d'une **x** avec la police actuelle | | em | la largeur d'une **m** avec la police actuelle | | \columnsep | distance entre les colonnes | | \columnwidth | largeur d'une colonne | | \linewidth | largeur de ligne dans l'environnement actuel | | \paperwidth | largeur du papier | | \paperheight | hauteur du papier | | \textwidth | largeur du texte | | \textheight | hauteur du texte | | \unitlength | unités de longueur dans l'environnement *picture* | **À propos des types d'images pouvant être utilisés dans LaTeX** **latex** Si le document est compilé avec la commande latex, seules des images au format EPS peuvent être utilisées, lequel est un format vectoriel. **pdflatex** Si le document est compilé avec la commande pdflatex pour produire un PDF, alors plusieurs types d'images peuvent être utilisés- ``` JPG : la meilleure option pour insérer des photographies PNG : la meilleure option pour insérer des diagrammes (si, pour une raison quelconque, vous ne pouvez pas utiliser un graphique vectoriel) et des captures d'écran PDF : malgré l'habitude d'utiliser PDF pour les documents, en général un PDF peut ne contenir qu'une seule image qui peut ensuite être importée. EPS : les images EPS peuvent être incluses à l'aide du paquet epstopdf (le paquet doit seulement être installé sur la machine ; une fois installé, aucune commande supplémentaire n'est nécessaire dans le fichier .tex) ``` **Graphiques vectoriels ou images matricielles ?** Les images peuvent être incluses soit au format matriciel soit au format graphique vectoriel. En général, il ne faut pas s'en préoccuper, mais si l'on a le choix du format, il faut garder à l'esprit que pour un graphique vectoriel le mieux est de l'enregistrer au format PDF ou EPS, tandis que pour une image matricielle les formats JPG ou PNG sont recommandés. Cela parce qu'une image matricielle dans un fichier au format PDF ou EPS requiert beaucoup d'espace de stockage. [Ouvrir l'exemple dans Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Lectures supplémentaires Pour plus d’informations, consulter : * [Positionnement des images et des tableaux](/latex/fr/figures-et-tableaux/02-positioning-images-and-tables.md) * [Listes des tableaux et des figures](/latex/fr/figures-et-tableaux/03-lists-of-tables-and-figures.md) * [Documents recto et verso](/latex/fr/mise-en-forme/08-single-sided-and-double-sided-documents.md) * [Longueurs en LaTeX](/latex/fr/mise-en-forme/01-lengths-in-latex.md) * [**floatrow** paquet pour la gestion avancée des légendes des éléments flottants (tableaux et figures)](http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf) * [**sidecap** documentation du paquet, pour les légendes de figures latérales](ftp://ctan.tug.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf) * [**epstopdf** documentation du paquet (conversion PDF vers EPS)](https://www.google.com/url?sa=t\&rct=j\&q=\&esrc=s\&source=web\&cd=3\&cad=rja\&ved=0CEEQFjAC\&url=http%3A%2F%2Fmirror.hmc.edu%2Fctan%2Fmacros%2Flatex%2Fcontrib%2Foberdiek%2Fepstopdf.pdf\&ei=N4v2UpK7D4eHqQHz2IDACg\&usg=AFQjCNG9CxIXjrbc22kl-8QweEXeEauFew\&sig2=qamKo3qpid8CEqzsHhpIrQ\&bvm=bv.60983673,d.aWM) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/fr/autres-sujets/28-inserting-images-es.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.