Existe um pacote para digitar exemplos na documentação do DTX?

Existe um pacote para digitar exemplos na documentação do DTX?

Isto é o que eu vejo empgfdocumentação, por exemplo:

insira a descrição da imagem aqui

Existe um pacote que me ajudaria a renderizar amostras semelhantes de duas colunas em minha própria documentação DTX?

Quero digitar algo assim:

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

Isto deve imprimir duas colunas, com o código renderizado à esquerda e o TeX original à direita (de preferência com destaque de sintaxe).

Responder1

Aqui está um exemplo usando tcolorboxe sua escolha listingsou minted. Existem muitas, muitas opções de configuração disponíveis e não tentei abordar todas elas aqui. Veja a tcolorboxdocumentação.

Se você usar, mintedprecisará da linha superior invocando --shell-escapee observe que isso pode ser um risco à segurança; use-o a seu próprio critério. Você pode excluir essa linha se usar listings.

Observe também que eu uso o TeXShop e seu lualatexmkmecanismo.

Mostro dispExample*porque é o que uso na documentação do meu próprio pacote, mas tcblistingparece ter mais opções de configuração. Pode ser que essas mesmas opções, ou pelo menos um subconjunto delas, também possam ser usadas, dispExample*mas eu não explorei isso.

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

Saída do MWE mostrando resultados usando listagens.

Responder2

Eu fiz meu próprio pacotedocshots. Este código:

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

Ele é renderizado como tal:

insira a descrição da imagem aqui

informação relacionada