Une page de PDF comme graphique
includegraphics avec sélection de page, et pdfpages pour les annexes.
Une page de PDF comme graphique
Le PDF est le meilleur format de figure que LaTeX sache utiliser. Contrairement au PNG ou au JPG, un PDF stocke des données vectorielles, de sorte que les traits et les étiquettes restent nets à n’importe quel niveau de zoom et que les polices qu’il contient voyagent avec le fichier. Des outils comme Matplotlib, Inkscape et draw.io exportent tous en PDF, ce qui signifie que le schéma que vous avez dessiné ailleurs peut s’insérer directement dans votre document. Mais les PDF apportent une particularité que les images n’ont pas : un PDF peut contenir plusieurs pages, et vous devez dire à LaTeX laquelle vous voulez.
Extraire une page d’un PDF de plusieurs pages
La commande \includegraphics du paquet graphicx accepte une option page en plus des clés de dimensionnement habituelles :
\includegraphics[page=1,width=\textwidth]{diagram.pdf}Ici, page=1 sélectionne la première page de diagram.pdf, et width=\textwidth met cette page à l’échelle de la pleine largeur du bloc de texte. Si vous omettez page, LaTeX utilise silencieusement la page un, ce qui est généralement ce que vous voulez mais peut vous surprendre quand un script de tracé écrit plusieurs figures dans un même fichier. Vous pouvez inclure le même PDF plusieurs fois avec des valeurs de page différentes, une fois par environnement figure, chacune avec sa propre légende et sa propre étiquette.
Enveloppez la commande dans un environnement figure normal pour qu’elle reçoive une légende et un numéro, exactement comme pour n’importe quelle autre image. La page incluse est rognée à sa propre boîte englobante : si votre PDF source a de généreuses marges, la figure paraîtra entourée de blanc. Réexportez avec une boîte englobante serrée, ou rognez-la une fois avec un outil comme pdfcrop, plutôt que de lutter contre les blancs avec des espacements négatifs.
Insérer des documents entiers avec pdfpages
Parfois, vous ne voulez pas du tout une figure. Vous voulez des pages entières, telles quelles, déposées dans votre document : un PDF supplémentaire, un formulaire signé, un questionnaire publié dans l’annexe d’une thèse. C’est le rôle du paquet pdfpages :
\usepackage{pdfpages}\includepdf[pages=-]{supplement.pdf}La valeur pages=- signifie toutes les pages. Vous pouvez aussi écrire pages=2-5 pour une plage ou pages={1,3,7} pour une liste précise. Chaque page insérée occupe sa propre page de sortie, garde sa mise en page d’origine et entre dans la numérotation de votre document, de sorte que l’annexe se lit de façon continue. Ajoutez l’option pagecommand={} si les en-têtes ou les pieds de page de votre classe de document s’impriment par-dessus les pages insérées et que vous voulez les supprimer ou les personnaliser.
Quel outil pour quelle tâche
Utilisez \includegraphics[page=...] quand le contenu du PDF doit se comporter comme une figure, c’est-à-dire flotter, porter une légende et être référencé depuis le texte. Utilisez \includepdf quand les pages doivent exister seules, en pleine taille. L’erreur courante est d’utiliser pdfpages pour un schéma, ce qui vous donne une page entière sans légende ni référence, que vous ne pouvez pas citer avec \ref. Si des lecteurs doivent un jour lire « voir la Figure 3 », le contenu doit se trouver dans un environnement figure.