> 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/structure-du-document/09-hyperlinks.md). # Hyperliens LaTeX est un excellent outil pour des documents imprimables au rendu professionnel, mais il peut aussi être utilisé pour générer des fichiers PDF avec d'excellents outils de navigation. Cet article décrit comment créer des hyperliens dans votre document et comment configurer des documents LaTeX pour être consultés avec un lecteur PDF. ## Introduction Commençons par un exemple minimal fonctionnel, en important simplement le **hyperref** package tous [les éléments faisant l’objet de références croisées](/latex/fr/structure-du-document/03-cross-referencing-sections-equations-and-floats.md) deviennent des hyperliens. ```latex \documentclass{book} \usepackage{blindtext} \usepackage{hyperref} \title{Example of Hyperlinks} \author{Overleaf} \begin{document} \frontmatter \tableofcontents \clearpage \addcontentsline{toc}{chapter}{Avant-propos} {\huge {\bf Avant-propos}} \Blindtext \clearpage \addcontentsline{toc}{chapter}{Entrée factice} {\huge {\bf Entrée factice}} \Blindtext \mainmatter \chapter{Premier chapitre} Ce sera un chapitre vide \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} L'équation \ref{eq:1} montre une somme divergente. Cette formule sera utilisée plus tard à la page \pageref{second}. \Blindtext \clearpage \section{Deuxième section} \label{second} \blindtext \Blinddocument \end{document} ``` [Ouvrez cet `hyperref` exemple dans Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+hyperref+example\&snip=%5Cdocumentclass%7Bbook%7D%0A%5Cusepackage%7Bblindtext%7D%0A%5Cusepackage%7Bhyperref%7D%0A%0A%5Ctitle%7BExample+of+Hyperlinks%7D%0A%5Cauthor%7BOverleaf%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cfrontmatter%0A%5Ctableofcontents%0A%5Cclearpage%0A%0A%5Caddcontentsline%7Btoc%7D%7Bchapter%7D%7BForeword%7D%0A%7B%5Chuge+%7B%5Cbf+Foreword%7D%7D%0A%0A%5CBlindtext%0A%5Cclearpage%0A%0A%5Caddcontentsline%7Btoc%7D%7Bchapter%7D%7BDummy+entry%7D%0A%7B%5Chuge+%7B%5Cbf+Dummy+entry%7D%7D%0A%0A%5CBlindtext%0A%5Cmainmatter%0A%0A%5Cchapter%7BFirst+Chapter%7D%0A%0AThis+will+be+an+empty+chapter%0A%0A%5Cbegin%7Bequation%7D%0A%5Clabel%7Beq%3A1%7D%0A%5Csum_%7Bi%3D0%7D%5E%7B%5Cinfty%7D+a_i+x%5Ei%0A%5Cend%7Bequation%7D%0A%0AThe+equation+%5Cref%7Beq%3A1%7D+shows+a+sum+that+is+divergent.+This+formula+will+be+used+later+on+page+%5Cpageref%7Bsecond%7D.%0A%0A%5CBlindtext%0A%5Cclearpage%0A%0A%5Csection%7BSecond+section%7D+%5Clabel%7Bsecond%7D%0A%0A%5Cblindtext%0A%5CBlinddocument%0A%5Cend%7Bdocument%7D) ![Exemple de document hyperref](/files/6c6fdd5aa2d59f7c3c6ccf38dbea3bf50db51569) Les lignes de la table des matières deviennent des liens vers les pages correspondantes du document en ajoutant simplement dans le préambule du document la ligne ```latex \usepackage{hyperref} ``` Il faut faire attention lors de l'importation de `hyperref`: en général, il doit s'agir du dernier paquet à importer — mais il peut exister quelques exceptions à cette règle. ## Styles et couleurs La mise en forme par défaut des liens peut être modifiée afin que les informations de vos documents soient présentées plus clairement. Ci-dessous, vous pouvez voir un exemple : ```latex \documentclass{book} \usepackage{hyperref} \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Exemple Overleaf}, pdfpagemode=FullScreen, } \urlstyle{same} \begin{document} \tableofcontents \chapter{Premier chapitre} Ce sera un chapitre vide et j'y placerai du texte ici \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} L'équation \ref{eq:1} montre une somme divergente. Cette formule sera utilisée plus tard à la page \pageref{second}. Pour d'autres références, voir \href{http://www.overleaf.com}{Quelque chose cliquable} ou allez à l'URL suivante : \url{http://www.overleaf.com} ou ouvrez le fichier suivant \href{run:./file.txt}{File.txt} Il est aussi possible de lier directement n'importe quel mot ou \hyperlink{thesentence}{n'importe quelle phrase} dans votre document. \end{document} ``` [Ouvrez un exemple du `hyperref` package dans Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Another+hyperref+example\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ![HyperrefEx2OverleafVa.png](/files/6aa96ca4b1b907c1baa780402e221e5efb50b795) ![HyperrefEx2OverleafVb.png](/files/61db01cf110f7a0b1dcae21ad37e303512110a8a) Voici un exemple complet, il sera entièrement expliqué dans le reste de l'article. Ci-dessous se trouve une description des commandes liées à la couleur et au style des liens. **\hypersetup{ ... }** Cela définit les options pour configurer le comportement des liens dans le document. Chaque paramètre doit être séparé par des virgules et la syntaxe doit être au format paramètre=valeur. **colorlinks=true** Les liens seront colorés, la couleur par défaut est le rouge. **linkcolor=blue** Les liens internes, ceux générés par les éléments faisant l'objet de références croisées, sont affichés en bleu. **filecolor=magenta** Les liens vers des fichiers locaux seront affichés en magenta (voir lier des fichiers locaux). **urlcolor=cyan** Les liens vers des sites web sont définis en cyan (voir lier des adresses web). **urlstyle{same}** Les réglages par défaut affichent les liens dans une police à chasse fixe, cette commande modifie cela et affiche les liens dans le même style que le reste du texte. ## Lier des adresses web Les liens vers une adresse web ou un e-mail peuvent être ajoutés à un fichier LaTeX en utilisant la `\url` commande pour afficher le lien réel ou `\href` pour utiliser un lien caché et afficher à la place un mot/une phrase. ```latex Pour d'autres références, voir \href{http://www.overleaf.com}{Quelque chose cliquable} ou allez à l'URL suivante : \url{http://www.overleaf.com} ``` ![HyperlinkExampleUpdatedMore.png](/files/5608061f7eaf5ac5c966f0fbc3b0b1b5b04a8d3b) Il y a deux commandes dans l'exemple qui génèrent un lien dans le document final : **\href{ chose cliquable}** Deux paramètres sont passés à cette commande, le premier est l'URL du lien, dans ce cas, et le second est le texte cliquable à afficher, Quelque chose cliquable. **\url{** Cette commande affichera l'URL passée en paramètre et en fera un lien, utile si vous allez imprimer le document. [Ouvrir un exemple du package hyperref dans Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Lier des fichiers locaux Les commandes `\href` et `\url` présentées dans la section précédente peuvent être utilisées pour ouvrir des fichiers locaux ```latex Pour d'autres références, voir \href{http://www.overleaf.com}{Quelque chose cliquable} ou allez à l'URL suivante : \url{http://www.overleaf.com} ou ouvrez le prochain fichier \href{run:./file.txt}{File.txt} ``` ![HyperlinkExampleUpdatedMoreNext.png](/files/6a0f7bb614854a54de89ff1c8e5f3683326db4d3) La commande `\href{run:./file.txt}{File.txt}` affiche le texte `File.txt` qui renvoie vers un fichier local appelé `file.txt` situé dans le répertoire de travail actuel. Remarquez le texte `run:` avant le chemin d'accès au fichier. Le chemin du fichier suit les conventions des systèmes UNIX, en utilisant `.` pour faire référence au répertoire courant et `..` pour le répertoire précédent. La commande `\url{}` peut aussi être utilisée, avec la même syntaxe décrite pour le chemin, mais il est signalé qu'elle présente certains problèmes. [Ouvrir un exemple du package hyperref dans Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Insertion manuelle de liens Il a été mentionné précédemment que tous les éléments faisant l'objet de références croisées deviennent des liens une fois **hyperref** est importé, ainsi nous pouvons utiliser `\label` n'importe où dans le document et faire référence plus tard à ces étiquettes pour créer des liens. Ce n'est pas la seule manière d'insérer des hyperliens manuellement. ```latex Il est aussi possible de lier directement n'importe quel mot ou \hyperlink{thesentence}{n'importe quelle phrase} dans votre document. Si vous lisez ce texte, vous n'obtiendrez aucune information. Vraiment ? N'y a-t-il vraiment aucune information ? Par exemple \hypertarget{thesentence}{cette phrase}. ``` ![HyperlinkExampleUpdatedMoreNextAgain.png](/files/a68d5f2a8215ae87364ac643702a6d11e7d5884b) Il y a deux commandes pour créer des liens définis par l'utilisateur. **\hypertarget{thesentence}{cette phrase}** Le premier paramètre passé entre accolades à cette commande est un identifiant unique pour cette phrase. Le deuxième paramètre est le texte "cette phrase", et il sera imprimé normalement (selon la valeur de anchorcolor, voir le guide de référence), mais lorsqu'un lien pointant vers l'identifiant "thesentence" est cliqué, le fichier PDF se déplacera jusqu'à ce point. **\hyperlink{thesentence}{n'importe quelle phrase}** Cette commande affiche le texte "n'importe quelle phrase" comme un élément cliquable qui redirige vers le point dont l'identifiant est "thesentence". [Ouvrir un exemple du package hyperref dans Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=\&mainFile=main.tex) ## Options spécifiques au PDF Les liens dans un document sont créés en pensant à un document qui sera lu au format PDF. Le fichier PDF peut être personnalisé davantage afin d'ajouter des informations supplémentaires et de modifier la façon dont le lecteur PDF l'affiche. Ci-dessous un exemple : ```latex \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Exemple Overleaf}, pdfpagemode=FullScreen, } ``` ![Pdftitle.png](/files/52ddc6c70dd2c0541209f260a6714294948c597e) En utilisant la commande `\hypersetup`, décrite dans la section [styles et couleurs](#styles-and-colours), accepte des paramètres supplémentaires pour configurer le fichier PDF final. **pdftitle={Exemple Overleaf}** est le titre du fichier PDF de sortie, à afficher dans la barre de titre de la fenêtre. Dans l'exemple, il s'agit de « Overleaf Example ». **pdfpagemode=FullScreen** Le document sera ouvert en mode plein écran par le lecteur PDF. Voir le [guide de référence](#reference-guide) pour une liste complète des options qui peuvent être passées à `\hypersetup`. [Ouvrir un exemple du package hyperref dans Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Guide de référence **Options de style des liens** | Option | Valeur par défaut | Description | | ------------- | ----------------- | -------------------------------------------------------------------------------------------- | | `hyperindex` | true | Transforme les numéros de page des entrées d'index en hyperliens | | `linktocpage` | false | Transforme les numéros de page plutôt que le texte en lien dans la table des matières. | | `breaklinks` | false | Permet de couper les liens sur plusieurs lignes. | | `colorlinks` | false | Colore le texte des liens et des ancres ; ces couleurs apparaîtront dans la version imprimée | | `linkcolor` | red | Couleur des liens internes normaux | | `anchorcolor` | black | Couleur du texte de l'ancre (cible) | | `citecolor` | green | Couleur des citations bibliographiques | | `filecolor` | cyan | Couleur des liens qui ouvrent des fichiers locaux | | `urlcolor` | magenta | Couleur des URL liées | | `frenchlinks` | false | Utilise des petites capitales au lieu de couleurs pour les liens | **Options spécifiques au PDF** | Option | Valeur par défaut | Description | | ----------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------- | | `bookmarks` | true | Les signets Acrobat sont écrits, comme la table des matières. | | `bookmarksopen` | false | Les signets sont affichés avec tous les sous-arbres développés. | | `citebordercolor` | 0 1 0 | Couleur de la boîte autour des citations au format RVB. | | `filebordercolor` | 0 .5 .5 | Couleur de la boîte autour des liens vers des fichiers au format RVB. | | `linkbordercolor` | 1 0 0 | Couleur de la boîte autour des liens normaux au format RVB. | | `menubordercolor` | 1 0 0 | Couleur de la boîte autour des liens de menu au format RVB. | | `urlbordercolor` | 0 1 1 | Couleur de la boîte autour des liens vers des URL au format RVB. | | `pdfpagemode` | vide | Détermine comment le fichier est ouvert. Les possibilités sont UseThumbs (miniatures), UseOutlines (signets) et FullScreen. | | `pdftitle` | | Définit le titre du document. | | `pdfauthor` | | Définit l'auteur du document. | | `pdfstartpage` | 1 | Détermine à quelle page le fichier PDF s'ouvre. | ## Lectures complémentaires Pour plus d'informations, voir * [Table des matières](/latex/fr/structure-du-document/02-table-of-contents.md) * [Sections et chapitres](/latex/fr/structure-du-document/01-sections-and-chapters.md) * [Référencement croisé des sections et des équations](/latex/fr/structure-du-document/03-cross-referencing-sections-equations-and-floats.md) * [Utiliser les couleurs dans LaTeX](/latex/fr/mise-en-forme/13-using-colors-in-latex.md) * [Gestion dans un grand projet](/latex/fr/structure-du-document/07-management-in-a-large-project.md) * [Manuel hyperref](http://repositorios.cpai.unb.br/ctan/macros/latex/contrib/hyperref/doc/manual.pdf) * [Article sur les hyperliens sur Wikibooks](http://en.wikibooks.org/wiki/LaTeX/Hyperlinks) --- # 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/structure-du-document/09-hyperlinks.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.