使用 arara 從同一 tex 檔案產生兩個 pdf 版本（基於條件語句）

Question

實現第一個改進的一種可能方法是利用而不是像原始程式碼那樣\ifdefined依賴 a 。\newif讓我們看看新的 TeX 程式碼：

\documentclass{article}
\begin{document}
Question: What is $2+2$?
\ifdefined\solutionflag\begin{quote} \textbf{Solution:} $2+2=3$ \end{quote}\fi
\end{document}

這裡的計劃很簡單：如果\solutionflag定義了，則將處理特定的程式碼摘錄。這個想法與 using 非常相似\if<flag>，但如果沒有設置這個裝置，它不會抱怨。:)

前面的程式碼可以使用您喜歡的引擎正常編譯，並且不需要arara.如果您想列印答案，只需\def\solutionflag{}在序言中寫下即可，我們就完成了。

更新：這個答案已更新為 4.0+ 版本的規則。檢查舊版的編輯歷史記錄。

讓我們看看這個改進的規則：

!config
identifier: solutions
name: Solutions
authors:
- A duck
commands:
- name: The engine
  command: >
    @{
        prefix = isTrue(solutions, '\\def\\solutionflag{}', '');
        input = '\\input{' + reference.getName() + '}';
        return getCommand(engine, prefix + input, options);
    }
- name: The renaming procedure
  command: >
    @{
        separator = java.io.File.separator;
        prefix = [];
        if (isUnix()) {
            prefix = [ 'mv' ];
        }
        else {
            prefix = [ 'cmd', '/c', 'move' ];
        }
        parent = reference.getParent(); 
        input = parent + separator + getBasename(reference) + '.pdf';
        output = parent + separator + name + '.pdf';
        return getCommand(prefix, input, output);
    }
arguments:
- identifier: engine
  flag: >
    @{
        if ([ 'pdflatex', 'latex', 'xelatex',
              'lualatex' ].contains(parameters.engine)) {
            return parameters.engine;
        }
        else {
            throwError('The provided engine is not valid');
        }
    }
  default: pdflatex
- identifier: name
  flag: >
    @{
        return parameters.name;
    }
  required: true
- identifier: solutions
  flag: >
    @{
        return isTrue(parameters.solutions);
    }
  default: >
    @{
        return false
    }
- identifier: options
  flag: >
    @{
        if (isList(parameters.options)) {
            return parameters.options;
        }
        else {
            throwError('I was expecting a list of options.');
        }
    }

規則參數：

engine：字串，可選，設定引擎。可能的選項有pdflatex、latex、xelatex和lualatex。預設: pdflatex.
solutions：自然布林值，可選，設定是否在文件範圍中定義解決方案巨集。預設: false.
name：字串，必需，設定文件名稱。該文件將被重新命名為該值。無需指定.pdf擴展名。
options：列表，可選，設定要提供給引擎的附加命令列參數列表。

範例執行：

% arara: solutions: { solutions: true, name: 'answers' }
% arara: solutions: { solutions: false, name: 'questions' }

\documentclass{article}
\begin{document}
Question: What is $2+2$?
\ifdefined\solutionflag\begin{quote} \textbf{Solution:} $2+2=3$ \end{quote}\fi
\end{document}

當運行它時arara：

[paulo@cambridge ~] $ $ arara test.tex 
  __ _ _ __ __ _ _ __ __ _ 
 / _` | '__/ _` | '__/ _` |
| (_| | | | (_| | | | (_| |
 \__,_|_|  \__,_|_|  \__,_|

Processing 'test.tex' (size: 264 bytes, last modified: 03/22/2020
06:54:54), please wait.

(Solutions) The engine .................................. SUCCESS
(Solutions) The renaming procedure ...................... SUCCESS
(Solutions) The engine .................................. SUCCESS
(Solutions) The renaming procedure ...................... SUCCESS

Total: 1.25 seconds

我們得到以下輸出：

[paulo@cambridge ~] $ ls *.pdf
answers.pdf  questions.pdf

另一個有趣的建議是透過創建一個選擇性地顯示解決方案的環境來改進文件語義。以下程式碼是 David Carlisle 善意建議的（我欠他 5 美元）：

\newenvironment{solution}{\ifdefined\solutionflag\else\setbox0\vbox\fi\bgroup}{‌\par\egroup}

希望能幫助你！:)

Answer 1