Como obter vários índices com arara?

Question

Créditos ao Paulo, por me mostrar isso: todas araraas regras possuem um parâmetro implícito chamado files, que recebe uma lista (separada por vírgula) de nomes de arquivos. ararairá então iterar nesta lista e aplicar essa diretiva a cada item da lista.

Outro ponto é que você não precisa das duas execuções do pdfLaTeX entre BibTeX e MakeIndex: a primeira execução do pdfLaTeX é suficiente para gerar os arquivos auxiliares para as ferramentas externas. As duas últimas execuções do pdfLaTeX são necessárias para incluir as bibliografias/índices gerados e classificar as referências cruzadas.

Sua lista de diretivas pode ser alterada para:

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

e talvez substitua as duas makeindexlinhas por apenas uma (supondo que seu .texarquivo principal seja main.tex): % arara: makeindex: { files: [ main, names ] }.

Ou, se quiser araraser inteligente e pular etapas desnecessárias (explicaçãoaqui):

% 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)')

Outra opção, como barbarabeeton mencionou no comentário, é o imakeidxpacote, que roda makeindexdentro do pdfLaTeX. Por makeindexser um programa confiável, ele pode ser executado em shell-escape restrito, que geralmente está habilitado. O imakeidxpacote já cuida de vários índices e tudo mais.

Para usá-lo você só precisa carregá-lo com \usepackage{makeindex}e substituir \makeindex[names]por \makeindex[name=names].

Porém o repeatindexpacote que você usa parece ser incompatível com imakeidx... Vou tentar descobrir o porquê.

Ou, se você preferir parecer um garoto legal (como eu, que fiz tudo isso antes de saber do filesparâmetro :-) e da maneira mais difícil, você pode fazer uma pequena modificação no makeindex.yamlarquivo e adicionar uma basenameopção que leva o nome base do arquivo de índice ( names, no seu caso) e trabalha nele em vez do nome do arquivo atual.

Primeiro, abaixo da arguments:linha makeindex.yamlvocê adiciona a própria opção:

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

(aparentemente o Java não gosta que você use apenas base, por algum motivo, então usei o mais detalhado basename.) Definimos essa opção sem um valor padrão, para que quando estiver vazia usemos getBasename(file).

Agora modificamos a command:seção para usar essa opção:

  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);
    }

primeiro verificamos se basenameestá vazio; se for, use o nome do arquivo atual de getBasename(file). Em seguida, prossiga normalmente adicionando as extensões dos arquivos de entrada, saída e log e, em seguida, chamando o makeindexexecutável.

(versão completa modificada do makeindex.yamlarquivo no final desta resposta, para sua conveniência)

Depois disso, você pode alterar suas diretivas para:

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

(observe que removi as duas pdflatexregras antes makeindex: você não precisa delas.)

E agora você deve ter o índice compilado corretamente.

Se você não fez a alteração na cópia original makeindex.yaml(que você realmente deverianão), então você precisa salvar o novo makeindex.yamlarquivo em alguma pasta e, em seguida, criar um .araraconfig.yamlarquivo que contenha:

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

e coloque-o .araraconfig.yamlno diretório de trabalho atual ou na sua USER_HOMEpasta (veja o manual do arara, capítulo 4 para mais informações). Se o makeindex.yamlarquivo também estiver no diretório de trabalho atual, você poderá usar - './'a segunda linha do arquivo de configuração.

Arquivo completo 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