¿Existe un paquete para escribir ejemplos dentro de la documentación de DTX?

Question

Esto es lo que veo enpgfdocumentación, por ejemplo:

¿Existe algún paquete que me ayude a representar muestras similares de dos columnas en mi propia documentación DTX?

Quiero escribir algo como esto:

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

Esto debería imprimir dos columnas, con el código renderizado a la izquierda y el TeX original a la derecha (preferiblemente con resaltado de sintaxis).

Answer 1

Aquí hay un ejemplo usando tcolorboxy su elección de listingso minted. Hay muchísimas opciones de configuración disponibles y no he intentado abordarlas todas aquí. Ver la tcolorboxdocumentación.

Si usa, mintednecesita la línea en la parte superior que invoca --shell-escapey tenga en cuenta que esto puede ser un riesgo de seguridad; Úselo a su propia discreción. Puedes eliminar esa línea si usas listings.

También tenga en cuenta que uso TeXShop y su lualatexmkmotor.

Lo muestro dispExample*ya que es lo que uso en la documentación de mi propio paquete, pero tcblistingparece tener más opciones de configuración. Puede darse el caso de que también se puedan usar esas mismas opciones, o al menos un subconjunto de las mismas, dispExample*pero no lo he explorado.

% !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

Hice mi propio paquetedocshots. Este código:

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

Se presenta como tal: