Как получить несколько индексов с помощью arara?

Question

Спасибо Пауло за то, что он показал мне это: все araraправила имеют неявный параметр, называемый files, который принимает список имен файлов (разделенных запятыми). araraЗатем он будет перебирать этот список и применять эту директиву к каждому элементу в списке.

Другой момент заключается в том, что вам не нужны два запуска pdfLaTeX между BibTeX и MakeIndex: первого запуска 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 в комментарии, это пакет imakeidx, который запускается makeindexиз pdfLaTeX. Поскольку makeindexэто доверенная программа, ей разрешено работать в ограниченном shell-escape, который обычно включен. Пакет 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