[Tex/LaTex] Use autoref with minted and its listing environment

hyperrefminted

I would like to use autoref from the hyperref package to create a reference to a floating listing as provided by minted. This code

\documentclass[a4paper]{book}
\usepackage{minted}
\usepackage{hyperref}

\begin{document}
\chapter{My chapter}
Take a look at the code in \autoref{lst:mylisting}.
\begin{listing}[htb]
  \begin{minted}{erlang}
    foo
    bar
  \end{minted}
  \caption{My listing}
  \label{lst:mylisting}
\end{listing}
\end{document}

should produce something like Listing 1.1 with a link around it.
I don't want to use Listing~\ref{lst:mylisting}, because it wouldn't be consistent with all the other links produced by autoref.

Any ideas?

Best Answer

The trick is to define a macro called \listingname or \listingautorefname which stores the name hyperref should use for the reference. In your case, adding the line

\providecommand*{\listingautorefname}{Listing}

produces correct references.

Related Solutions

[Tex/LaTex] minted’s listing environment with hyperref and caption package together

As you already have found out the problem occurs every time the hyperref package will be loaded prior to the minted package. This is happening here:

The hyperref package will be loaded. It does not detect the float package (because the float package is not loaded yet), and therefore it does not patch the float package code.
The minted package will be loaded which loads the float package, and does a \newfloat.
The caption package will be loaded. It does detect the float and hyperref packages, and assumes that the float package code was patched by hyperref. But this assumtion is false in this case.

So as solution you could load the float package prior to the hyperref package and the minted package after the hyperref package - which BTW is the correct load order anyway, see hyperref's README for details.

\documentclass{report}

% it's all in the order of the imports

% this one is the correct one:

% 1. Load the float package
\usepackage{float}

% 2. Load the hyperref package; hyperref will patch the float package
\usepackage{hyperref}

% 3. Load the minted package which will use the patched \newfloat now
\usepackage{minted}

% The load order of the caption package is (or should be) irrelevant now
\usepackage{caption}

\begin{document}

\chapter{test}

\clearpage

\begin{listing}[H] \mint{cl}/(car (cons 1 2))/
\caption{Example of a listing.}
\label{lst:example}
\end{listing}
\clearpage

Listing \ref{lst:example} contains an example of a listing.

\end{document}

[Tex/LaTex] New environment with minted

\documentclass[12pt]{article}
\usepackage{minted}    
\makeatletter
\newenvironment{mycode}[3]
 {\VerbatimEnvironment
  \minted@resetoptions
  \setkeys{minted@opt}{frame=single}% from fancyvrb
  \renewcommand{\minted@proglang}[1]{#1}
  \begin{figure}[htp]%% default placing
    \centering
    \caption{#2}\label{#3}
      \begin{VerbatimOut}{\jobname.pyg}}
 {\end{VerbatimOut}
  \minted@pygmentize{\minted@proglang{}}
  \DeleteFile{\jobname.pyg}
  \end{figure}}
\makeatother

\begin{document}
\begin{mycode}{latex}{some caption}{code:label}
My \code here
\end{mycode}

\end{document}

enter image description here

Best Answer

Related Solutions

[Tex/LaTex] minted’s listing environment with hyperref and caption package together

[Tex/LaTex] New environment with minted

Related Question