[Tex/LaTex] hyperref incorrect links: how to debug

debugginghyperref

Problem Statement. I am writing a large document that is too big to provide here for illustration. For the first hundred pages or so, the hyperlinks are correctly matched to the displayed text. For example, the text might refer to page 55, and the hyperlink would also direct the PDF viewer to that page. But then, at some point, the hyperlinks start pointing to incorrect pages, much earlier in the document. For example, a link might go to page 8, but the displayed text might refer correctly to page 80. (Throughout the document, the displayed references, e.g. page numbers or section numbers, remain correct. It is the hyperlinks that are broken at some point.)

Question. is there a way to debug documents that use the hyperref package, to find out why this sort of thing is happening?

Best Answer

Clean Compile (delete all auxiliary files and do the latex-bibtex-latex-latex, etc dance from scratch)
Remove/turn-off as many packages as you can. Some packages may conflict with others
Reduce your document to the smallest sample showing the problem
Google =)
Grep *.log files and run latex interractevly to see if there are problems.

ps. inserting pdfpages can mess-up page number orderring.

Related Solutions

[Tex/LaTex] Hyperref links generated by Glossaries pointing to wrong page

You could try this (if I understood your question):

\pagenumbering{Alph}
\begin{document}
 <your title pages here>
\pagenumbering{Roman}% as replacement for \addtocounter{page}{-2}
 <...>
\pagenumbering{arabic}% for the first chapter as already done

If you are using Alph page "numbers" later in the document, use alph or roman or fnsymbol for the title pages.

[Tex/LaTex] chicago.sty and hyperref: hyperlink formatting

First of all I want to recommend to avoid the old package chicago instead use biblatex

The package hyperref has a small support for the package chicago. It redefines some internal commands of chicago.sty to get the correct hyperlink. The internal definition is:

\@ifpackageloaded{chicago}{%
  \def\citeN{%
    \def\@citeseppen{-1000}%
    \def\@cite##1##2{##1}%
    \def\citeauthoryear##1##2##3{##1 (##3\@cite@opt)}%
    \@citedata@opt
  }%
  \def\shortciteN{%
    \def\@citeseppen{-1000}%
    \def\@cite##1##2{##1}%
    \def\citeauthoryear##1##2##3{##2 (##3\@cite@opt)}%
    \@citedata@opt
  }%
  \def\@citedata@opt{%
    \let\@cite@opt\@empty
    \@ifnextchar [{%
      \@tempswatrue
      \@citedatax@opt
    }{%
      \@tempswafalse
      \@citedatax[]%
    }%
  }%
  \def\@citedatax@opt[#1]{%
    \def\@cite@opt{, #1}%
    \@citedatax[{#1}]%
  }%
}{}

Based on this modification I took the original definition of \citeyearNP and \citeyear and modified them after the scheme of hyperref:

The original definition of chicago.sty:

\def\citeyear{\def\@citeseppen{-1000}%
    \def\@cite##1##2{(##1\if@tempswa , ##2\fi)}%
    \def\citeauthoryear##1##2##3{##3}\@citedata}
\def\citeyearNP{\def\@citeseppen{-1000}%
    \def\@cite##1##2{##1\if@tempswa , ##2\fi}%
    \def\citeauthoryear##1##2##3{##3}\@citedata}

Modified version:

\def\citeyear{\def\@citeseppen{-1000}%
    \def\@cite##1##2{(##1)}%
    \def\citeauthoryear##1##2##3{##3\@cite@opt}\@citedata@opt}
\def\citeyearNP{\def\@citeseppen{-1000}%
    \def\@cite##1##2{##1}%
    \def\citeauthoryear##1##2##3{##3\@cite@opt}\@citedata@opt}

With this redefinition you will get:

enter image description here

Here the complete code. Of course the other cite commands must be redefined too. But I think that it can be done easily by you.

\documentclass{article}
\usepackage{chicago}

\usepackage{filecontents}
\usepackage[colorlinks=true,citecolor=red]{hyperref}
\makeatletter
\def\citeyear{\def\@citeseppen{-1000}%
    \def\@cite##1##2{(##1)}%
    \def\citeauthoryear##1##2##3{##3\@cite@opt}\@citedata@opt}
\def\citeyearNP{\def\@citeseppen{-1000}%
    \def\@cite##1##2{##1}%
    \def\citeauthoryear##1##2##3{##3\@cite@opt}\@citedata@opt}
\makeatother
\begin{filecontents*}{references.bib}
@book{ref,
  author    = {Donald E. Knuth},
  title     = {The TeXbook},
  publisher = {Addison-Wesley},
  year      = {1986}
}
\end{filecontents*}

\begin{document}

\begin{tabular}{llll}
                & cite          & \cite[p.\,1]{ref}         & \cite{ref}        \\
                & citeNP        & \citeNP[p.\,1]{ref}       & \citeNP{ref}      \\
                & citeA         & \citeA[p.\,1]{ref}        & \citeA{ref}       \\  
                & citeANP       & \citeANP[p.\,1]{ref}      & \citeANP{ref}     \\  
$\rightarrow$   & citeN         & \citeN[p.\,1]{ref}        & \citeN{ref}       \\ 
                & shortcite     & \shortcite[p.\,1]{ref}    & \shortcite{ref}   \\   
                & shortciteNP   & \shortciteNP[p.\,1]{ref}  & \shortciteNP{ref} \\   
                & shortciteA    & \shortciteA[p.\,1]{ref}   & \shortciteA{ref}  \\   
                & shortciteANP  & \shortciteANP[p.\,1]{ref} & \shortciteANP{ref}\\   
$\rightarrow$   & shortciteN    & \shortciteN[p.\,1]{ref}   & \shortciteN{ref}  \\   
                & citeyear      & \citeyear[p.\,1]{ref}     & \citeyear{ref}    \\
                & citeyearNP    & \citeyearNP[p.\,1]{ref}   & \citeyearNP{ref}  \\              
\end{tabular}

\bibliographystyle{chicago}
\bibliography{references}
\end{document}

Best Answer

Related Solutions

[Tex/LaTex] Hyperref links generated by Glossaries pointing to wrong page

[Tex/LaTex] chicago.sty and hyperref: hyperlink formatting

Related Question