I'm following a wonderful walk-through here in tex.stackexchange, as well as having RTFM (it really is fine), but am missing something.

Using OSX 10.10.5 - Yosemite. Latest version of TeXShop installed. TeX Live not complaining.

I have created an araraconfig.yaml file in my home directory:

ls -l ~/ | grep arara
-rw-r--r--    1 mikekilmer  staff   218B Jul 26 21:50 araraconfig.yml

It looks like this:

# Config file to use texmfhome as search path
# # author: Marco Daniel
# # requires arara 3.0+
 - /Users/mikekilmer/Library/texmf/scripts/arara/rules

 - extension: lytex
   pattern: ^(\s)*%\s+

Inside of /Users/mikekilmer/Library/texmf/scripts/arara/rules there is the lilypond rule:

$ ls -l /Users/mikekilmer/Library/texmf/scripts/arara/rules
total 8
-rw-r--r--  1 mikekilmer  staff   433B Jul 26 20:45 lilypond.yml


# Mainfile rule for arara
# author: Marco Daniel
# requires arara 3.0+
identifier: lilypond
name: Lilypond
command: <arara> lilypond-book @{format} @{options} @{output} "@{file}"
- identifier: format
  flag: <arara> --format=@{parameters.latex-programm}
  default: <arara> --format=latex
- identifier: options
  flag: <arara> @{parameters.options}
- identifier: output
  flag: <arara> --output=@{parameters.output}

And finally a test file:

% arara: lilypond
% arara: pdflatex: { files: [ test.tex ] }

\relative c' {
  c2^"Text" g'2 \times 2/3 { f8 e d } c'2 g4


$ arara test.lytex
  __ _ _ __ __ _ _ __ __ _ 
 / _` | '__/ _` | '__/ _` |
| (_| | | | (_| | | | (_| |
 \__,_|_|  \__,_|_|  \__,_|

I'm sorry, but the file 'test.lytex [.tex, .dtx, .ltx]' does not
exist. Note that when you provide only the basename (i.e, the
filename without the extension) or with an unknown extension,
arara will try to look for files ending with the predefined
extensions [.tex, .dtx, .ltx] in that order. You can override the
order, the search pattern or even add support for new extensions
through the configuration file. Please refer to the arara manual
to learn more about this feature.

Within directory I'm running command in:

$ ls -l | grep test
-rw-r--r--  1 mikekilmer  staff   231B Jul 26 21:52 test.lytex
-rw-r--r--  1 mikekilmer  staff   671B Jul 26 21:56 test.tex

Can anyone make a recommendation on further troubleshooting?

  • What is your source file actually called? – Joseph Wright Jul 27 '16 at 14:04
  • Hi @JosephWright - test.lytex – MikeiLL Jul 27 '16 at 14:05
  • I'm pretty sure arara works on the basis the file has to be of extension .tex, .ltx or .dtx, i.e. here it's looking for test.lytex.tex. – Joseph Wright Jul 27 '16 at 14:07
  • 1
    yes but I think adding - extension: lytex to the config file should allow lytex – MikeiLL Jul 27 '16 at 14:09
  • 2
    Oh my, I know what's going on! Ducks are very slow at spotting things, I am terribly sorry! :) You are using .yml as extension instead of .yaml, so arara is not finding your configuration file! Could you rename the extension of your YAML files to .yaml? I know .yml is quite used as well (specially for Ruby blokes), so it might be interesting for the next version to check that extension as well. – Paulo Cereda Jul 30 '16 at 10:35

The answer ended up being simply that as of arara 3.0 the extension of the YAML file needs to be .yaml and not just .yml.

A way to test if your config file is being seen by Arara is simply to use some bad YAML syntax in it.

For example if you add the line:

x paths:

instead of paths:, then if Arara is seeing it, it will return an error:

 / _` | '__/ _` | '__/ _` |
| (_| | | | (_| | | | (_| |
 \__,_|_|  \__,_|_|  \__,_|

I'm sorry, but apparently your arara configuration file is
invalid, that is, it has invalid or missing YAML entries.
Unfortunately, arara cannot proceed until the error is fixed. I
tried my best to dump the error message, so here it is:

Problem: Can't construct a java object for
exception=Cannot create property=x paths for
Unable to find property 'x paths' on class:
Error found in line 0, column 0.

If, for example, your file is named araraconfig.yml (as of arara 3.0), the error will not be returned because Arara is looking for a file with the .yaml extension.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.