使用 arara 从同一个 tex 文件生成两个 pdf 版本（基于条件语句）

Question

实现第一个改进的可能方法是利用\ifdefined而不是像原始代码那样依赖\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定义了，则将处理该特定代码摘录。这个想法与使用非常相似\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默认值：。xelatexlualatexpdflatex
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