Merge with develop

.github/workflows/pages.yml

@@ -0,0 +1,56 @@
+name: Deploy documentation
+
+on:
+  push:
+    branches:
+      - develop
+      - master
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install documentation dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e . -r docs/requirements.txt
+
+      - name: Build site
+        run: zensical build --clean
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -7,8 +7,8 @@
 
 *.bak
 
-docs/build
 docs/pycalfem
+site/
 
 venv-calfem
 
@@ -38,8 +38,6 @@ examples/.ipynb_checkpoints/*
 calfem/.ipynb_checkpoints/*
 exm6.vtk
 
-# new notebook examples
-docs/source/examples/.ipynb_checkpoints/
 .DS_Store
 *.lock
 *.log

docs/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "iis.configDir": ""
+}

docs/docs/calfem_reference.md

@@ -0,0 +1,33 @@
+# Function reference
+
+The [CALFEM manual](https://calfem-python-manual.readthedocs.io/en/latest/)
+is the primary source for conceptual descriptions of the standard
+function groups:
+[material](https://calfem-python-manual.readthedocs.io/en/latest/material_functions.html),
+[element](https://calfem-python-manual.readthedocs.io/en/latest/element_functions.html),
+[system](https://calfem-python-manual.readthedocs.io/en/latest/system_functions.html),
+[graphics](https://calfem-python-manual.readthedocs.io/en/latest/graphics_functions.html),
+[utility](https://calfem-python-manual.readthedocs.io/en/latest/utility_functions.html),
+and [matrix](https://calfem-python-manual.readthedocs.io/en/latest/matrix_functions.html)
+functions. This page is the generated Python API reference for the
+installed package.
+
+## Core functions
+
+::: calfem.core
+
+## Geometry functions
+
+::: calfem.geometry
+
+## Mesh functions
+
+::: calfem.mesh
+
+## Utility functions
+
+::: calfem.utils
+
+## Visualisation functions (Matplotlib)
+
+::: calfem.vis_mpl