Merge pull request #42 from nbehrnd/pandoc_extra

document deployment of docker image pandoc-extra

Author: tarleb

.github/workflows/pandoc_extra.yml

@@ -0,0 +1,24 @@
+name: Usage Pandoc-Extra
+
+on: push
+
+jobs:
+  convert_via_pandoc:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - name: create output folder
+        run: |
+          mkdir output
+      - uses: docker://pandoc/extra:3.8
+        with:
+          args: >-  # break string of arguments into multiple lines
+            README.md --output=output/README.pdf
+            --standalone
+            --template /.pandoc/templates/eisvogel.latex
+            --listings
+            -V block-headings
+      - uses: actions/upload-artifact@v4
+        with:
+          name: output
+          path: output

README.md

@@ -133,8 +133,13 @@ A work around to this is to specify the exact location on the filesystem of the
 
 ```
 - uses: docker://pandoc/extra:3.8
-        with:
-          args: content/cv.md --output=content/cv.pdf --template /.pandoc/templates/eisvogel.latex --listings -V block-headings
+  with:
+    args: >-  # break string of arguments into multiple lines
+      README.md --output=output/README.pdf
+      --standalone
+      --template /.pandoc/templates/eisvogel.latex
+      --listings
+      -V block-headings
 ```
 
 ## Alternatives