diff --git a/.gitignore b/.gitignore index e7d42ba..c82041c 100644 --- a/.gitignore +++ b/.gitignore @@ -17,3 +17,4 @@ reports/ # OS .DS_Store Thumbs.db +site/ diff --git a/docker-compose.yml b/docker-compose.yml index b02fce5..ff90e52 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -23,6 +23,26 @@ services: networks: - collaboration_collaboration + # Doku-Hosting via caddy-gitea-pages (#62 Phase 2). + # Liest automatisch aus dem gh-pages-Branch. mkdocs build → git push + # origin gh-pages → Seite live unter docs.gwoe.toppyr.de. + gwoe-docs: + image: ghcr.io/d7z-project/caddy-gitea-pages:nightly + container_name: gwoe-docs + restart: unless-stopped + environment: + - GITEA_SERVER=https://repo.toppyr.de + - GITEA_TOKEN=${GITEA_TOKEN} + labels: + - "traefik.enable=true" + - "traefik.http.routers.gwoe-docs.rule=Host(`docs.gwoe.toppyr.de`)" + - "traefik.http.routers.gwoe-docs.entrypoints=websecure" + - "traefik.http.routers.gwoe-docs.tls=true" + - "traefik.http.routers.gwoe-docs.tls.certresolver=letsencrypt" + - "traefik.http.services.gwoe-docs.loadbalancer.server.port=80" + networks: + - collaboration_collaboration + networks: collaboration_collaboration: external: true diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..0b5501d --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,35 @@ +site_name: GWÖ-Antragsprüfer Docs +site_url: https://docs.gwoe.toppyr.de +repo_url: https://repo.toppyr.de/tobias/gwoe-antragspruefer +repo_name: tobias/gwoe-antragspruefer + +theme: + name: material + language: de + palette: + primary: teal + accent: light green + features: + - navigation.sections + - navigation.expand + - search.highlight + +nav: + - Start: index.md + - Architecture Decision Records: + - Übersicht: adr/index.md + - "0001 LLM-Citation-Binding": adr/0001-llm-citation-binding.md + - "0002 Adapter-Architektur": adr/0002-adapter-architecture.md + - "0003 Citation-Property-Tests": adr/0003-citation-property-tests.md + - "0004 Deployment-Workflow": adr/0004-deployment-workflow.md + - Archiv: + - Übersicht: archive/index.md + +markdown_extensions: + - tables + - admonition + - pymdownx.highlight + - pymdownx.superfences + - pymdownx.details + - toc: + permalink: true