如何在 M2 Ventura Mac 上启用 LuaLaTeX arara 对话框

Question

首先，感谢您提出非常详尽的问题。这样您就可以轻松找到走错路的地方。步骤 1 到 4 没问题，让我们看看剩下的步骤。

步骤 4：在我的 HOME 目录 (cd ~) 中，我创建了隐藏文件夹 .arara (mkdir .arara)，在其中创建了作为模板的 arara YAML 配置文件 araraconfig.yaml。

多个账户的这一说法都是误导性的：

您提供的实际上并不是配置文件（请参阅手册中的“配置文件”一章，了解什么是配置文件）。您在此处显示的 YAML 代码是一条规则。我将在下面解释它们如何交互。
~/.arara/araraconfig.yaml不是可识别的位置。就 shell 表达式而言，arara 会~/{.araraconfig.yaml,araraconfig.yaml,.arararc.yaml,arararc.yaml}按此顺序查找全局配置文件。或者，如果您在本地执行此操作（例如，在您的项目中），则./{.araraconfig.yaml,araraconfig.yaml,.arararc.yaml,arararc.yaml}。但您似乎已经认识到这一点，因为您将其作为模板位置提及，并将其复制到某个地方。

第 5 步都很好，但无关紧要，所以我将忽略它。

第 6 步：我将 araraconfig.yaml 文件的副本放在与我的 LuaLateX 项目文件（带有 .tex 扩展名）相同的目录中。

这时，您就会遇到混淆规则和配置文件的问题。因为该位置 (./araraconfig.yaml )，你已经告诉 arara，你在那里显示的文件是一个配置文件，它指示 arara如何执行运行。例如，是否应该记录其输出，是否应该打印详细输出等。

有效的配置文件应该是这样的：

!config
verbose: true

请注意，您提供的错误消息也暗示了这一点：

I could not parse the configuration file, something bad happened.
This part is quite tricky, since it involves aspects of the
underlying data serialization format. I will do my best to help
you in any way I can. There are more details available on this
exception:

DETAILS ---------------------------------------------------------
com.charleskorn.kaml.UnknownPropertyException at identifier on
line 7, column 1: Unknown property 'identifier'. Known properties
are: dbname, defaultPreamble, filetypes, header, laf, language,
logging, logname, loops, paths, preambles,
prependPreambleIfDirectivesGiven, verbose

请参阅，错误消息列出了您实际上可以在配置文件中提供的选项。在您的例子中，您想要提供自定义规则，因此让我们尝试以下操作./araraconfig.yaml：

!config
paths:
- 'rules/'

它告诉 arara 在名为 rules 的目录中查找自定义规则。稍后我会提到它。

步骤 7：在我的 LuaLateX 项目文件（带有 .tex 扩展名）的最上面一行，我包含了 arara 指令：% arara: mydialog在执行 LuaLateX 项目文件中的其余指令之前立即触发 arara 对话框出现。

这指示 % arara: mydialog将导致 arara 在其规则路径中查找命名的规则mydialog。如果没有配置文件，arara 将只查看 TeX 发行版的默认规则。它不会mydialog在那里找到规则。

这就是配置文件发挥作用的地方。上面的配置文件告诉 arararules/也查看目录。所以现在它会检查rules/mydialog.yaml你的项目目录中是否有文件。

这是您要放置规则内容的地方：

!config
# Arara rule: mydialog
# Description: Example rule with a Dialog box
# Author: Your Name

# Declare the rule
identifier: mydialog
name: My Dialog Rule
command: >
  @{
    // Import the necessary Java classes
    import javax.swing.JOptionPane;

    // Display the Dialog box and capture the user's response
    int option = JOptionPane.showConfirmDialog(null, "Are you sure you want to proceed?", "Confirmation", JOptionPane.YES_NO_OPTION);

    // Process the user's response
    if (option == JOptionPane.YES_OPTION) {
      // Execute the necessary commands or actions here
      // For example, you can run a specific command using `runCommand`:
      // runCommand("pdflatex", "-interaction=nonstopmode", "%O", "--shell-escape", "%S");
      // Or execute a custom script:
      // run("myscript.sh");
    } else {
      // User chose not to proceed, so you can perform alternative actions if needed
      // For example, you can terminate the compilation process with an error message:
      // throwError("User cancelled the operation.");
    }
  }

但是等等，这看起来像一条规则，对人类来说，这显然是一条规则。但它不符合 arara 要求的规则语法。如果您像这样运行它，您将收到一条错误消息，因为您使用了commandoutside （文档对需要包含在部分中的commands部分非常清楚）。所以让我们修复该部分（实际上，它仍未经测试，但绝对比 OP 更正确）：commandcommands

!config
# Arara rule: mydialog
# Declare the rule
identifier: mydialog
name: My Dialog Rule
authors:
- Star Blooming
commands:
- name: Show confirmation dialog
  command: >
  @{
    // Import the necessary Java classes
    import javax.swing.JOptionPane;

    // Display the Dialog box and capture the user's response
    int option = JOptionPane.showConfirmDialog(null, "Are you sure you want to proceed?", "Confirmation", JOptionPane.YES_NO_OPTION);

    // Process the user's response
    if (option == JOptionPane.YES_OPTION) {
      // Execute the necessary commands or actions here
      // For example, you can run a specific command using `runCommand`:
      // runCommand("pdflatex", "-interaction=nonstopmode", "%O", "--shell-escape", "%S");
      // Or execute a custom script:
      // run("myscript.sh");
    } else {
      // User chose not to proceed, so you can perform alternative actions if needed
      // For example, you can terminate the compilation process with an error message:
      // throwError("User cancelled the operation.");
    }

    return true;
  }

在上面的规则中，您仍然需要进行一些调整。例如（如 OP 中所示），您要执行的所有实际任务都被注释掉了。而且runCommandarara 中没有。相反，您希望返回它应该运行的所有命令（return true上面的中您应该说类似的内容return [getCommand(…)]；您可以以任何方式构建要返回的列表，例如使用条件）。

注意：您的示例中实际上没有使用任何 arara 对话框，而是使用普通的 Swing。arara 处理是/否对话框的方式是showOptions(250, 4, 'Important!', 'Do you like ice cream?', 'Yes!', 'No!') == 1（文档示例检查您是否喜欢冰淇淋）。不过，我记不清它在规则中的效果如何（我记得的所有示例都在指令中使用这些对话框）。

步骤 8：我创建了一个四行 MWE LuaLateX 项目文件，其唯一目的是测试上述 arara 配置，以演示 arara 对话框应如何显示：

MWE 是完美无缺的；）

重申：您混淆了规则和配置文件以及格式（YAML）的语法正确性和元语言（arara 规则）的语法正确性。

通过上面详细的设置，你的项目将如下所示

.
|- rules/
|  |- mydialog.yaml
|- .araraconfig.yaml
|- myfile.tex

在配置文件和规则文件中添加相应的内容。

请注意，您仍然必须修复该规则才能实际返回有用的命令并做一些有用的事情。

Answer 1