When using moderncv, hyperref (and pageref) links point to section instead of actual target

Question

I am using moderncv - and have a number of cventry items, that contain individual items:

\section{Work Experience}
\cventry{Jan.~2010 -- Mar.~2013}{Project1}{Company1}{}{}{I worked on the following: \begin{itemize*}
    \item Wrote foo \label{tocBar}
    \item Made bar \label{tocBaz}
    \item Improved baz 
\end{itemize*}
}
\cventry{Apr.~2013 -- Mar.~2014}{Project2}{Company2}{}{}{I worked on the following: \begin{itemize*}
    \item Wrote more stuff \label{tocTheory}
    \item And improved theory of everything 
\end{itemize*}
}

Now, I want to create internal (clickable) links that point to some specific \item - e.g. tocBar. Unfortunately, when I try to use \hyperref[some text]{tocBar}, the link generated in the PDF points to the beginning of the section instead of the \item itself.

Similar behavior if I use a \pageref{tocBar} - though in that case, the page number created is correct; it's just the link generated that is wrong (and takes me to the beginning of the section instead of the \item).

Is there anything I can do to create properly working links to individual items?

EDIT: I added a complete, reproducible example here: https://gist.github.com/ttsiodras/76572cb3446cb8b1ad878640337e45b5 Try clicking the generated link in the 1st page, and you'll see it navigates to the 2nd page instead of the 3rd one (that actually contains the element pointed to).

Answer 1

You are using \usepackage[options...]{hyperref}, You should use \AtBeginDocument{\hypersetup{colorlinks=true,urlcolor=color1,linkcolor=color1}} to set the options.

This is because hyperref is already called in the moderncv.sty file and the settings for the package are defined AtBeginDocument, so if you simply try to use the hypersetup command it would either not work or throw an error.

The sections and items are defined differently in moderncv than in article. No counters and the depths are all off. Therefore when you put a \label{} it will point to the latest section. To fix that simply use \phantomsection{} where you want the cross-ref to point to.

Also, I used color1 as the link's color, as otherwise, you'd get a blue that is not consistent with the rest of the format.

My MWE:

\documentclass[11pt,a4paper,sans]{moderncv}
\moderncvstyle{classic}
\moderncvcolor{blue}
\usepackage{mdwlist}
\usepackage{lipsum}
%\usepackage[colorlinks=true,urlcolor=blue,linkcolor=blue]{hyperref} <-- This will throw an error

\firstname{John}
\familyname{Doe}
\email{John.Doe@gmail.com}
\homepage{www.johndoe.com}
\makeatletter
\makeatother
\AtBeginDocument{\hypersetup{colorlinks=true,urlcolor=color1,linkcolor=color1}} %<--- This is how you set it up
\begin{document}
\makecvtitle
\section{Summmary}
\begin{itemize*}
    \item For my work on foo, please see \hyperref[tocAlpha]{this information}. %<-- notice color
\end{itemize*}
\section{Experience}\label{sec:experience}
\subsection{Professional coding}
    \cventry{Jan.~2016 -- today}{Software Engineer}{Space colony}{}{}{Over the last 4 years...
    \begin{itemize*}
        \item Work on \lipsum[1-2] %Shorter and easier, no?
        \item More work on \lipsum[1-2]
        \item Extra work on \lipsum[1-2]
        %\item 
\end{itemize*}
}
    \cventry{year--year}{Job title}{Employer}{City}{}{See section \hyperref[sec:experience]{some text}}

    \cventry{Jan.~2010 -- Jan.~2016}{Software Engineer}{Mars colony}{}{}{Over the last 6 years...\begin{itemize*}
            \phantomsection{}\label{tocAlpha}
        \item Work on foo \lipsum[1-2]
        \item More work on \lipsum[1-2]
        \item Extra work on \lipsum[1-2]
\end{itemize*}
}
\end{document}

Note, I used lipsum package for the example to make it a little more... minimal :)