From 58c52c4afff673d54710f462c9611f6274442280 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 23 Apr 2020 21:06:30 +0000 Subject: arara (23apr20) git-svn-id: svn://tug.org/texlive/trunk@54853 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/support/arara/README.md | 2 +- .../texmf-dist/doc/support/arara/arara-manual.pdf | Bin 1882028 -> 1890625 bytes .../texmf-dist/doc/support/arara/arara-manual.tex | 2 +- .../doc/support/arara/chapters/rules.tex | 27 ++++++++++- Master/texmf-dist/scripts/arara/arara.jar | Bin 16028291 -> 16028309 bytes .../scripts/arara/rules/authorindex.yaml | 53 +++++++++++++++++++++ .../source/support/arara/arara-5.1.2-src.zip | Bin 129813 -> 0 bytes .../source/support/arara/arara-5.1.3-src.zip | Bin 0 -> 129815 bytes 8 files changed, 81 insertions(+), 3 deletions(-) create mode 100644 Master/texmf-dist/scripts/arara/rules/authorindex.yaml delete mode 100644 Master/texmf-dist/source/support/arara/arara-5.1.2-src.zip create mode 100644 Master/texmf-dist/source/support/arara/arara-5.1.3-src.zip diff --git a/Master/texmf-dist/doc/support/arara/README.md b/Master/texmf-dist/doc/support/arara/README.md index 5c6b8dc2e1e..9adb41b2555 100644 --- a/Master/texmf-dist/doc/support/arara/README.md +++ b/Master/texmf-dist/doc/support/arara/README.md @@ -1,6 +1,6 @@ ![arara](https://i.stack.imgur.com/hjUsN.png) -# arara v5.1.2 +# arara v5.1.3 ![Language: Kotlin](https://img.shields.io/badge/Language-Kotlin-blue.svg?style=flat-square) ![Minimum JRE: 8.0](https://img.shields.io/badge/Minimum_JRE-8-blue.svg?style=flat-square) diff --git a/Master/texmf-dist/doc/support/arara/arara-manual.pdf b/Master/texmf-dist/doc/support/arara/arara-manual.pdf index d6ce4e47feb..ed5a6b0eaac 100644 Binary files a/Master/texmf-dist/doc/support/arara/arara-manual.pdf and b/Master/texmf-dist/doc/support/arara/arara-manual.pdf differ diff --git a/Master/texmf-dist/doc/support/arara/arara-manual.tex b/Master/texmf-dist/doc/support/arara/arara-manual.tex index b93e2a10e66..196d1ce7a44 100644 --- a/Master/texmf-dist/doc/support/arara/arara-manual.tex +++ b/Master/texmf-dist/doc/support/arara/arara-manual.tex @@ -42,7 +42,7 @@ \usepackage[margin=2.5cm]{geometry} \usepackage{arara} -\newcommand{\araraversion}{5.1.2} +\newcommand{\araraversion}{5.1.3} \begin{document} diff --git a/Master/texmf-dist/doc/support/arara/chapters/rules.tex b/Master/texmf-dist/doc/support/arara/chapters/rules.tex index ace21a6fad5..39552b40cab 100644 --- a/Master/texmf-dist/doc/support/arara/chapters/rules.tex +++ b/Master/texmf-dist/doc/support/arara/chapters/rules.tex @@ -36,7 +36,7 @@ The best solution to avoid possible future name conflicts, according to the Imag \end{codebox} \item[\rulebox{asymptote}] -This rule executes the \rbox{asy} command line, referring to Asymptote, a powerful descriptive vector graphics language for technical drawings, inspired by Metapost but with an improved syntax. Please note that you will have to make the \rbox{.asy} extension known to \arara\ in order to compile Asymptote files. Furthermore, it is advised to use this in your regular \TeX\ document specifying the \abox{files} parameter to include all graphics you want to compile for inclusion in your document. +This rule executes the \rbox{asy} command line program, referring to Asymptote, a powerful descriptive vector graphics language for technical drawings, inspired by Metapost but with an improved syntax. Please note that you will have to make the \rbox{.asy} extension known to \arara\ in order to compile Asymptote files. Furthermore, it is advised to use this in your regular \TeX\ document specifying the \abox{files} parameter to include all graphics you want to compile for inclusion in your document. \begin{description} \item[\abox{color}] This option, as the name suggests, provides the underlying color model to be used in the current execution. Possible values are: @@ -78,12 +78,37 @@ This rule executes the \rbox{asy} command line, referring to Asymptote, a powerf \item[\abox{output}] This option, as the name suggests, sets an alternative output directory or file name. Make sure to take a look at the Asymptote manual for further details. \item[\abox{options}] This option, as the name indicates, takes a list of raw command line options and appends it to the actual system call. An error is thrown if any data structure other than a proper list is provided as the value. +\end{description} \begin{codebox}{Example}{teal}{\icnote}{white} % arara: asymptote: { files: [ mydrawing.asy ] } \end{codebox} + +\item[\rulebox{authorindex}] +This rule calls the \rbox{authorindex} wrapper, a Perl script that processes auxiliary files generated by the package of the same name, producing author index files, with the \rbox{ain} extension. + +\begin{description} +\item[\rpsbox{draft}] This option sets whether the script should write additional information to the produced file. For each author, the +labels of all references and the page numbers where they are cited are included as comments. This detail may help if you manually edit the generated author index. + +\item[\rpsbox{index}] This option sets whether the script should create a file suitable for further processing with \rbox{makeindex} or +the like. For example, you could use that to make a common author and subject index. Note the extension of the generated file still will be the default one. + +\item[\rpsbox{keep}] This option sets whether the script should retain the temporarily generated \rbox{bst} file after the run finishes. This information will give you a good starting point for advanced customization of the author index. + +\item[\rpsbox{print}] This option, as the name indicates, sets whether the script should print the result to standard output instead of writing it to the output file. + +\item[\rpsbox{recurse}] This option sets whether the script should automatically process auxiliary files produced by included files. This behaviour is enabled by default. + +\item[\abox{options}] This option, as the name indicates, takes a list of raw command line options and appends it to the actual system call. An error is thrown if any data structure other than a proper list is provided as the value. \end{description} +\begin{codebox}{Example}{teal}{\icnote}{white} +% arara: authorindex: { draft: yes } +\end{codebox} + + + \item[\rulebox{bib2gls}] This rule executes the \rbox{bib2gls} command line application which extracts glossary information stored in a \rbox{bib} file and converts it into glossary entry definitions in resource files. This rule passes the base name of the \mtbox{currentFile} reference (i.e, the name without the associated extension) as the mandatory argument. diff --git a/Master/texmf-dist/scripts/arara/arara.jar b/Master/texmf-dist/scripts/arara/arara.jar index 6422203a428..8c97b0e5463 100644 Binary files a/Master/texmf-dist/scripts/arara/arara.jar and b/Master/texmf-dist/scripts/arara/arara.jar differ diff --git a/Master/texmf-dist/scripts/arara/rules/authorindex.yaml b/Master/texmf-dist/scripts/arara/rules/authorindex.yaml new file mode 100644 index 00000000000..a7e32141a97 --- /dev/null +++ b/Master/texmf-dist/scripts/arara/rules/authorindex.yaml @@ -0,0 +1,53 @@ +!config +# Arara, the cool TeX automation tool +# Copyright (c) 2020, Island of TeX +# All rights reserved. +# +# This rule is part of arara. +identifier: authorindex +name: AuthorIndex +authors: +- Island of TeX +commands: +- name: The AuthorIndex script + command: > + @{ + return getCommand('authorindex', draft, index, keep, print, + recurse, options, getBasename(reference.getName())); + } +arguments: +- identifier: draft + flag: > + @{ + return isTrue(parameters.draft, '-d'); + } +- identifier: index + flag: > + @{ + return isTrue(parameters.index, '-i'); + } +- identifier: keep + flag: > + @{ + return isTrue(parameters.keep, '-k'); + } +- identifier: print + flag: > + @{ + return isTrue(parameters.print, '-p'); + } +- identifier: recurse + flag: > + @{ + return isFalse(parameters.recurse, '-r'); + } +- identifier: options + flag: > + @{ + if (isList(parameters.options)) { + return parameters.options; + } + else { + throwError('I was expecting a list of options.'); + } + } diff --git a/Master/texmf-dist/source/support/arara/arara-5.1.2-src.zip b/Master/texmf-dist/source/support/arara/arara-5.1.2-src.zip deleted file mode 100644 index afa90b9ebee..00000000000 Binary files a/Master/texmf-dist/source/support/arara/arara-5.1.2-src.zip and /dev/null differ diff --git a/Master/texmf-dist/source/support/arara/arara-5.1.3-src.zip b/Master/texmf-dist/source/support/arara/arara-5.1.3-src.zip new file mode 100644 index 00000000000..6a3830d644e Binary files /dev/null and b/Master/texmf-dist/source/support/arara/arara-5.1.3-src.zip differ -- cgit v1.2.3