Gibt es in der DTX-Dokumentation ein Paket zum Eintippen von Beispielen?

Question

Das ist, was ich sehe inpgfDokumentation, zum Beispiel:

Gibt es ein Paket, das mir dabei helfen würde, ähnliche zweispaltige Beispiele in meiner eigenen DTX-Dokumentation darzustellen?

Ich möchte so etwas eingeben:

\begin{sample}
This is \LaTeX!
\end{sample}

Dies sollte zwei Spalten drucken, mit dem gerenderten Code auf der linken Seite und dem Original-TeX auf der rechten Seite (vorzugsweise mit Syntaxhervorhebung).

Answer 1

Hier ist ein Beispiel mit tcolorboxund Ihrer Wahl von listingsoder minted. Es stehen viele, viele Konfigurationsoptionen zur Verfügung und ich habe nicht versucht, sie alle hier zu behandeln. Siehe die tcolorboxDokumentation.

Wenn Sie verwenden, mintedbenötigen Sie die Zeile oben zum Aufrufen --shell-escapeund beachten Sie, dass dies ein Sicherheitsrisiko darstellen kann. Verwenden Sie sie nach eigenem Ermessen. Sie können diese Zeile löschen, wenn Sie verwenden listings.

Beachten Sie auch, dass ich TeXShop und seine lualatexmkEngine verwende.

Ich zeige es dispExample*, weil ich es in meiner eigenen Paketdokumentation verwende, aber es tcblistingscheint mehr Konfigurationsoptionen zu haben. Es kann sein, dass dieselben Optionen oder zumindest eine Teilmenge davon auch mit verwendet werden können, dispExample*aber das habe ich nicht untersucht.

% !TEX program = lualatexmk
% !TEX parameter = --shell-escape % req. for minted
% !TEX encoding = UTF-8 Unicode

\documentclass{article}
% Choose ONE of the following two lines.
\usepackage[listings,documentation]{tcolorbox}
%\usepackage[minted,documentation]{tcolorbox}

\begin{document}
\begin{dispExample*}{sidebyside}
 Hello, \LaTeX{}!
\end{dispExample*}

% Use this block if you use minted.
%\begin{tcblisting}{listing engine=minted, sidebyside,
%  minted language=latex}
% Hello, \LaTeX{}!
%\end{tcblisting}
%\begin{tcblisting}{listing engine=minted, sidebyside,
%  minted language=latex, text side listing}
% Hello, \LaTeX{}!
%\end{tcblisting}
%\begin{tcblisting}{listing engine=minted, sidebyside,
%  minted language=latex, listing side text}
% Hello, \LaTeX{}!
%\end{tcblisting}

% Use this block if you use listings.
\begin{tcblisting}{listing engine=listings, listing style=tcblatex, sidebyside}
 Hello, \LaTeX{}!
\end{tcblisting}
\begin{tcblisting}{listing engine=listings, listing style=tcblatex, sidebyside, listing side text}
 Hello, \LaTeX{}!
\end{tcblisting}
\begin{tcblisting}{listing engine=listings, listing style=tcblatex, sidebyside, text side listing}
 Hello, \LaTeX{}!
\end{tcblisting}
\end{document}

Answer 2

Ich habe mein eigenes Paket gemachtdocshotsDieser Code:

\begin{docshot}
\documentclass{article}
\usepackage{xcolor}
\pagestyle{empty}
\begin{document}
   Hello, {\color{orange}\LaTeX}!
\end{document}
\end{docshot}

Es wird wie folgt wiedergegeben: