ARARA(1)

📦 version 2026.0, in alpine 3.24

💖 arara — TeX automation, bestie edition 💖

✨ NAME ✨

okay so ARARA(1) is the General Commands Manual page for arara — a TeX automation tool based on rules and directives. That's the whole vibe. 💅

🎀 SYNOPSIS 🎀

arara [options] documents...

🦋 DESCRIPTION 🦋

arara is a TeX automation tool based on rules and directives, and it literally gives you a way to enhance your TeX experience. The tool is an effort to provide a concise way to automate the daily TeX workflow for users and also package writers. Users might write their own rules when the provided ones do not suffice — yes, bestie, you can make your own rules if the built-in ones aren't serving. 👑

arara takes a list of documents as input. They will be processed according to their directives. Options apply to the execution of all documents — like, every option you pass is for the whole run, not just one doc. 🫶

🔥 OPTIONS 🔥

  • --log — generate a log output. 📝
  • --verbose — print or suppress command output. 👀
  • --dry-run — go through all the motions of running a command, but with no actual calls. rehearsal era, zero real command calls. 🎭
  • --safe-run — run in safe mode and disable potentially harmful features. safety first, bestie. 🛡️
  • --whole-file — extract directives in the file, not only in the header. the whole file gets the vibe check. 🗂️
  • --preamble — set the file preamble as named based on the configuration file. 🎀
  • --timeout — sets an execution timeout for spawned processes. ⏳
  • --language — set the localization to the language specified by code. 🌍
  • --max-loops — set the number > 0 of loops for looping directives. 🔁
  • --working-directory — set the working directory for the whole execution. 📁
  • --call-property — pass a property as key=value parameter into the application to be used within the session. 🔑
  • --properties-file — pass a properties file to the application to be used within the session. 📄
  • --generate-completion — generate a completion script for arara. ✨
  • --version — show the version and exit. 🏷️
  • --help — show a help message and exit. 🙋‍♀️

💀 BUGS 💀

Issue tracker at https://gitlab.com/islandoftex/arara/-/issues. go report the chaos there, bestie. 🐛

🫶 okay that's the page! this was ARARA(1) for arara at v7.2.0, dated 30 June 2025 — go have the most automated TeX era ever 💅✨

📦 where this page comes from