How to use arara with TeXShop

Question

I try to use arara with TeXShop on my Mac, but I don't understand some steps either javascript, probably because of my english & my programer level.

I create first the arara.engine in the /Engines folder :

#!/bin/bash
export PATH=/usr/texbin:/usr/local/bin:${PATH} 
arara "$1"

I use Tex Live Utility, & the package arara exists. OK.

I install the arara-3.0-installer.jar with the cross-platform installer. Ok.

I put all files from sources in my computer. Ok. But I don't agree the step with Apache Maven, it just seemed too complicated… & isn't it to program complicated things ? :( So !

I choose the compilation mode arara & I just put in preamble :

% arara: xelatex
% arara: makeglossaries
% arara: xelatex -shell-escape
% arara: xelatex

& nothing. What I missed ? Thanks

Answer 1

There is already an arara engine in TeXShop, and arara is already installed as part of TeXLive. Move the arara engine from the ~/Library/TeXShop/Engines/Inactive folder to the Engines folder itself. Then restart TeXShop.

In your document add the line:

% !TEX TS-program = arara

in addition to your arara lines and things should just work.

You can get TeXShop to add this line for you by using the Program choice in the Macros menu.

(Or choose the arara engine from the dropdown menu next to the Typeset button)

Note If you have created your own engine, you need to make sure the executable bit is set. To do this, use the Terminal and use the following command (assuming you have named the engine myarara.engine:

 chmod +x ~/Library/TeXShop/Engines/myarara.engine

You shouldn't have to do this if you are using the preinstalled arara engine.