fix: update workflow to handle Obsidian vault structure for MkDocs

- Remove docs_dir from mkdocs.yml
- Add step to copy files to docs directory during build
- This works around MkDocs limitation with root-level documentation

Author: jonathanirvin-ast

.github/workflows/deploy.yml

@@ -50,6 +50,14 @@ jobs:
       - name: Install project
         run: poetry install --no-interaction --no-root
 
+      - name: Prepare docs directory
+        run: |
+          mkdir -p docs
+          # Copy all markdown files and directories except hidden ones
+          find . -maxdepth 1 \( -type f -name "*.md" -o -type d ! -name ".*" ! -name "docs" ! -name "site" ! -name "overrides" \) -exec cp -r {} docs/ \;
+          # Copy the overrides directory to the root where mkdocs.yml expects it
+          cp -r overrides .
+
       - name: Build site
         run: poetry run mkdocs build
 

mkdocs.yml

@@ -4,7 +4,6 @@ site_url: https://offendingcommit.github.io/valdris/
 repo_url: https://github.com/offendingcommit/valdris
 repo_name: offendingcommit/valdris
 edit_uri: edit/main/
-docs_dir: .
 
 theme:
   name: material