doing-it-website/WIKI-SETUP.md

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

docker-compose config

2. Wiki-Service bauen

docker-compose build wiki

3. Alle Services starten

docker-compose up -d

4. Logs prüfen

# 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

docker-compose ps
docker ps -a

6. In Container einsteigen (falls nötig)

docker-compose exec wiki sh

7. Services stoppen

docker-compose down

8. Alles neu bauen

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:

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)