====== Comment obtenir des références croisées à partir de plusieurs sources? ======

Lors de la production d'un ensemble de documents interdépendants, vous souhaiterez probablement faire des références croisées //entre// ces documents ; mais, par défaut, <latex>\LaTeX</latex> ne le permet pas.

===== Avec l'extension “xr” =====

L'extension [[ctanpkg>xr]] permet de répondre à ce besoin. Essayez de compiler les fichiers ''volume1.tex'' et ''volume2.tex'' qui servent d'exemple.

<file latex volume1.tex>
\documentclass{article}

\begin{document}
\section{Ma section.\label{masect}}
\end{document}  
</file>


<file latex volume2.tex>
\documentclass{article}
\usepackage{xr}
\externaldocument{volume1}

\begin{document}
Pour plus de détails, voir le document \textit{essai}, paragraphe~\ref{masect}.
\end{document}  
</file>

Dans le détail, la ligne suivante va charger toutes les références du ''volume1'' dans votre document actuel :

<code latex>
\externaldocument{volume1}
</code>

Cet exemple présuppose que ''volume1.tex'' et ''volume2.tex'' sont dans le même répertoire. 
Si ce n'est pas le cas, il faut spécifier le chemin relatif ou absolu de ''volume1.tex'' :

<code latex>
\externaldocument{../Volume-1/volume1}
</code>

:!: Il ne faut pas indiquer l'extension ''.tex'' dans l'argument de la commande ''\externaldocument'', car ''xr'' utilise cet argument pour construire le nom du fichier ''.aux'' auquel il va se référer. Si vous écrivez ''\externaldocument{volume1.tex}'', vous obtiendrez l'erreur suivante :

<code>
Package xr Warning:
No file volume1.tex.aux
LABELS NOT IMPORTED
</code>

:!: Parce que ''xr'' utilise le fichier ''.aux'' du document extérieur, ''volume1.tex'' doit être compilé avant ''volume2.tex''.

==== Le cas des étiquettes ayant le même nom dans deux documents ====

L'extension fournit un moyen de transformer toutes les étiquettes importées, de sorte que vous n'avez pas à changer les noms d'étiquette dans l'un ou l'autre des documents. Ceci se fait au niveau de l'argument optionnel de la commande ''\externaldocument'' qui permet de placer un préfixe devant chaque étiquette d'un document extérieur. Voici un exemple où les étiquettes du document ''volume1'' sont préfixées par le terme ''V1-'' :

<code latex>
\usepackage{xr}
\externaldocument[V1-]{volume1}
...
... l'introduction du volume 1 (\ref{V1-introduction})...
</code>

==== Le cas particulier des hyperliens ====

Pour que les fonctionnalités de [[ctanpkg>xr|xr]] fonctionnent avec [[ctanpkg>hyperref|hyperref]], vous avez besoin de [[ctanpkg>xr-hyper|xr-hyper]]. Voici un exemple pour faire un hyperlien simple (c'est-à-dire vers un fichier PDF local que vous venez de compiler) :

<code latex>
\usepackage{xr-hyper}
\usepackage{hyperref}
\externaldocument[V1-]{volume1}
...
... \nameref{V1-introduction}...
</code>

Ici, le nom de la référenc apparaîtra comme un lien actif vers le chapitre « Introduction » de ''volume1.pdf''.

Pour faire un lien vers un document PDF sur le web (pour lequel vous disposez du fichier ''.aux''), il faudra modifier votre saisie. En voici un exemple :

<code latex>
\usepackage{xr-hyper}
\usepackage{hyperref}
\externaldocument[V1-]{volume1}[http://livres.net/volume1.pdf]
...
... \nameref{V1-introduction}...
</code>

===== Avec l'extension “zref-xr” =====

L'ensemble expérimental [[ctanpkg>zref]] de Heiko Oberdiek comprend un mécanisme d'hyper-références croisées utilisant son extension [[ctanpkg>zref|zref-xr]]. L'utilisation est étroitement calquée sur celle de [[ctanpkg>xr]] et de [[ctanpkg>xr-hyper]]. En voici un exemple :

<code latex>
\documentclass{article}
\usepackage{zref-xr,zref-user}
\zexternaldocument*{xr02}

\begin{document}
Pour plus de détails, voir \zref{foo}.
\end{document}  
</code>

L'extension fournit toutes les fonctionnalités des anciennes extensions et peut traiter à la fois les étiquettes <latex>\LaTeX</latex> « traditionnelles » et son propre style d'étiquettes.

-----
//Source:// [[faquk>FAQ-extref|Referring to labels in other documents]]

{{htmlmetatags>metatag-keywords=(LaTeX,renvois,labels,références)
metatag-og:title=(Comment obtenir des références croisées à partir de plusieurs sources)
metatag-og:site_name=(FAQ LaTeX francophone)
}}