add joss paper workflow

.github/workflows/joss_paper.yml

@@ -0,0 +1,24 @@
+name: Draft Paper for JOSS
+on:
+  push:
+    paths:
+      - paper/**
+      - .github/workflows/joss_paper.yml
+
+jobs:
+  paper:
+    runs-on: ubuntu-latest
+    name: Paper Draft
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Build draft PDF
+        uses: openjournals/openjournals-draft-action@master
+        with:
+          journal: joss
+          paper-path: paper/paper.md
+      - name: Upload
+        uses: actions/upload-artifact@v4
+        with:
+          name: paper
+          path: paper/paper.pdf

.gitignore

@@ -784,3 +784,5 @@ examples/ex1-ase/
 /test-2/
 *.pt
 /README.html
+/paper/paper.pdf
+/paper/jats/

paper/README.md

@@ -6,8 +6,19 @@ SPARC doc in this directory.
 
 ## Using Building Actions
 
-TBD
+
 
 ## Building Locally
 
-TBD
+Follow the instructions in the [JOSS
+manual](https://joss.readthedocs.io/en/latest/paper.html#docker), use
+docker (or equivalent) to build the paper locally:
+```bash
+# At the paper/ subfolder of the SPARC-X-API repository
+docker run --rm \
+    --volume $PWD:/data \
+    --user $(id -u):$(id -g) \
+    --env JOURNAL=joss \
+    openjournals/inara
+```
+This command will create the `paper.pdf` under the `paper/` subfolder.