added quartz wiki

2025-11-29 03:01:04 +01:00
parent 989253c72f
commit 1063619fef
25 changed files with 1351 additions and 149 deletions
--- a/WIKI-SETUP.md
+++ b/WIKI-SETUP.md
@@ -0,0 +1,147 @@
+# Wiki Setup mit Obsidian Quartz
+
+## Übersicht
+
+Das Wiki wurde erfolgreich in die doing-it.de Website integriert. Es verwendet Obsidian Quartz als statischen Site-Generator und läuft als Docker-Container.
+
+## Struktur
+
+```
+doing-it.de/
+├── wiki-vault/              # Obsidian Vault mit Markdown-Dateien
+│   ├── Home.md
+│   ├── IT-Grundlagen.md
+│   ├── Schulungsmethoden.md
+│   └── Ressourcen.md
+├── quartz-setup/            # Quartz Docker Setup
+│   ├── Dockerfile
+│   ├── entrypoint.sh
+│   ├── package.json
+│   └── quartz.config.ts
+├── app/wiki/                # Next.js Wiki-Seite
+│   └── page.tsx
+└── docker-compose.yml       # Erweitert um Wiki-Service
+```
+
+## Was wurde implementiert
+
+### 1. Obsidian Vault (`wiki-vault/`)
+- Enthält Beispiel-Markdown-Dateien
+- Kann durch eigene Obsidian-Vault-Dateien ersetzt werden
+
+### 2. Quartz Docker Setup (`quartz-setup/`)
+- Dockerfile: Klont Quartz Repository und richtet es ein
+- entrypoint.sh: Baut die Quartz-Site und startet den Server
+- Fallback: Erstellt einfache statische Site, falls Quartz-Build fehlschlägt
+
+### 3. Docker Compose Service
+- Service `wiki` läuft auf Port 8080
+- Bindet `wiki-vault` als Volume ein
+- Build-Output in `quartz-setup/public`
+
+### 4. Next.js Integration
+- Neue Seite unter `/wiki`
+- Wiki-Link in Navigation (Desktop & Mobile)
+- Link zur Quartz-Instanz auf Port 8080
+
+## Testing & Debugging in PowerShell
+
+### 1. Docker Compose Validierung
+```powershell
+docker-compose config
+```
+
+### 2. Wiki-Service bauen
+```powershell
+docker-compose build wiki
+```
+
+### 3. Alle Services starten
+```powershell
+docker-compose up -d
+```
+
+### 4. Logs prüfen
+```powershell
+# Alle Logs
+docker-compose logs
+
+# Nur Wiki-Logs
+docker-compose logs wiki
+
+# Follow Logs (Live)
+docker-compose logs -f wiki
+```
+
+### 5. Container-Status prüfen
+```powershell
+docker-compose ps
+docker ps -a
+```
+
+### 6. In Container einsteigen (falls nötig)
+```powershell
+docker-compose exec wiki sh
+```
+
+### 7. Services stoppen
+```powershell
+docker-compose down
+```
+
+### 8. Alles neu bauen
+```powershell
+docker-compose down
+docker-compose build --no-cache
+docker-compose up -d
+```
+
+## Erwartete Ports
+
+- **Next.js Web**: http://localhost:3001
+- **Wiki (Quartz)**: http://localhost:8080
+
+## Häufige Probleme
+
+### Problem: Quartz Build schlägt fehl
+**Lösung**: Der Entrypoint-Script erstellt automatisch einen Fallback mit einfacher HTML-Seite. Die Markdown-Dateien werden trotzdem angezeigt.
+
+### Problem: Port 8080 bereits belegt
+**Lösung**: Port in `docker-compose.yml` ändern:
+```yaml
+ports:
+  - "8081:8080"  # Ändere 8081 zu gewünschtem Port
+```
+
+### Problem: Container startet nicht
+**Lösung**: 
+1. Logs prüfen: `docker-compose logs wiki`
+2. Container neu bauen: `docker-compose build --no-cache wiki`
+3. Container-Status: `docker ps -a`
+
+### Problem: Keine Inhalte im Wiki
+**Lösung**: 
+1. Prüfen ob `wiki-vault` Dateien enthält
+2. Volume-Mount prüfen: `docker-compose exec wiki ls -la /app/content`
+3. Container neu starten: `docker-compose restart wiki`
+
+## Wiki-Inhalte aktualisieren
+
+1. Markdown-Dateien in `wiki-vault/` bearbeiten oder hinzufügen
+2. Container neu starten: `docker-compose restart wiki`
+3. Oder für kompletten Rebuild: `docker-compose up -d --build wiki`
+
+## Navigation
+
+Der Wiki-Link wurde zur Navigation hinzugefügt:
+- Desktop: Zwischen "Über uns" und "Kontakt"
+- Mobile: Im Hamburger-Menü
+
+Die Wiki-Seite (`/wiki`) zeigt einen Link zur Quartz-Instanz, der in einem neuen Tab geöffnet wird.
+
+## Nächste Schritte
+
+1. Eigene Obsidian-Vault-Dateien in `wiki-vault/` kopieren
+2. Quartz-Konfiguration in `quartz-setup/quartz.config.ts` anpassen
+3. Wiki-Styling an Website-Design anpassen (falls gewünscht)
+