#62 Phase 2: Pivot nginx + docs.toppyr.de/gwoe-antragspruefer/

caddy-gitea-pages verworfen — dessen URL-Schema ({owner}.{domain}/{repo})
passt nicht für Single-Project-Hosting ohne DNS-Wildcards auf Sub-Sub-
Domains. Stattdessen simples nginx:alpine mit statischem Volume-Mount.

URL: https://docs.toppyr.de/gwoe-antragspruefer/

Der nginx-Container mounted docs-site/ nach
/usr/share/nginx/html/gwoe-antragspruefer/ — Traefik routet alles auf
Host docs.toppyr.de an den Container, nginx served den Pfad 1:1.
Skaliert für weitere Repos: einfach ein zweites Volume-Mount für
/usr/share/nginx/html/anderes-repo/ einrichten.

SSL: Traefik, nicht nginx/caddy.
DNS: *.toppyr.de Wildcard deckt docs.toppyr.de ab.

Update-Workflow:
  cd webapp && mkdocs build
  scp -r site/* vserver:/opt/gwoe-antragspruefer/docs-site/

Caddyfile.docs entfernt (war caddy-gitea-pages-spezifisch).

Refs: #62

Caddyfile.docs

@@ -1,14 +0,0 @@
-# caddy-gitea-pages: Serve mkdocs output from gh-pages branch.
-# SSL wird von Traefik terminiert, Caddy hört nur auf HTTP :80.
-:80 {
-	gitea {
-		server {$GITEA_SERVER}
-		token  {$GITEA_TOKEN}
-		domain gwoe-docs.toppyr.de
-		# Default-Repo für Requests ohne Owner/Repo im Pfad:
-		# Alle Requests auf / gehen an tobias/gwoe-antragspruefer gh-pages.
-		default_owner tobias
-		default_repo  gwoe-antragspruefer
-		default_branch gh-pages
-	}
-}

docker-compose.yml

@@ -23,21 +23,18 @@ services:
     networks:
       - collaboration_collaboration
 
-  # Doku-Hosting via caddy-gitea-pages (#62 Phase 2).
+  # Doku-Hosting (#62 Phase 2): mkdocs-Output als statische Site.
-  # Liest automatisch aus dem gh-pages-Branch. mkdocs build → git push
+  # URL: https://docs.toppyr.de/gwoe-antragspruefer/
-  # origin gh-pages → Seite live unter gwoe-docs.toppyr.de.
+  # Update: mkdocs build && scp -r site/* vserver:/opt/gwoe-antragspruefer/docs-site/
   gwoe-docs:
-    image: ghcr.io/d7z-project/caddy-gitea-pages:nightly
+    image: nginx:alpine
     container_name: gwoe-docs
     restart: unless-stopped
-    environment:
-      - GITEA_SERVER=https://repo.toppyr.de
-      - GITEA_TOKEN=${GITEA_TOKEN}
     volumes:
-      - ./Caddyfile.docs:/etc/caddy/Caddyfile:ro
+      - ./docs-site:/usr/share/nginx/html/gwoe-antragspruefer:ro
     labels:
       - "traefik.enable=true"
-      - "traefik.http.routers.gwoe-docs.rule=Host(`gwoe-docs.toppyr.de`)"
+      - "traefik.http.routers.gwoe-docs.rule=Host(`docs.toppyr.de`)"
       - "traefik.http.routers.gwoe-docs.entrypoints=websecure"
       - "traefik.http.routers.gwoe-docs.tls=true"
       - "traefik.http.routers.gwoe-docs.tls.certresolver=letsencrypt"

mkdocs.yml

@@ -1,5 +1,5 @@
 site_name: GWÖ-Antragsprüfer Docs
-site_url: https://gwoe-docs.toppyr.de
+site_url: https://docs.toppyr.de/gwoe-antragspruefer/
 repo_url: https://repo.toppyr.de/tobias/gwoe-antragspruefer
 repo_name: tobias/gwoe-antragspruefer