chore: added a deploy to github pages workflow

This workflow builds the documentation using `mkdocs` and then publishes it
onto the github pages site.

Author: Tygo-van-den-Hurk

.github/workflows/push--deploy-github-pages.yaml

@@ -0,0 +1,65 @@
+name: Deploy to GitHub Pages
+# Updates the GitHub pages website with the changes made in the last push.
+# Takes in all markdown files and images of the repository and turns that
+# into HTML to present on the GitHub pages website. Used for documentation.
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main, master, release, development]
+    paths:
+      - ".github/workflows/push--deploy-github-pages.yaml"
+      - "mkdocs.yml"
+      - "**/.md"
+      - "**/.markdown"
+      - "**/.png"
+      - "**/.svg"
+      - "**/.jpg"
+      - "**/.jpeg"
+      - "**/*.webp"
+      - "**/*.html"
+      - "**/*.css"
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: github-pages
+  cancel-in-progress: false
+
+jobs:
+
+  build:
+    name: Build site
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6.0.1
+      - name: Setup Pages
+        uses: actions/configure-pages@v5.0.0
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with: { python-version: '3.x' }
+      - name: Install pip
+        run: python -m pip install --upgrade pip
+      - name: Install MkDocs and dependencies
+        run: pip install mkdocs mkdocs-shadcn
+      - name: Build site with MkDocs
+        run: mkdocs build --site-dir ./_site
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v4.0.0
+        with: { path: ./_site }
+
+  deploy:
+    name: Deploy site
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4.0.5

mkdocs.yml

@@ -0,0 +1,15 @@
+site_name: Slyde
+description: Make beautifully animated Slydes and presentations from XML with ease!
+site_author: Tygo van den Hurk
+nav: []
+theme: 
+  name: shadcn
+  show_title: true
+  show_stargazers: false
+  pygments_style:
+    light: shadcn-light
+    dark: shadcn-dark
+  icon: assets/logo-standalone.svg
+  show_datetime: true
+  highlightjs: true
+  color_mode: auto