145

I want to cross-reference between different .tex files, just because I want to put every chapters separately.

Let's say in file chapterI.tex I have \label{a} and I want to access this in file chapterII.tex using something like \ref{a}. How to do this exactly in LaTeX, moreover if LEd have an easy feature to cover this, it will be better (I have put those both files in the same project).

I found another question with similar title, but I just didn't really understand. It's here: Cross-reference between LaTeX files.

  • You can certainly make a cross-reference across files like you want. \label{a} in one file, and \ref{a} in another. What's not working? Is there a minimal working example that shows the problem? – Mike Renfro Mar 27 '11 at 16:20
  • 1
    @Mike: and how to "compile" it into pdf or dvi exactly? I tried to do that, and it's still ?? after several tries. – zfm Mar 27 '11 at 16:27
  • 3
    Sorry, just to clarify it: Are the chapters all part of one document or are they all separated documents? In the first case it should work out of the box like @Mike said. The second case is described in my answer. – Martin Scharrer Mar 27 '11 at 16:29
  • 1
    @zfm: Since your accepted answer has nothing to do with LEd, perhaps you might change your title to "Cross reference between files in LaTeX" so that the question has broader appeal. – mforbes Sep 14 '11 at 23:39
  • 1
    @zfm I think "Cross-referencing between different documents" would be even more appropriate as a title. – jonathan.scholbach Apr 15 '18 at 8:00
158

You can use the xr package to reference to other LaTeX document.

So in chapterII.tex you say:

\usepackage{xr}
\externaldocument{chapterI}

And then can use \ref{a} like normal. You can also add a prefix:

\externaldocument[I-]{chapterI}

then you can reference it as \ref{I-a} which is useful if you have identical label names in different chapters.

Note that the normal xr doesn't add hyperlinks. It only adds the label text. The zref package can be used for this. It provides the zref-xr subpackage which gives you the same functionality and should work fine with hyperref (after all both packages are from the same author). You only need to replace \externaldocument with \zexternaldocument as well as \ref with \zref.

Note that the xr package reads the aux file, e.g. in this case, it checks chapterI.aux for references.

  • 7
    @Martin: It might be useful to mention that you need to replace \usepackage{xr} with \usepackage{zref-xr}`. (I was not sure what a "subpackage" was when I first read your answer.) – mforbes Sep 14 '11 at 23:34
  • 3
    @Martin: I am stumped: how do you get hyperref to work with zref-xr? Using \zref and \zlabel (with \usepackage{zref-user}) generates the labels properly, but I cannot get hyper refs working. Could you please post a MWE or should I ask a related question emphasizing the hyperref aspect? – mforbes Sep 15 '11 at 6:05
  • 4
    One extra thing: if you use hyperref in one document you must use it in the other document otherwise the reference text will be something like 1[section name]section.1 instead of just 1 (see latex-community.org/forum/viewtopic.php?f=5&t=6531). – dshepherd Mar 2 '15 at 10:43
  • 2
    zref-xr does not create hyperlinks. hyperref module is not ninished in zref. – Igor Kotelnikov Nov 29 '15 at 6:17
  • 2
    It seems that including .tex extension to the file path in \externaldocument{...} ruins the whole thing, just a warning. – Weather Report Jan 23 '17 at 15:49
13

Beamer and xr: If you want to use the xr package to pull external references into a Beamer document, you need to be sure that the source of the references has been typeset using the hyperref package. This is because Beamer uses hyperref by default and the format of the references in the .aux file is different for hyperref. If the references are coming from another Beamer document, there is no need to do anything. If they are coming from a basic LaTeX document you may need to add \usepackage{hyperref} and typeset the source document again. As far as I can tell, there is no downside to always using hyperref.

5

This FAQ from the UK TUG suggests to use xr-hyper if using hyperref:

\usepackage{xr-hyper}
\usepackage{hyperref}
\externaldocument[V1-]{volume1}    % Not volume1.tex
...
... (see Volume~I, Section~\ref{V1-sIntroduction}) ...

The FAQ cites zref-xr as a superset.

Dear users of zref: please edit this answer to list some benefits of zref.

0

subfiles also a solution for this, usage is:

\usepackage{subfiles}
\begin{document}
\subfile{file.tex}
  • 2
    Please make your answer a complete one (including a compilable example). Remember: The main aim is not including a file, but referencing. – TeXnician Aug 8 '17 at 9:54
  • 2
    The subfiles package has no influence at all on cross-referencing. – user36296 Aug 8 '17 at 12:11

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.