Mostra le macro matematiche e genera una tabella

Dec 11 2020

Sto scrivendo della documentazione su alcune macro che ho creato. (So che probabilmente ci saranno anche commenti sulle macro, ma non è quello che sto chiedendo.) Idealmente, vorrei creare una sorta di tabella in cui ogni riga elenca la macro stessa, il risultato e un commento . Ecco un MWE che mostra cosa sto facendo attualmente e cosa mi piacerebbe fare:

\documentclass{article}
\usepackage[margin=1in]{geometry}
\usepackage{xparse}
\usepackage{lmodern}
\usepackage{listings}
\usepackage[most]{tcolorbox}

\DeclareTCBListing{macrobox}{s G{} }{IfBooleanTF={#1}{}{listing side text},title=#2,
  listing options={style=tcblatex,commentstyle=\color{red!70!black}}
}

% Funny macro - don't worry about this part
\NewDocumentCommand{\TnidxRoot}{m m m m m m m}{%
  {#1}_{1} #2 %
  \IfBooleanF{#5}{{#1}_{2} #2} % 
  \IfBooleanTF{#6}{ % 
    {#1}_{3} % 3D
    \IfBooleanT{#7}{#2 {#1}_{4} } % 4D
  }{ % 
    \IfBooleanTF{#3}{\cdots}{\dots} #2 {#1}_{#4} %
  }%
}
% Funny macro - don't worry about this part
\NewDocumentCommand{\Tnsz}{s s t! G{n} O{d}}{%
  \TnidxRoot{#4}{\times}{\BooleanTrue}{#5}{#3}{#1}{#2}%
}

\begin{document}

What I currently do is this:
\begin{macrobox}{Size commands}
$\Tnsz$          \\ % Default
$\Tnsz!$         \\ % Compact, no 2nd index
$\Tnsz{m}$        % Change main letter
\end{macrobox}


But I'd like a nice macro to generate rows of the following table, where the macro for row 1 might be something like \verb|\ExampleRow{\Tnsz}{Default}|.

\begin{tabular}{|l|l|l|}
  \hline
  \LaTeX\ Command & Result & Description \\ \hline
  \verb|\Tnsz| & $\Tnsz$ & Default \\ \hline
  \verb|\Tnsz!| & $\Tnsz!$ & Compact, no second index \\ \hline
  \verb|\Tnsz{m}| & $\Tnsz{m}$ & Change main letter \\ \hline
\end{tabular}

\end{document}

Risposte

3 egreg Dec 14 2020 at 07:20

Non così diverso dalla proposta di Ulrich, ma con una codifica più semplice. La macro ha una variante * per il materiale da stampare in modalità matematica.

\documentclass{article}
\usepackage{amsmath}
\usepackage{booktabs}
%\usepackage{xparse} % uncomment if using LaTeX prior to 2020-10-01

\ExplSyntaxOn

\NewDocumentCommand{\ExampleRow}{svm}
 {
  \texttt{#2} &
  \IfBooleanT{#1}{$} \tl_rescan:nn { } { #2 } \IfBooleanT{#1}{$} &
  #3 \\
 }

\ExplSyntaxOff

\begin{document}

\begin{tabular}{lll}
\toprule
\ExampleRow{\fbox{a}}{Make a framed box}
\ExampleRow{\framebox[2cm][l]{a}}{Make a framed box}
\ExampleRow*{\sin}{Sine function}
\ExampleRow*{\xrightarrow{f}}{Extendable arrow}
\ExampleRow*{\xrightarrow[g]{}}{Extendable arrow}
\bottomrule
\end{tabular}

\end{document}

Il primo argomento viene assorbito alla lettera, ma poi viene scansionato di nuovo per essere utilizzato per la seconda colonna, possibilmente tra i $caratteri.

3 UlrichDiez Dec 14 2020 at 04:41

Ho modificato il mio esempio e, seguendo l'esempio di egreg, ho aggiunto un argomento asterisco:
Con \ExampleRow*{...il codice viene eseguito in modalità matematica.
Con \ExampleRow{...il codice viene eseguito in modalità matematica solo se il codice stesso contiene direttive per passare alla modalità matematica.

A differenza di egreg, tuttavia, non lo uso \tl_rescan:nn, ma lo uso ancora \scantokens, perché durante l'uso funzionano anche \scantokenscose come \verb|...|, che passano alla modalità verbatim. Con \tl_rescan:nnqueste cose non funzionano.

Le sottili ma cruciali differenze tra \scantokense \tl_rescan:nnsono trattate nelle domande
Qual è la differenza essenziale / cruciale tra \ scantokens / \ tex_scantokens: D e \ tl_rescan: nn?
e
Expl3 - come puoi passare il contenuto di una variabile-lista-token come argomento a un'altra "funzione"?