Add initial implementation

Author: antaljanosbenjamin

.github/workflows/test.yml

@@ -0,0 +1,47 @@
+name: test
+on: [push]
+jobs:
+  test-example:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ./ # For real world usage this should be replaced by "antaljanosbenjamin/compile-latex@master"
+        with:
+          file: test.tex
+          args: -pdf
+      - run: '(test -f test.pdf && echo PDF exists) || (echo PDF does not exist && exit 1)'
+  test-file-in-subdirectory:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ./ # For real world usage this should be replaced by "antaljanosbenjamin/compile-latex@master"
+        with:
+          file: tests/subdir_test.tex
+      - run: '(test -f subdir_test.dvi && echo DVI exists) || (echo DVI does not exist && exit 1)'
+  test-output-directory:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ./ # For real world usage this should be replaced by "antaljanosbenjamin/compile-latex@master"
+        with:
+          file: test.tex
+          output-directory: tests/output
+      - run: '(test -f tests/output/test.dvi && echo DVI exists) || (echo DVI does not exist && exit 1)'
+  test-args:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ./ # For real world usage this should be replaced by "antaljanosbenjamin/compile-latex@master"
+        with:
+          file: test.tex
+          args: -help
+  test-full:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ./ # For real world usage this should be replaced by "antaljanosbenjamin/compile-latex@master"
+        with:
+          file: tests/subdir_test.tex
+          output-directory: tests/outputpdf
+          args: -pdf
+      - run: '(test -f tests/outputpdf/subdir_test.pdf && echo PDF exists) || (echo PDF does not exist && exit 1)'

README.md

@@ -1,2 +1,33 @@
-# compile-latex
-GitHub action to compile LaTeX documents.
+# Compile latex action
+This action can be used to compile latex documents with `latexmk`. The action uses an ubuntu based [docker image](https://github.com/antaljanosbenjamin/latex-extra-docker).
+
+It calls `latexmk` in the working directory on a single tex file.
+## Inputs
+
+### `file` (required)
+The LaTeX file to be compiled.
+
+### `output-directory`
+The directory for output files, relative to the root of the repository. Defaulted to `.`.
+### `args`
+Additional arguments to pass over to `latexmk`.
+
+## Example usage
+
+
+```
+name: test
+on: [push]
+jobs:
+  test-example:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: antaljanosbenjamin/compile-latex@master
+        with:
+          file: test.tex
+          args: -pdf
+      - run: '(test -f test.pdf && echo PDF exists) || (echo PDF does not exist && exit 1)'
+```
+
+For further examples check the [test workflow](.github/workflows/test.yml).

action.yml

@@ -0,0 +1,25 @@
+name: 'Compile LaTeX'
+description: 'Calls latexmk to compile a LaTeX document'
+author: antaljanosbenjamin
+branding:
+  icon: file-text
+  color: orange
+inputs:
+  file:
+    description: 'The LaTeX file to be compiled, relative to the root of the repository.'
+    required: true
+  output-directory:
+    description: 'The directory for output files, relative to the root of the repository.'
+    required: false
+    default: .
+  args:
+    description: 'Additional arguments to pass over to latexmk.'
+    required: false
+runs:
+  using: docker
+  image: docker://antaljanosbenjamin/latex-extra:latest
+  entrypoint: latexmk
+  args:
+    - '-output-directory="/github/workspace/${{ inputs.working-directory }}"'
+    - ${{ inputs.args }}
+    - /github/workspace/${{ inputs.file }}

test.tex

@@ -0,0 +1,8 @@
+% from https://en.wikibooks.org/wiki/LaTeX/Bibliographies_with_biblatex_and_biber
+\documentclass{article}
+
+\begin{document}
+
+Test document   as
+
+\end{document}

tests/lauraPhd2016.bib

@@ -0,0 +1,22 @@
+@article{wombat2016,
+  author   = {Walther Wombat and Klaus Koala},
+  title    = {The true meaning of 42},
+  journal  = {Journal of modern skepticism},
+  date     = {2016},
+  keywords = {trusted}
+}
+@book{lion2010,
+  author    = {Laura Lion and  Gabrielle Giraffe and Carl Capybara},
+  title     = {The dangers of asking the wrong question},
+  publisher = {publishing house},
+  date      = {2010},
+  keywords  = {trusted}
+}
+@online{wikibook,
+  title        = {Generating Bibliographies with biblatex and biber},
+  organization = {Wikibooks},
+  date         = {2016},
+  urldate      = {2016-03-07},
+  url          = {https://en.wikibooks.org/wiki/LaTeX/Generating_Bibliographies_with_biblatex_and_biber},
+  keywords     = {untrusted}
+}

tests/subdir_test.tex

@@ -0,0 +1,13 @@
+% from https://en.wikibooks.org/wiki/LaTeX/Bibliographies_with_biblatex_and_biber
+\documentclass{article}
+\usepackage[backend=biber]{biblatex}
+\addbibresource{lauraPhd2016.bib}
+\begin{document}
+I doubt that there is any useful information here~\cite{wikibook}.
+
+All we know is limited, apart from knowing the answer we all know. Or do we? Wombat and Koala have discovered some interesting things~\cite{wombat2016}.
+
+Some people are too nosy. What can happen to them is described by Laura Lion~\cite[9]{lion2010}.
+
+\printbibliography
+\end{document}