captionsfloatslistingsnumbering
I have a listing like so:
\lstset{language=Python,caption={Caption}}
\begin{lstlisting}
some Python code goes here
\end{lstlisting}
In the PDF this appears as Listing 1. Caption. How can I make it appear as Figure 1. Caption? It is worth mentioning that mixing real figures and listings has to keep consistent figure numbering.
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}
You can modify the length \floatsep, as appropriate, which designates the vertical distance/length between floats at the top/bottom of a page. By "as appropriate" you would typeset your document and only worry about this (manual) fine-tuning at the end.
The following minimal example shows two pages that are duplicate, except for a modification in \floatsep to show the effect of modifying the float separation.
\documentclass{article}
\usepackage[demo]{graphicx}% http://ctan.org/pkg/graphicx
\usepackage{lipsum}% http://ctan.org/pkg/lipsum
\begin{document}
\lipsum[1]
\begin{figure}[t]
\centering \includegraphics{figure1}
\caption{This is a figure}
\end{figure}
\begin{figure}[t]
\centering \includegraphics{figure2}
\caption{This is another figure}
\end{figure}
\lipsum[2]
\clearpage
\setlength{\floatsep}{1pt}
\lipsum[1]
\begin{figure}[t]
\centering \includegraphics{figure1}
\caption{This is a figure}
\end{figure}
\begin{figure}[t]
\centering \includegraphics{figure2}
\caption{This is another figure}
\end{figure}
\lipsum[2]
\end{document}
From the layouts package documentation it is possible to see the lengths in terms of page/document float elements (p 21 onward):
The default is 12.0pt plus 2.0pt minus 2.0pt which allows for a 2pt stretchability from 12pt.
It is also possible to modify the distance between the figure and the caption using the skip key-value from the caption package. Default is 10pt.
Best Answer
I think it's appropriate to use a little trick here: don't set the caption in the
lstlistingenvironment, but enclose the listing infigureand use\caption:This way you can mix real figures and listings while keeping consistent figure numbering.