summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/iexec/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/iexec/README.md')
-rw-r--r--macros/latex/contrib/iexec/README.md26
1 files changed, 26 insertions, 0 deletions
diff --git a/macros/latex/contrib/iexec/README.md b/macros/latex/contrib/iexec/README.md
new file mode 100644
index 0000000000..2025d21ebd
--- /dev/null
+++ b/macros/latex/contrib/iexec/README.md
@@ -0,0 +1,26 @@
+[![make](https://github.com/yegor256/iexec/actions/workflows/latexmk.yml/badge.svg)](https://github.com/yegor256/iexec/actions/workflows/latexmk.yml)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/yegor256/iexec/blob/master/LICENSE.txt)
+
+This LaTeX package helps you execute commands from the document and then input
+their output. The package uses [`ShellEscape`](https://ctan.org/pkg/ShellEscape) package.
+
+First, [install it](https://en.wikibooks.org/wiki/LaTeX/Installing_Extra_Packages)
+from [CTAN](https://ctan.org/pkg/iexec)
+and then use in the preamble:
+
+```tex
+\documentclass{article}
+\usepackage{iexec}
+\begin{document}
+Today is \iexec{date +\%e-\%b-\%Y}.
+\end{document}
+```
+
+The full example and all commands are available in the
+[`iexec.tex`](https://github.com/yegor256/exec/blob/master/iexec.tex) file.
+
+If you want to contribute yourself, make a fork, then create a branch,
+then run `make` in the root directory.
+It should compile everything without errors. If not, submit an issue and wait.
+Otherwise, make your changes and then run `make` again. If the build is
+still clean, submit a pull request.