GH Workflow for FORD documentation

.github/workflows/ford.yml

@@ -0,0 +1,54 @@
+name: Fordoc
+
+on:
+  push:
+    branches:
+      - 'main'
+
+permissions:
+  contents: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  documentation:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install gfortran
+        run: |
+          sudo apt install -y gfortran
+
+      - name: Install Open MPI
+        run: |
+          sudo apt install -y openmpi
+
+      - name: Install Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install Graphviz
+        uses: ts-graphviz/setup-graphviz@v2
+
+      - name: Install FORD
+        run: |
+          python -m pip install --upgrade pip
+          pip install ford
+          if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+
+      - name: Build FORD Documentation
+        run: |
+          FC=mpif90 bin/waf --fordonline distclean configure docu
+
+      - name: Deploy Documentation
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          branch: gh-pages
+          folder: docu