58 lines
3.5 KiB
Markdown
58 lines
3.5 KiB
Markdown
# 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.
|