TeX - LaTeX Stack Exchange is a question and answer site for users of TeX, LaTeX, ConTeXt, and related typesetting systems. It only takes a minute to sign up.
Sign up to join this community
I'm considering this piece of code
\lstinputlisting[
language=C,
breaklines=true,
basicstyle=\scriptsize\ttfamily,
numbers=none,
caption=\colorbox{mylightgray}\parbox{\textwidth}{\texttt{\detokenize{#1}}},
%title=\small\texttt\lstname,
frame=none]{#1}
why this use of parbox gives me an error? How I can have a caption in a box with a specific background color that spans for the entire \textwidth?
Here's another approach using the features provided by the caption package to define a new format for listing captions:
\documentclass{article}
\usepackage{caption}
\usepackage{xcolor}
\usepackage{listings}
\DeclareCaptionFormat{myformat}{%
\colorbox{red!30}{\parbox{\dimexpr\textwidth-2\fboxsep-2\fboxrule\relax}{#1#2\ttfamily#3}}
}
\captionsetup[lstlisting]{format=myformat}
\begin{document}
\begin{lstlisting}[caption={A colored caption}]
test
\end{lstlisting}
\end{document}
\textwidth-2? Is there a better solution?
\textwidth-2\fboxsep (\fboxsep is the separation between the border of the frame and its contents); if you want to increase the width for the text, the frame will protrude into the margins and you will need to use something like \DeclareCaptionFormat{myformat}{% \makebox[\linewidth]{\colorbox{red!30}{\parbox{\dimexpr\textwidth-2\fboxsep\relax}{#1#2\ttfamily#3}} }}
Sep 27, 2012 at 23:54
caption package the option box=colorbox is available to make things easier. See tex.stackexchange.com/a/88206/2574
\linewidth-2... as \textwidth could crash like here: tex.stackexchange.com/q/298475
You could tap into the title key-value and construct the listing caption the way you want to using the following approach:
\documentclass{article}
\usepackage{xcolor}% http://ctan.org/pkg/xcolor
\usepackage{listings}% http://ctan.org/pkg/listings
\usepackage{lipsum}% http://ctan.org/pkg/lipsum
\begin{filecontents*}{foo_bar.c}
void main{}
\end{filecontents*}
\begin{document}
\newcommand{\mylisting}[2][]{%
\refstepcounter{lstlisting}%
\lstinputlisting[language=C,
breaklines=true,
basicstyle=\scriptsize\ttfamily,
numbers=none,
title={\colorbox{black!10}{\parbox{\dimexpr\linewidth-6pt\relax}{\centering \lstlistingname~\thelstlisting:\ \texttt{\detokenize{#2}}}}},
frame=none,#1]%
{#2}%
}%
\lipsum[1]
\noindent\mylisting{foo_bar.c}
\lipsum[2]
\noindent\mylisting{foo_bar.c}
\lipsum[3]
\noindent\mylisting{foo_bar.c}
\lipsum[4]
\end{document}
However, this will require you to manage the "List of Listings" (\lstlistoflistings) by yourself, since no caption is used. Not sure whether you require this though...
title={\colorbox{black!10}{\parbox{\dimexpr\linewidth-6pt\relax}{\centering\texttt{\lstlistingname~\thelstlisting:\ \detokenize{#2}}}}}?
\mylisting command starts off with \refstepcounter{lstlisting}, incrementing the lstlisting counter with the appropriate reference anchor. You must be missing this in your macro if there is no increment in the counter or it always prints a 0. You'll see this is not the case in the graphic output in my answer.
The other solutions are clearly superior, but this seems to work also:
Note that the filecontents package here is used just to be able to include the complete example in one file. It writes out foo_bar.c in the same directory so that it is available for use in via the lstinputlisting command. You don't need to use this in you real code as you will have the files available.
\documentclass{article}
\usepackage{xcolor}
\usepackage{listings}
\usepackage{filecontents}
\begin{filecontents*}{foo_bar.c}
void main{}
\end{filecontents*}
\renewcommand{\lstlistingname}{\texttt{Listing}}%
\lstdefinestyle{MyStyle}{
language=C,
breaklines=true,
basicstyle=\scriptsize\ttfamily,
numbers=none,
frame=none
}
\makeatletter
\long\def\@makecaption#1#2{%
\vskip\abovecaptionskip
\sbox\@tempboxa{\colorbox{yellow}{#1: #2}}%
\ifdim \wd\@tempboxa >\hsize
\colorbox{yellow}{#1: #2}\par
\else
\global \@minipagefalse
\hb@xt@\hsize{\hfil\box\@tempboxa\hfil}%
\fi
\vskip\belowcaptionskip}%
\makeatother
\newcommand{\mylisting}[2][]{%
\lstinputlisting[style=MyStyle,caption=\texttt{\detokenize{#2}},#1]{#2}%
}
\begin{document}
\mylisting[frame=rlbt,language=C]{foo_bar.c}
\end{document}
filecontents package explicitly if you're using it in your current form (within the document preamble).
filecontents. I did not know that.
Nov 10, 2011 at 22:21
filecontents package documentation - the standard filecontents environment (used without the filecontents package) does not allow overwriting of files; something that might be very useful depending on the application. Especially with this Q&A where/when you are playing around with code to answer an OP's question.
You can combine caption and title:
\newcommand{\filelisting}[1]{%
\lstinputlisting[
language=C,
breaklines=true,
basicstyle=\scriptsize\ttfamily,
numbers=none,
caption=\texttt{\detokenize{#1}},
title=\lsttitle{#1},
frame=none]{#1}}
\newcommand{\lsttitle}[1]{\colorbox{mylightgray}{%
\makebox[\dimexpr\textwidth-2\fboxsep\relax]{%
\lstlistingname\ \thelstlisting: \ttfamily\detokenize{#1}}}}
\documentclassand the appropriate packages so that those trying to help don't have to recreate it.filecontentspackage.