captionsfloatsgraphics
Similar to putting a tikzpicture inside a \caption{}, I would like to insert an external icon inside figure captions, something like:
\begin{figure}
\caption{text with \includegraphics{icon} somewhere inside}
\includegraphics{image}
\end{figure}
How might this be done?
This example, slightly altered from the subcaption package documentation is probably what you're looking for (\rule is meant for illustration only):
\documentclass{article}
\usepackage{caption,subcaption}
\begin{document}
\begin{figure}
\hfill\subcaptionbox{A subfigure\label{fig:1a}}[8em]{\centering \rule{5pt}{3em}}
\hfill\subcaptionbox{Another subfigure\label{fig:1b}}{\centering \rule{10em}{2em}}
\hfill\subcaptionbox{A final subfigure\label{fig:1c}}[9em]{\centering \rule{2em}{4em}}
\hfill\null
\caption{A figure}\label{fig:1}
\end{figure}
Look at Figure~\ref{fig:1a} and~\ref{fig:1b}, or even Figure~\ref{fig:1c}. Everything is contained in Figure~\ref{fig:1}.
\end{document}
The subcaption package necessarily requires its contents to be typeset in a box. As such, the use of the \subcaptionbox{<heading>}[<width>][<inner-pos>]{<contents>} is ideal to have possible variable-width (the <width> argument is optional) contents with a subcaption. Without the <width> specification, the subfigure will be put in a box of "natural width" equivalent to the width of <contents>. So, if you have images that are very wide, you don't have to worry about specifying <width>. However, for a very narrow <contents> specifying <width> will allow for correct typesetting of the caption.
Also, there are ways to manipulate the representation of the your (sub-)captions and references.
Instead of using a floating environment which can't handle page breaks you can use a simple list environment. To set a caption you can use the command \captionof. The command is provided by
capt-of,caption orscrreprt, scrbook and scrartclHere an example
\documentclass{article}
\usepackage{kantlipsum}
\usepackage{capt-of}
\begin{document}
\kant[1-2]
\noindent\hrulefill
\begin{center}
\rule{3cm}{3cm}
\captionof{figure}[short caption]{%
\kant[4-6]}
\end{center}
\noindent\hrulefill
\kant[1]
\end{document}
Best Answer
You need to protect
\includegraphicsinside\caption; this, however, will add the image also to a possible list of figures, so perhaps you would rather use the optional argument of\caption; in this case, no protection is needed. The following example code shows both alternatives: