Come scrive Paulo Cereda all’inizio del manuale d’uso di Arara, Arara è uno strumento di automazione per TeX. E rispetto ad altri strumenti ha il vantaggio di essere molto flessibile.
L’utilizzo base che se ne può fare è quello di scrivere nel preambolo queste “directives”
`% arara: pdflatex
% arara: bibtex
% arara: pdflatex
% arara: pdflatex
\documentclass…` per compilare il proprio documento secondo la sequenza indicata. (prima di tutto però serve configurare il proprio editor in modo che questo possa vedere Arara come strumento di compilazione, Paulo riporta le istruzioni per TeXworks, altri lo hanno configurato per Vim e WinEdt, io ci sto provando con TexShop).
Ogni “directive” deve essere legata a una “regola”, cioè un file che contiene delle istruzioni che Arara legge ed esegue. Quindi esiste una regola per pdflatex, una per latex, una per xelatex…
Il manuale spiega come scrivere delle regole personalizzate (io ne ho scritta una per songidx, il programma che serve per generare gli indici dei canzonieri creati col pacchetto “songs”).
Riassumendo Arara è uno strumento che permette di gestire facilmente sequenze di compilazione complicate.
Francesco