Add pdftocairo rule

CHANGELOG.md

@@ -14,6 +14,10 @@ on.
 
 ## [Unreleased]
 
+### Added
+
+* a new `pdftocairo` rule to convert pdf's into various formats.
+
 ## [7.1.3] - 2024-02-13
 
 ### Added

rules/arara-rule-pdftocairo.yaml

@@ -0,0 +1,33 @@
+!config
+identifier: pdftocairo
+name: pdftocairo
+authors:
+- samcarter
+commands:
+- name: The pdftocairo program
+  command: >
+    @{
+      return getCommand('pdftocairo', '-' + format[0], getBasename(reference.fileName)+'.pdf', options, output);
+    }
+arguments:
+- identifier: format
+  flag: >
+    @{
+        return parameters.format;
+    }
+  default: png
+- identifier: output
+  flag: >
+    @{
+        return parameters.output;
+    }
+- identifier: options
+  flag: >
+    @{
+        if (isList(parameters.options)) {
+            return parameters.options;
+        }
+        else {
+            throwError('I was expecting a list of options.');
+        }
+    }  

website/content/manual/Rules.md

@@ -1984,6 +1984,27 @@ string concatenated with the `pdf` suffix.
 % arara: pdftk: { options: [ burst ] }
 ```
 
+# `pdftocairo`
+
+This rule runs the `pdftocairo` program, which converts Portable Document Format documents to a number of possible output formats using the cairo output device of the poppler PDF library.
+
+- `format` (default: `png`): selects the desired outout format. Possible values are `png`, `jpeg`, `tiff`, `pdf`, `print`, `ps`, `eps` and `svg`.
+
+- `output`: sets the basename of the output file.
+
+- `options`: This option, as the name indicates, takes a list of raw
+  command line options and appends it to the actual script call. An error is
+  thrown if any data structure other than a proper list is provided as the
+  value.
+
+```tex
+% arara: pdftocairo: { 
+% arara: --> format: 'png',
+% arara: --> output: 'imagename',
+% arara: --> options: [ '-r', '150', '-transp', '-singlefile' ]
+% arara: --> }
+```
+
 # `perltex`
 
 This rule runs `perltex`, a wrapper that enables a symbiosis between Perl, a