Wie kann ich die lstsample-Umgebung (lstdoc-Paket) im Artikel verwenden?

Question

Ich möchte die lstsampleUmgebung aus dem lstdocPaket ausprobieren, das mit demlistingsPaket.

Dazu habe ich folgendes Dokument verfasst:

\documentclass{article}
\usepackage{lstdoc}
\usepackage{lipsum}

\begin{document}

\begin{lstsample}{}{}
  \color{blue}
  \lipsum[68]
\end{lstsample}

\end{document}

Die Kompilierung schlägt jedoch mit der folgenden Meldung fehl:

! Undefined control sequence.
\lst@sampleInput ->\MakePercentComment 
                                       \catcode `\^^M=10\relax \small \lst@s...
l.10     \end{lstsample}

Was vermisse ich?

Answer 1

Das lstdocPaket ist in erster Linie für die Verwendung in Dokumenten gedacht, die die ltxdocKlasse verwenden. Diese lädt docintern die Klasse, die zwei Makrodefinitionen enthält, die hier besonders relevant sind:

\def\MakePercentIgnore{\catcode`\%9\relax}
\def\MakePercentComment{\catcode`\%14\relax}

Da die lstsampleUmgebung diese beiden Makros benötigt, die von Ihnen verwendete Klasse articlesie jedoch nicht definiert, meldet LaTeX diese Makros beim Versuch, Ihren Code zu kompilieren, zu Recht als undefiniert. Das Hinzufügen der beiden oben gezeigten Definitionen in Ihrer Präambel löst dieses Problem.

Eine Besonderheit dieser lstsampleUmgebung ist, dass, damit alles richtig funktioniert,alle Zeilen darin müssen mit einem beginnen, %gefolgt von mindestens 4 LeerzeichenBefolgen Sie diese Regel und Sie werden glücklich sein.

\documentclass{article}

\usepackage{lstdoc}
\usepackage{xcolor}
\usepackage{lipsum}

% The following definitions are taken from doc.dtx.
% see http://mirrors.ctan.org/macros/latex/base/doc.dtx
\def\MakePercentIgnore{\catcode`\%9\relax}
\def\MakePercentComment{\catcode`\%14\relax}

\begin{document}

\begin{lstsample}{}{}
%    \color{blue}
%    \lipsum[68]  
\end{lstsample}

\end{document}