Questions tagged [arara]

{arara} is a TeX automation tool based on rules and directives, written in Kotlin.

arara is a TeX automation tool based on rules and directives, written in Kotlin. The author and maintainer is Paulo Cereda.

arara is com­pa­ra­ble with other well-known com­pi­la­tion tools like la­texmk and rub­ber. The key dif­fer­ence is that that arara de­ter­mines its ac­tions from meta­data in the source code, rather than re­ly­ing on in­di­rect re­sources, such as log file anal­y­sis.

Since version 3.0, arara is available on CTAN and also in the TeX Live repository. arara is part of the Island of TeX. The development repository is hosted at the Island of TeX GitLab repository.

197 questions
25
votes
2 answers

arara: making a rule to compile the main file from a chapter file

I am really enjoying the arara tool for automating the compilations of my documents- thanks Paulo and the team :) I work on a few projects that have a main file (say myfile.tex) that \includes its 'chapter' files. A typical example is myfile.tex %…
cmhughes
  • 100,947
18
votes
1 answer

New version of arara broke my custom rule

Disclaimer: Since arara 4.0 is now live on TeX Live, I am antecipating the inevitable and asking the question myself. Hope it helps! :) I updated my TeX Live distro today and found that arara got updated to the very much awaited version…
Paulo Cereda
  • 44,220
17
votes
1 answer

Arara rule to delete files with wildcard

How can I define a Arara rule to delete with wildcard? The following should delete all log files in the folder of the LaTeX file. %!TEX TS-program = Arara % arara: pdflatex: { synctex: yes } % arara: cleanwildcard: { files:…
Uwe Ziegenhagen
  • 13,168
  • 5
  • 53
  • 93
16
votes
1 answer

How do I write an arara rule to conditionally execute a command

I wanted to write an arara rule that will conditionally execute a command based on the existence of external files. Here's an example rule that I was able to get working: !config # open rule for arara # author: AEllett # requires arara…
A.Ellett
  • 50,533
14
votes
1 answer

How do I specify two default options for an arara identifier?

(Apologies if I have the terminology incorrect.) I want to write a directive for arara that can take an argument. The directive should set the name of the output file according to the following rules: If no argument is given, use a default…
Andrew Stacey
  • 153,724
  • 43
  • 389
  • 751
12
votes
1 answer

arara: between silent and verbose mode

Consider the following files myfile.tex % arara: myrule: {items: [lions, zebras]} \documentclass{article} \begin{document} hello world \end{document} myrule.yaml !config # # Sample usage # % arara: myrule: {items: [lions]} # % arara: myrule:…
cmhughes
  • 100,947
10
votes
1 answer

Error in arara: unresolvable property or identifier: file

Disclaimer: Since arara 5.1 is now live on TeX Live and we have some significant changes in the rule format, I am antecipating the inevitable and asking the question myself. Hope it helps! :) So I recently updated my TeX distro and noticed arara has…
Paulo Cereda
  • 44,220
10
votes
4 answers

How to tell Arara to skip redundant steps?

My .tex file starts with the following directives. % arara: lualatex % arara: biber % arara: makeglossaries % arara: makeindex % arara: lualatex % arara: lualatex How can I instruct Arara to skip a step if the output files from this step already…
Evan Aad
  • 11,066
10
votes
1 answer

Is it possible to write an arara rule that invokes another arara rule?

Is it possible to create an arara rule which possibly invokes other arara rules? I've managed to write an arara rule which conditionally executes a command. !config # open rule for arara # author: AEllett # requires arara 3.0+ identifier: open name:…
A.Ellett
  • 50,533
10
votes
2 answers

Is it possible to write an arara rule which uses a bash script?

I've written a shell script to convert some of my files to different formats for use in my LaTeX files. Is it possible to write an arara rule which can use my shell scripts? EDIT I should note: the script is loaded through my bash profile file…
A.Ellett
  • 50,533
8
votes
1 answer

arara: making rules for a script that takes multiple flags and arguments

I'm working on an arara rule for indent.plx which can be called in a few different ways: indent.plx myfile.tex (outputs to the terminal) indent.plx -w myfile.tex (overwrites original file and outputs to terminal) indent.plx -o myfile.tex…
cmhughes
  • 100,947
7
votes
1 answer

Trying to convert my old custom arara rule

I have a rule which worked with the old version of arara: !config # Open the every . that can be opened # The default for is the current file. # The default for is pdf. # Sample usage: # - if myfile.tex is the…
CarLaTeX
  • 62,716
7
votes
1 answer

How to create a meta directive in arara?

I am using arara to automatically compile some tikz images as standalone files. I have a bunch of these figures and they all have the same set of directives % arara: clean: { extensions: [ aux, bbl, bcf, blg, out, run.xml ] } % arara: pdflatex: {…
StrongBad
  • 20,495
7
votes
1 answer

How to compile the main from a chapter when the main is in another directory (with arara)?

This solution works perfectly if the main is in the same directory of the chapter file. But suppose I have: maindirectory main.tex chapterdirectory chapter.tex How can I compile main.tex from chapter.tex? (I'm using Windows 10). I tried…
CarLaTeX
  • 62,716
7
votes
1 answer

(arara) make rule failure non-fatal

I have a rule that attempts to download the bibliography as part of the build, but I would preferably have the option to have it soft-fail when the download fails, as I probably have a up-to-date copy from the last download. I tried the script below…
retorquere
  • 1,498
1
2 3