update docs

.gitea/workflows/deploy-docs.yaml

@@ -17,23 +17,15 @@ jobs:
       #image: catthehacker/ubuntu:runner-22.04
         # container runs as a non-root user (usually a user named runner) by default.
       volumes:
-        - /var/www/git-pages:/var/www/git-pages
+        - /var/www/git-pages:/var/www/docs
     steps:
       - name: Checkout Code
         uses: actions/checkout@v4
 
-#      - name: Set up Python
-#        uses: actions/setup-python@v5
-#        with:
-#          python-version: '3.11'
-
       - name: Install MkDocs & Plugins
         run: |
-          #export PATH=/home/runner/.local/bin:$PATH
           python -m pip install --upgrade pip
           pip install mkdocs mkdocs-material
-          #python -m pip install --root-user-action=ignore --upgrade pip
-          #pip install --root-user-action=ignore mkdocs mkdocs-material
 
       - name: Build Static Site
         run: mkdocs build
@@ -52,12 +44,13 @@ jobs:
             exit 1
           fi
 
-          # Ensure target directory exists inside the container environment
-          mkdir -p /var/www/git-pages/test
-
           echo "=== COPYING FILES ==="
-          rm -rf /var/www/git-pages/test/*
-          cp -R site/* /var/www/git-pages/test/
+          # Ensure target directory exists inside the container environment
+          mkdir -p /var/www/docs/test-mkdocs
+          rm -rf /var/www/docs/test-mkdocs/*
+          cp -R site/* /var/www/docs/test-mkdocs/
+          # Force ownership of all files and folders to www-data (UID 33)
+          chown -R 33:33 /var/www/docs/test-mkdocs
 
           echo "=== VERIFYING DESTINATION INSIDE CONTAINER ==="
-          ls -la /var/www/git-pages/test/
+          ls -la /var/www/docs/test-mkdocs/

docs/test/test.md

@@ -0,0 +1,3 @@
+# Test
+
+Test text.

mkdocs.yml

@@ -1 +1,48 @@
-site_name: My Docs
+site_name: Test MkDocs
+site_url: http://docs.weseng.de/test-mkdocs/
+repo_url: https://gitea.weseng.de/daniel/test-mkdocs/
+edit_uri: src/branch/main/docs/
+#site_description: null
+#site_author: null
+#copyright: null
+copyright: Copyright © 2026 Daniel Weschke.
+#copyright: Copyright &copy; 2026 Daniel Weschke, Maintained by the <a href="...">... Team</a>.
+
+docs_dir: docs
+site_dir: site
+
+theme:
+  #name: mkdocs
+  name: material
+  palette:
+    - media: "(prefers-color-scheme)"
+      toggle:
+        icon: material/link
+        name: Switch to light mode
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/toggle-switch
+        name: Switch to dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: black
+      accent: indigo
+      toggle:
+        icon: material/toggle-switch-off
+        name: Switch to system preference
+
+markdown_extensions:
+  def_list: {}
+  toc:
+    permalink: true
+    # permalink: 
+    separator: "-"
+  admonition: {}
+
+# auto-nav
+#nav:
+#  - Home: index.md
+