Files
karatewiki/README.md
T
2026-10-24 18:14:09 +02:00

58 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Karate-Wiki (Goju-Kai Dojo) – Infrastruktur & Eigene Erweiterungen
Dieses Repository enthält **ausschließlich** die Konfiguration, das Docker-Setup und unsere selbst entwickelten Erweiterungen für das Karate-Wiki (`https://www.gojukai-dojo.de`).
Der MediaWiki-Core (~20.000 Dateien), Passwörter (`.env`) und die Mediendateien (`images/`, ca. 8,3 GB Videos) werden bewusst **nicht** im Git gespeichert.
> 📖 **Vollständige Projektdokumentation (für nahtloses Weiterarbeiten auf jedem Rechner):**
> * **[`docs/ARCHITECTURE_AND_STATUS.md`](docs/ARCHITECTURE_AND_STATUS.md)** – Ist-Analyse (Strato), Architektur-Entscheidungen, alle Einstellungen & aktueller Arbeitsstand / Roadmap
> * **[`docs/DEPLOYMENT.md`](docs/DEPLOYMENT.md)** – Gitea Runner CI/CD auf dem Raspberry Pi 5 (`192.168.2.49`), Ports (`3093` Dev / `3008` Prod) & Datenbank-Sync
> * **[`AGENTS.md`](AGENTS.md)** – Einstiegspunkt und Sicherheitsregeln für Coding Agents
---
## 📁 Verzeichnisstruktur
```text
C:\dev\Karatewiki\
├── .gitea/workflows/ # Automatische Deployments auf den Raspberry Pi 5 (develop & main)
├── assets/
│ └── logo_goju-kai_Bleistift.png # Vereinslogo
├── config/
│ ├── LocalSettings.php # Bereinigte Wiki-Konfiguration (für Docker UND Strato nutzbar)
│ └── php-uploads.ini # Erhöht Upload-Limit auf 500 MB für Karate-Videos
├── docs/
│ ├── ARCHITECTURE_AND_STATUS.md # Umfassende Analyse-, Entscheidungs- & Status-Dokumentation
│ └── DEPLOYMENT.md # Deployment-Architektur & Port-Übersicht auf dem Pi 5
├── extensions-custom/
│ └── KarateMedia/ # Eigene HTML5-Video-Extension (inkl. Zeitlupe 0.5x/0.25x & Loop)
├── scripts/
│ ├── ensure-db-schema.php # Initialisiert DB-Schema bei leeren Erst-Installationen
│ ├── sync-from-strato.ps1 # Holt DB-Dump (rein lesend) unter Windows
│ └── sync-from-strato.sh # Holt DB-Dump & Videos (per rsync) unter Linux
├── .env.example # Vorlage für Datenbank-Zugangsdaten & Keys
├── .gitignore # Schützt Passwörter (.env), DB-Dumps & Videos vor Git-Upload
├── AGENTS.md # Leitfaden für Coding Agents beim Rechnerwechsel
├── Dockerfile # Baut MediaWiki 1.43 LTS (PHP 8.3/8.4) + KarateMedia Extension
├── docker-compose.dev-env.yml # Development-Stack auf dem Pi 5 (Port 3093)
└── docker-compose.yml # Production-/Standby-Stack auf dem Pi 5 (Port 3008)
```
---
## 🥋 Die eigene Extension: `KarateMedia`
Im bisherigen Produktiv-Wiki waren zwei veraltete Plugins gleichzeitig aktiv (`Html5mediator` und `EmbedVideo v2.9.0`), die unter PHP 8.3/8.4 und neuen MediaWiki-Versionen Fehler verursachen.
Unsere eigene Extension **`KarateMedia`** ([`extension.json`](extensions-custom/KarateMedia/extension.json)) ersetzt **beide** komplett wartungsfrei:
1. **Abwärtskompatibel für alle 87 Seiten mit `<html5media>`:**
```xml
<html5media height="200">File:SeienchinOsaeUke.mp4</html5media>
```
2. **Abwärtskompatibel für alle ~71 Seiten mit Standard-Datei-Links:**
```wikitext
[[Datei:Seienchin2.mp4|mini|Seienchin von vorne]]
[[File:Shisoshin_Funsako_Sensei.mp4|300x169px]]
```
3. **Trainings-Features direkt integriert:**
Unter jedem Video befindet sich eine kompakte Steuerleiste mit **`1x` | `0.5x` | `0.25x` | `Loop`**, um Kata- und Bunkai-Sequenzen direkt in Zeitlupe oder Endlosschleife zu studieren.