Есть ли пакет для ввода примеров в документации DTX?

Есть ли пакет для ввода примеров в документации DTX?

Вот что я вижу впгфдокументация, например:

введите описание изображения здесь

Существует ли пакет, который поможет мне визуализировать похожие двухколоночные образцы в моей собственной документации DTX?

Я хочу напечатать что-то вроде этого:

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

В результате должно быть выведено два столбца: сгенерированный код слева и исходный TeX справа (желательно с подсветкой синтаксиса).

решение1

Вот пример использования tcolorboxи ваш выбор listingsили minted. Существует множество доступных вариантов конфигурации, и я не пытался рассмотреть их все здесь. Смотрите документацию tcolorbox.

Если вы используете, mintedвам нужна строка в верхней части вызова --shell-escapeи учтите, что это может быть риском безопасности; используйте ее по своему усмотрению. Вы можете удалить эту строку, если используете listings.

Также обратите внимание, что я использую TeXShop и его lualatexmkдвижок.

Я показываю, dispExample*поскольку это то, что я использую в своей собственной документации по пакетам, но, tcblistingпохоже, имеет больше опций конфигурации. Возможно, те же самые опции или, по крайней мере, их подмножество, также могут использоваться, dispExample*но я не исследовал это.

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

Вывод MWE, показывающий результаты с использованием листингов.

решение2

Я сделал свой собственный пакетdocshots. Этот код:

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

Это выглядит так:

введите описание изображения здесь

Связанный контент