[Tex/LaTex] Using listing with minted gets wrong listoflistings

hyperreflistingslistsmintedtable of contents

I wanted to make a \begin{minted} block to show on the ToC in Listings section with a link to its label. So I did (with links to my Github working repo)

\begin{listing}[!h]
    \begin{minted}[
        linenos,
        frame=single,
        numbersep=6pt,
        baselinestretch=1,
        fontfamily=courier,
        gobble=4,
        fontsize=\tiny,
    ]{text}
    code code code
    \end{minted}
    \caption{some caption}
    \label{code:mytextfile}
\end{listing}

using minted listing

to label my code to get the right link, and

\renewcommand\listingscaption{Code}
\renewcommand\listoflistingscaption{List of Source codes}

% https://tex.stackexchange.com/a/99656/5125
\renewcommand{\listoflistings}{%
    \cleardoublepage
    \addcontentsline{toc}{chapter}{\listoflistingscaption}%
    \listof{listing}{\listoflistingscaption}%
}

template and preamble

to show a List of Listings on the ToC (were not showing with a simple \listoflistings, so I put addcontentsline), with custom texts on it. This produces a problem that, at the "Source code List", clicking on the entry for the listing takes the document to the cover. I cannot go better than this: if I change something, or the "List of Source codes" entry takes to "List of Figures", or it disappears.

Edit: duplicate, althought I could not fix my problem yet.

Best Answer

Going against what I thought it was, the problem was the hyperref package. As this other post here hinted, the include's order was bogus, but also I had to add a \phantomsection.

So, my preamble was

\usepackage[brazil]{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}

% color
\usepackage[table,dvipsnames]{xcolor}

% Blue links
\usepackage[unicode,colorlinks=true,linkcolor=blue]{hyperref}

% "Natbib" style for references
\usepackage[backend=biber,bibencoding=utf8,style=numeric-comp]{biblatex}

% \makeglossaries
% http://en.wikibooks.org/wiki/LaTeX/Glossary#Using_defined_terms
\usepackage[xindy,toc]{glossaries}

% http://texblog.org/tag/addcontentsline/
\usepackage[numbib]{tocbibind}

% \newminted{cpp}
% [chapter] to number by chapter
\usepackage[chapter]{minted}

% TODO anotations
\usepackage[colorinlistoftodos,portuguese]{todonotes}

\usepackage{float}
\usepackage{caption}       % \begin{caption}
\usepackage{csquotes}      % required by {babel}
\usepackage{graphicx}      % \includegraphics
\usepackage{subcaption}    % \begin{subfigure}
\usepackage{verbatim}      % \begin{comment}
\usepackage{fullpage}      % thinner margins
\usepackage{indentfirst}   % indent 1st paragraphs
\usepackage{setspace}      % \setstretch
\usepackage{afterpage}     % \afterpage https://tex.stackexchange.com/q/88657

% turning 'fi' ligatures off
% http://www.latex-community.org/forum/viewtopic.php?f=5&t=953#p13896
\usepackage{microtype}
\DisableLigatures{encoding = *, family = *}

Changing the include's order, turned into

\usepackage[brazil]{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}

% color
\usepackage[table,dvipsnames]{xcolor}

\usepackage{caption}       % \begin{caption}
\usepackage{csquotes}      % required by {babel}
\usepackage{graphicx}      % \includegraphics
\usepackage{subcaption}    % \begin{subfigure}
\usepackage{verbatim}      % \begin{comment}
\usepackage{fullpage}      % thinner margins
\usepackage{indentfirst}   % indent 1st paragraphs
\usepackage{setspace}      % \setstretch
\usepackage{afterpage}     % \afterpage https://tex.stackexchange.com/q/88657

% \newminted{cpp}
% [chapter] to number by chapter
\usepackage[chapter]{minted}

% Blue links
\usepackage[unicode,colorlinks=true,linkcolor=blue]{hyperref}

% turning 'fi' ligatures off
% http://www.latex-community.org/forum/viewtopic.php?f=5&t=953#p13896
\usepackage{microtype}
\DisableLigatures{encoding = *, family = *}

% "Natbib" style for references
\usepackage[backend=biber,bibencoding=utf8,style=numeric-comp]{biblatex}

% \makeglossaries
% http://en.wikibooks.org/wiki/LaTeX/Glossary#Using_defined_terms
\usepackage[xindy,toc]{glossaries}

% http://texblog.org/tag/addcontentsline/
\usepackage[numbib]{tocbibind}

% TODO anotations
\usepackage[colorinlistoftodos,portuguese]{todonotes}

and the renew command for \listoflistings with the \phantomsection

% https://tex.stackexchange.com/a/99656/5125
\renewcommand{\listoflistings}{%
    \cleardoublepage
    \phantomsection
    \addcontentsline{toc}{chapter}{\listoflistingscaption}%
    \listof{listing}{\listoflistingscaption}%
}

Now, clicking the list of listings entry on table of contents guides to the right page of the listing.

Related Solutions

[Tex/LaTex] list of figures and tables when there are no figures or tables

Here is another approach. What it does is to check at the end of the document the values of the figure and table counters, and add to the .aux file a boolean flag setting depending on whether these values are zero or positive.

Then you have on next run \iffigures and \iftables which allow you to act conditionally.

In the code below, perhaps the \global are not really needed, I didn't check.

See also a variant at bottom which does not use the figure/table counters because they might well be reset to zero due to document sectioning (as pointed out by egreg in a comment).

\documentclass[10pt,twocolumn]{article}
\usepackage{lipsum}
\usepackage[margin=0.75in]{geometry}
\usepackage{float}
\floatstyle{boxed}

\restylefloat{figure}
\restylefloat{table}

\newif\iffigures
\newif\iftables

\makeatletter
\AtEndDocument {%
    \if@filesw
       \ifnum\value{figure}=\z@ % no figures
          \immediate\write\@mainaux {\global\string\figuresfalse}%
       \else
          \immediate\write\@mainaux {\global\string\figurestrue}%
       \fi
       \ifnum\value{table}=\z@ % no tables
          \immediate\write\@mainaux {\global\string\tablesfalse}%
       \else
          \immediate\write\@mainaux {\global\string\tablestrue}%
       \fi
    \fi
}
\makeatother 

% for the purpose of testing

% this will make a MWE without tables
\long\def\IGNORE #1\ENDIGNORE{}

% uncomment to make a MWE with tables
% \let\IGNORE\empty
% \let\ENDIGNORE\empty

\begin{document}

\tableofcontents

% 
\iffigures
   \addcontentsline{toc}{section}{List of Figures}
   \listoffigures
\fi

% 
\iftables
   \addcontentsline{toc}{section}{List of Table}
   \listoftables
\fi

\section{First section}
\lipsum[\inputlineno]
\begin{figure}[H]\centering
\LaTeX\LaTeX
\caption{my figure}
\end{figure}
\lipsum[\inputlineno]
\begin{figure}[H]\centering
\LaTeX\TeX
\caption{another figure}
\end{figure}
\section{Second section}
\lipsum[\inputlineno]
\IGNORE
\begin{table}[H]\centering
\TeX\LaTeX
\caption{my table}
\end{table}
\ENDIGNORE
\lipsum[\inputlineno]
\IGNORE
\begin{table}[H]\centering
\TeX\TeX
\caption{another table}
\end{table}
\ENDIGNORE
\lipsum[\inputlineno]
\end{document}

Here is for a document with figures but no tables:

without tables

And if tables are present:

with tables

Three compilations needed.

Variant. I don't know to what extent patching \figure and \table as here is OK, depends perhaps on float related packages. At the worst I guess doing the patches immediately after \begin{document} should be enough (at the end of preamble might not be enough if some package does stuff during At Begin Document).

\documentclass[10pt,twocolumn]{article}
\usepackage{lipsum}
\usepackage[margin=0.75in]{geometry}
\usepackage{float}
\floatstyle{boxed}

\restylefloat{figure}
\restylefloat{table}

\newif\iffigures
\newif\iftables

\makeatletter

\let\OLDfigure\figure
\def\figure {\figures@in@document\OLDfigure }
\let\OLDtable\table
\def\table  {\tables@in@document\OLDtable }

\def\figures@in@document {%
    \immediate\write\@mainaux {\global\string\figurestrue}%
    \global\let\figures@in@document\empty
}

\def\tables@in@document {%
    \immediate\write\@mainaux {\global\string\tablestrue}%
    \global\let\tables@in@document\empty
}

\makeatother

% for the purpose of testing

% this will make a MWE without tables
\long\def\IGNORE #1\ENDIGNORE{}

% uncomment to make a MWE with tables
%\let\IGNORE\empty
%\let\ENDIGNORE\empty

\begin{document}

\tableofcontents

% 
\iffigures
   \addcontentsline{toc}{section}{List of Figures}
   \listoffigures
\fi

% 
\iftables
   \addcontentsline{toc}{section}{List of Table}
   \listoftables
\fi

\section{First section}
\lipsum[\inputlineno]
\begin{figure}[H]\centering
\LaTeX\LaTeX
\caption{my figure}
\end{figure}
\lipsum[\inputlineno]
\begin{figure}[H]\centering
\LaTeX\TeX
\caption{another figure}
\end{figure}
\section{Second section}
\lipsum[\inputlineno]
\IGNORE
\begin{table}[H]\centering
\TeX\LaTeX
\caption{my table}
\end{table}
\ENDIGNORE
\lipsum[\inputlineno]
\IGNORE
\begin{table}[H]\centering
\TeX\TeX
\caption{another table}
\end{table}
\ENDIGNORE
\lipsum[\inputlineno]
\end{document}

[Tex/LaTex] Caption and label on Minted code

You can define a non-floating environment which can break over pages and put the minted environment in that one. This is a documented feature:

8 FAQ and Troubleshooting

I need a listing environment that supports page breaks. The built-in listing environment is a standard float; it doesn’t support page breaks. You will probably want to define a new environment for long floats. [...]
With the caption package, it is best to use minted’s newfloat package option. See
https://tex.stackexchange.com/a/53540/10742

Loading minted.sty with newfloat option enables you to customize the listing environment, caption.sty offers \captionof for captions outside floating environments. Check their docs for further (plenty of) options.

Putting it together:

\documentclass{article}
\usepackage[newfloat]{minted}
\usepackage{caption}

\newenvironment{code}{\captionsetup{type=listing}}{}
\SetupFloatingEnvironment{listing}{name=Source Code}

\begin{document}
\begin{code}
\captionof{listing}{My C-Code}
\label{code:c-code}
\begin{minted}{c}
int main() {
printf("hello, world");
return 0;
}
\end{minted}
\end{code}

Reference to \ref{code:c-code}.  

\end{document}

Best Answer

Related Solutions

[Tex/LaTex] list of figures and tables when there are no figures or tables

[Tex/LaTex] Caption and label on Minted code

Related Question