Memperlihatkan makro matematika dan hasil dalam tabel

Dec 11 2020

Saya sedang menulis beberapa dokumentasi tentang beberapa makro yang telah saya buat. (Saya tahu mungkin akan ada komentar tentang makro juga, tapi bukan itu yang saya tanyakan.) Idealnya, saya ingin membuat semacam tabel di mana setiap baris mencantumkan makro itu sendiri, hasilnya, dan komentar . Berikut adalah MWE yang menunjukkan apa yang saya lakukan saat ini dan apa yang ingin saya lakukan:

\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}

Jawaban

3 egreg Dec 14 2020 at 07:20

Tidak jauh berbeda dengan proposal Ulrich, tetapi dengan pengkodean yang lebih sederhana. Makro memiliki varian * untuk materi yang akan dicetak dalam mode matematika.

\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}

Argumen pertama diserap kata demi kata, tetapi kemudian dipindai ulang untuk digunakan untuk kolom kedua, mungkin di antara $karakter.

3 UlrichDiez Dec 14 2020 at 04:41

Saya telah mengedit contoh saya dan — mengikuti contoh egreg — menambahkan argumen asterisk:
Dengan \ExampleRow*{...kode tersebut dijalankan dalam mode matematika.
Dengan \ExampleRow{...kode tersebut hanya dieksekusi dalam mode matematika jika kode itu sendiri berisi arahan untuk beralih ke mode matematika.

Tidak seperti egreg, bagaimanapun, saya tidak menggunakan \tl_rescan:nn, tetapi tetap menggunakan \scantokens, karena ketika menggunakan \scantokens, hal-hal seperti \verb|...|, yang beralih ke mode verbatim, juga berfungsi. Dengan \tl_rescan:nnhal seperti itu tidak berhasil.

Perbedaan halus tapi krusial antara \scantokensdan \tl_rescan:nndibahas dalam pertanyaan
Apa perbedaan penting / krusial antara \ scantokens / \ tex_scantokens: D dan \ tl_rescan: nn?
dan
expl3 - bagaimana Anda bisa meneruskan konten token-list-variable sebagai argumen ke "fungsi" lain?