26

I am writing some documentation for a LaTeX package, in which I am going to be including some example LaTeX code. What is the best way to typeset that code? I know I could just use verbatim, but it would be nice to get syntax highlighting. I realize that this is a duplicate of this question, in which the consensus was to use the listings package. The problem with listings is that it seems to only have a driver for TeX, not LaTeX. For example, when I typeset something like this:

\begin{lstlisting}[language=TeX,
                   keywordstyle=\bfseries,
                   identifierstyle=\itseries,
                   stringstyle=\ttfamily]
\begin{minipage}{\hsize}
  This is a test!
\end{minipage}
\end{lstlisting}

it results in something like this:

\begin{minipage}{\hsize}
  This is a test!
\end{center}

which is obviously messed up.

Is there a LaTeX-specific driver for listings? If not, is there another package that does syntax highlighting for LaTeX code?

Improve this question

3 Answers 3

Reset to default
32

You need to give the 'sub-language' for TeX:

language = [LaTeX]{TeX}

As you are writing a package, you might also want to use the moretexcs key to add 'new' LaTeX commands. For example, in my siunitx I have very long list:

  moretexcs    = 
    {
      addto,
      ampere,
      ang,
      angstrom,
      ...

to cover all of the new macros it adds, plus ones from other packages that are in the documentation and are not known to listings.

Improve this answer
11

minted uses the pygments interpreter, which understands TeX, so this might be a valid option.

Improve this answer
1
  • 3
    The problem with using minted is that this document is going to be distributed as a .dtx and many users won't have minted installed (and will thereby not be able to compile the documentation). Commented Nov 24, 2010 at 19:02
0

Just for reference, another solution using the pygments interpreter is texments

Improve this answer

You must log in to answer this question.

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.