# Install Instructions

```
$ sudo docker-compose up -d
```

## CI/CD

Dieses Repo nutzt **Woodpecker CI** (via `.woodpecker.yml`) für automatische Docker-Builds.

| Event | Aktion |
|---|---|
| Push auf `main` | Build + Push → `192.168.178.6:8083/cschulz/rd13_media_wiki:latest` |
| Pull Request auf `main` | Build only (dry-run, kein Push) |

**Forgejo Actions ist deaktiviert** (`[actions] ENABLED = false` in `app.ini`).  
Der "waiting"-Status im Forgejo-Actions-Tab kann ignoriert werden – Woodpecker übernimmt alle CI-Aufgaben.

Benötigte Woodpecker-Secrets:
- `RD13_MW_DOCKER_BUILD_TOKEN` – Forgejo Access Token mit `write:packages` Scope

## Setup and use our own Tile Server
This is needed to use maps in extensions.

Dieses Repo ist auf einen externen Martin Tile Server ausgelegt.

### Voraussetzung
- Martin ist erreichbar (z. B. https://tiles.rd13server.de)
- tileserver-gl liefert gerenderte Raster-Styles unter /styles/<style_id>
- Der Proxy routet /styles/osm-intl, /styles/world, /styles/europa-detail und /styles/satelite-world an tileserver-gl.

### LocalSettings Konfiguration
In LocalSettings.php:

```php
wfLoadExtension( 'Kartographer' );
$wgKartographerMapServer = 'https://tiles.rd13server.de/styles';
$wgKartographerStyles = [
	'world',
	'europa-detail',
	'satelite-world',
	'osm-intl',
];
$wgKartographerDfltStyle = 'world';
$wgKartographerSrcsetScales = [ 1 ];
```

Kartographer baut daraus URLs wie `https://tiles.rd13server.de/styles/world/{z}/{x}/{y}.png`.

Beispiel fuer einen anderen Stil auf derselben Seite:

```wiki
<mapframe mapstyle="europa-detail" text="Detailkarte" zoom="12" latitude="48.137" longitude="11.576" width="420" height="300" />
```

### Schnelltest im Wiki
```wiki
<mapframe text="Muenchen" zoom="12" latitude="48.137" longitude="11.576" width="420" height="300" />
```

# Update of Media Wiki

## Update of the MediaWiki Core

Um ein neues Docker-Image mit der neusten Version zu bauen, kann man entweder einen neuen Commit auf `main` pushen (Woodpecker CI baut und pushed das Image automatisch), oder den Build-Workflow händisch in Woodpecker über die UI auslösen.

Nach dem das neue Images gebaut ist, kann es mit gepulled und gestartet werden.
Hierfür kann man folgende Kommandos nehmen.

```
$ sudo docker-compose down
$ sudo docker-compose pull
$ sudo docker-compose up -d
```

Tried to update to 1.39 from 1.35.5 did not work. Maybe a step by step update is needed now from 1.35.9

## Update of Plugins

This is in the best case done with composer.

### How to bring Plugins into the composer workflow