如何用arara取得多個索引？

Question

感謝 Paulo，他向我展示了這一點：所有arara規則都有一個名為的隱式參數files，它採用（逗號分隔的）檔案名稱清單。arara然後將迭代此列表並將該指令應用於列表中的每個項目。

另一點是，您不需要在 BibTeX 和 MakeIndex 之間運行兩次 pdfLaTeX：第一次運行 pdfLaTeX 足以為外部工具產生輔助檔案。最後兩次運行 pdfLaTeX 是必要的，以包含生成的參考書目/索引並整理交叉引用。

您的指令清單可以變更為：

% arara: pdflatex
% arara: bibtex
% arara: makeindex
% arara: makeindex: { files: [ names ] }
% arara: pdflatex
% arara: pdflatex

也許makeindex只用一行替換兩行（假設您的主.tex文件是main.tex）：% arara: makeindex: { files: [ main, names ] }。

或者，如果您想arara聰明一點並跳過不必要的步驟（解釋這裡）：

% arara: pdflatex: { draft: yes }
% arara: bibtex if changed (toFile('mybib.bib'))
% arara: --> || found ('log', 'Warning: Citation')
% arara: makeindex: { files: [ main, names ] } if changed ('idx')
% arara: pdflatex until !found('log', '\\(?(R|r)e\\)?run (to get|LaTeX)')

正如 barbarabeeton 在評論中提到的，另一個選擇是從 pdfLaTeX 中imakeidx運行的套件。makeindex由於makeindex它是受信任的程序，因此允許它在通常啟用的受限 shell 轉義中運行。該imakeidx包已經處理了多個索引和所有內容。

要使用它，您只需使用加載它\usepackage{makeindex}，然後用\makeindex[names]替換\makeindex[name=names]。

然而，repeatindex您使用的軟體包似乎與imakeidx...不相容，我會嘗試找出原因。

或者，如果您喜歡看起來像個酷孩子（像我一樣，在被告知參數之前就完成了所有這些files:-)並且以困難的方式完成它，您可以對文件進行小的修改makeindex.yaml並添加一個basename選項，此選項需要索引檔案的基本名稱（names在您的情況下）並對其進行處理而不是當前檔案名稱。

首先，arguments:在該行下方makeindex.yaml新增選項本身：

- identifier: basename
  flag: >
    @{
      parameters.basename
    }

（顯然，出於某種原因，Java 不喜歡僅使用base，所以我使用了更詳細的basename。）我們設定此選項沒有預設值，因此當它為空時，我們使用getBasename(file)。

現在我們修改該command:部分以使用該選項：

  command: >
    @{
        if (isEmpty(basename))
          { basename = getBasename(file); }
        infile = basename.concat('.').concat(input);
        outfile = [ '-o', basename.concat('.').concat(output) ];
        logfile = [ '-t', basename.concat('.').concat(log) ];
        return getCommand('makeindex', german, style, order, options,
                          logfile, infile, outfile);
    }

首先我們檢查是否basename為空；如果是，則使用中的目前檔案名稱getBasename(file)。然後繼續正常新增輸入、輸出和日誌檔案的副檔名，然後呼叫makeindex可執行檔。

makeindex.yaml（為了方便起見，本答案底部的完整文件修改版本）

之後，您可以將指令變更為：

% arara: pdflatex
% arara: bibtex
% arara: makeindex
% arara: makeindex: { basename: names }
% arara: pdflatex
% arara: pdflatex

pdflatex（請注意，我之前刪除了這兩個規則makeindex：您不需要它們。）

現在您應該已經正確編譯了索引。

如果您沒有對原始副本進行更改makeindex.yaml（您確實應該不是），然後您需要將新makeindex.yaml文件保存在某個資料夾中，然後建立一個.araraconfig.yaml包含以下內容的文件：

paths:
- '/path/to/the/folder/'

並將其放入.araraconfig.yaml當前工作目錄或USER_HOME資料夾中（有關更多信息，請參閱 arara 手冊第 4 章）。如果該makeindex.yaml檔案也在目前工作目錄中，您可以- './'在設定檔的第二行中使用。

完整makeindex.yaml文件：

!config
# Arara, the cool TeX automation tool
# Copyright (c) 2018, Paulo Roberto Massa Cereda 
# All rights reserved.
#
# This rule is part of arara.
identifier: nmakeindex
name: MakeIndex
authors:
- Marco Daniel
- Paulo Cereda
commands:
- name: The MakeIndex software
  command: >
    @{
        if (isEmpty(basename))
          { basename = getBasename(file); }
        infile = basename.concat('.').concat(input);
        outfile = [ '-o', basename.concat('.').concat(output) ];
        logfile = [ '-t', basename.concat('.').concat(log) ];
        return getCommand('makeindex', german, style, order, options,
                          logfile, infile, outfile);
    }
arguments:
- identifier: basename
  flag: >
    @{
      parameters.basename
    }
- identifier: input
  flag: >
    @{
      parameters.input
    }
  default: idx
- identifier: output
  flag: >
    @{
      parameters.output
    }
  default: ind
- identifier: log
  flag: >
    @{
      parameters.log
    }
  default: ilg
- identifier: german
  flag: >
    @{
        isTrue(parameters.german, '-g')
    }
- identifier: order
  flag: >
    @{
        if ([ 'letter', 'word' ].contains(parameters.order)) {
            return isTrue(parameters.order == 'letter', '-l', '');
        }
        else {
            throwError('The provided order is invalid.');
        }
    }
- identifier: style
  flag: "@{ [ '-s', parameters.style ] }"
- identifier: options
  flag: >
    @{
        if (isList(parameters.options)) {
            return parameters.options;
        }
        else {
            throwError('I was expecting a list of options.');
        }
    }

Answer 1