Files
karatewiki/README.md
T

65 lines
3.0 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.
---
## 📁 Verzeichnisstruktur
```text
C:\dev\Karatewiki\
├── .env.example # Vorlage für Datenbank-Zugangsdaten & Keys (nach .env kopieren)
├── .gitignore # Schützt Passwörter (.env), DB-Dumps & Videos vor Git-Upload
├── Dockerfile # Baut MediaWiki 1.43 LTS (PHP 8.3/8.4) + KarateMedia Extension
├── docker-compose.yml # Startet MediaWiki + MariaDB 10.11
├── 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
├── extensions-custom/
│ └── KarateMedia/ # Eigene HTML5-Video-Extension (inkl. Zeitlupe 0.5x/0.25x & Loop)
└── scripts/
├── sync-from-strato.ps1 # Holt DB-Dump (rein lesend) unter Windows
└── sync-from-strato.sh # Holt DB-Dump & Videos (per rsync) unter Linux
```
---
## 🥋 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.
---
## 🚀 Schnellstart (Docker-Umgebung / Failover-Server)
1. **`.env` anlegen:**
Kopiere `.env.example` nach `.env` und trage die gewünschten Passwörter ein.
2. **Datenbank-Dump von Strato holen (rein lesend):**
* Windows: `.\scripts\sync-from-strato.ps1`
* Linux: `./scripts/sync-from-strato.sh`
3. **Container starten:**
```bash
docker compose up -d --build
```
4. **Datenbank-Schema auf die neue MediaWiki-Version aktualisieren (im Container):**
```bash
docker compose exec mediawiki php maintenance/run.php update --quick
```
Danach ist das Wiki unter `http://localhost:8080` erreichbar!