Erstellen einer MediaWiki-Website

MediaWiki

Freie Wiki-Software

Entwickler:

Wikimedia Foundation

Typ:

Wiki-Engine

Erstveröffentlichung:

25. Januar 2002

Programmiersprache:

PHP, JavaScript

Betriebssystem:

plattformübergreifend

Aktuelle Version:

aktuelle stabile Version

Bewertung:

Website:

www.mediawiki.org

MediaWiki ist eine freie Wiki-Software, mit der man eine Enzyklopädie, ein Nachschlagewerk, eine interne Wissensdatenbank, ein Online-Magazin oder eine thematische Website mit gemeinsamer Bearbeitung erstellen kann. Die Software selbst ist kostenlos, ein stabiler Betrieb erfordert jedoch eine saubere Serverkonfiguration, regelmäßige Updates, Backups und eine klare Rechteverwaltung.

Dieser Artikel beschreibt, wie man eine Website auf Basis von MediaWiki installiert, einrichtet und pflegt. Fragen, Ergänzungen und Hinweise zu MediaWiki können auf der Diskussionsseite hinterlassen werden.

Kurz über MediaWiki

MediaWiki ist freie Open-Source-Software, die hauptsächlich in PHP geschrieben ist. Sie implementiert eine hypertextuelle Wiki-Umgebung und wurde ursprünglich als Software für Wikipedia entwickelt. Heute wird MediaWiki von den Projekten der Wikimedia Foundation sowie von vielen unabhängigen Websites verwendet.

MediaWiki eignet sich besonders für artikelbasierte und informationsorientierte Websites, weil es Versionsgeschichte, Kategorien, Namensräume, Vorlagen, Datei-Uploads, Benutzerrechte und ein Erweiterungssystem unterstützt. Die Benutzeroberfläche ist in viele Sprachen übersetzt, weshalb sich MediaWiki auch für mehrsprachige Projekte eignet.

MediaWiki ist kein einfacher statischer Website-Baukasten. Es ist eine vollständige Wiki-Plattform für Projekte, deren Seiten im Laufe der Zeit ergänzt, verlinkt, kategorisiert und von mehreren Autoren verbessert werden.

Installation von MediaWiki

Vor der Installation sollte man festlegen, welche Art von Website entstehen soll: eine öffentliche Enzyklopädie, eine geschlossene Wissensdatenbank, ein mehrsprachiges Projekt, ein Dateispeicher oder ein kompaktes Nachschlagewerk. Davon hängen Benutzerrechte, Erweiterungen, Backup-Strategie und Anforderungen an das Hosting ab.

Für eine typische MediaWiki-Installation benötigt man Apache oder Nginx, PHP, eine Datenbank wie MariaDB/MySQL, PostgreSQL oder SQLite sowie Zugriff auf die Website-Dateien und die Datenbank. Vor der Installation sollten immer die aktuellen Anforderungen der gewählten MediaWiki-Version geprüft werden, da sich Anforderungen an PHP und PHP-Erweiterungen von Version zu Version ändern können.

Grundablauf der Installation:

1. die offiziellen Serveranforderungen prüfen;
2. eine stabile MediaWiki-Version von der offiziellen Download-Seite herunterladen;
3. eine Datenbank und einen Datenbankbenutzer anlegen;
4. die MediaWiki-Dateien per FTP/SFTP oder SSH auf den Server hochladen;
5. die Website im Browser öffnen und den Installationsassistenten starten;
6. die erzeugte Datei `LocalSettings.php` speichern und in das MediaWiki-Hauptverzeichnis hochladen;
7. Hauptseite, Anmeldung, Seitenerstellung und Datei-Upload testen.

Installation über den Web-Assistenten

Nach dem Hochladen der Dateien öffnet man die Domain der Website im Browser. Wenn MediaWiki noch nicht eingerichtet ist, erscheint ein Link zur Installation. Der Installationsassistent prüft die Umgebung, fragt die Sprache der Oberfläche ab, verbindet sich mit der Datenbank, legt den Namen der Website fest, erstellt das Administratorkonto und bietet grundlegende Einstellungen an.

Bei der Datenbankverbindung müssen Datenbanktyp, Datenbankname, Benutzer und Passwort angegeben werden. Diese Daten werden in der Regel vorher im Hosting-Panel, in phpMyAdmin oder über das Terminal erstellt. Wenn der Assistent einen Verbindungsfehler meldet, liegt das meist an einem falschen Datenbanknamen, fehlenden Rechten des Benutzers, einem falschen Datenbankhost oder einer fehlenden PHP-Erweiterung.

Nach Abschluss der Installation bietet MediaWiki den Download der Datei `LocalSettings.php` an. Das ist die wichtigste Konfigurationsdatei der Website: Dort stehen Datenbankverbindung, Website-Name, Skin, aktivierte Erweiterungen, Benutzerrechte und weitere Einstellungen. Die Datei muss in das Verzeichnis hochgeladen werden, in dem sich die Datei `index.php` von MediaWiki befindet. Nach der erfolgreichen Installation kann man mit dem Erstellen von Seiten und Artikeln beginnen.

Grundeinstellungen nach der Installation

Die wichtigsten Einstellungen der Website werden in `LocalSettings.php` festgelegt. Vor Änderungen an dieser Datei sollte eine Kopie erstellt werden, weil ein Fehler im PHP-Code die Website vorübergehend unbrauchbar machen kann.

Nach der Installation werden häufig folgende Punkte eingerichtet:

• Name der Website und öffentliche Adressen;
• Datei-Uploads und erlaubte Dateitypen;
• Rechte für anonyme und registrierte Benutzer;
• E-Mail-Versand;
• Standardskin;
• Kurz-URLs für Seiten;
• Caching und Leistung;
• Sicherung von Dateien und Datenbank.

Beispiel zum Aktivieren von Datei-Uploads:

$wgEnableUploads = true;

Beispiel für die Auswahl des Standardskins:

$wgDefaultSkin = "vector-2022";

MediaWiki-Skins

Ein Design heißt in MediaWiki Skin. Der moderne Standard ist Vector 2022. Außerdem werden Vector legacy, MonoBook, Timeless, MinervaNeue für die mobile Darstellung und weitere Skins verwendet.

Ein Skin wird normalerweise in den Ordner `skins` installiert und anschließend in `LocalSettings.php` geladen. Auf der Seite jedes Skins auf MediaWiki.org gibt es eigene Hinweise zur Installation und Kompatibilität.

Beispiel zum Laden eines Skins:

wfLoadSkin( 'Vector' );
$wgDefaultSkin = 'vector-2022';

Wenn ein Skin nicht angezeigt wird, sollte man den Ordnernamen, die Ladezeile, Dateirechte und die Kompatibilität mit der installierten MediaWiki-Version prüfen.

• 
  Vector 2022
• 
  Vector legacy
• 
  MonoBook
• 
  Modern
• 
  Cologne Blue

MediaWiki-Erweiterungen

Erweiterungen fügen MediaWiki neue Funktionen hinzu: visuelle Bearbeitung, Karten, Parserfunktionen, semantische Daten, Spamschutz, Dateiwerkzeuge, Formulare, Foren und viele weitere Möglichkeiten. Der Erweiterungskatalog ist auf der offiziellen MediaWiki-Website verfügbar.

Allgemeiner Ablauf zur Installation einer Erweiterung:

1. eine mit der eigenen MediaWiki-Version kompatible Version herunterladen;
2. den Ordner der Erweiterung in das Verzeichnis `extensions` hochladen;
3. die Ladezeile in `LocalSettings.php` einfügen;
4. falls erforderlich, ein Datenbank-Update ausführen;
5. die Seite `Special:Version` prüfen.

Typisches Ladebeispiel:

wfLoadExtension( 'ParserFunctions' );

Manche Erweiterungen benötigen zusätzliche Dienste, Composer-Abhängigkeiten oder eigene Rechte-Einstellungen. Deshalb sollte man die Dokumentation der jeweiligen Erweiterung lesen und nicht einfach Ladezeilen aus alten Anleitungen kopieren.

Kurz-URLs

Standardmäßig können MediaWiki-Seiten über Adressen wie `/index.php?title=Seitentitel` geöffnet werden. Für eine öffentliche Website sind meist kurze Adressen wie `/wiki/Seitentitel` praktischer. Die Einrichtung hängt vom Webserver ab und muss mit `$wgScriptPath` und `$wgArticlePath` in `LocalSettings.php` abgestimmt sein.

Beispiel in `LocalSettings.php`:

$wgScriptPath = "/w";
$wgArticlePath = "/wiki/$1";

Diese Einstellungen allein reichen nicht aus: Für Apache oder Nginx werden zusätzlich Weiterleitungs- beziehungsweise Rewrite-Regeln auf Ebene des Webservers benötigt. Bei einer neuen Website sollte das endgültige URL-Schema möglichst früh festgelegt werden, weil spätere Änderungen Weiterleitungen erfordern.

Aktualisierung von MediaWiki

MediaWiki sollte regelmäßig aktualisiert werden: Updates schließen Sicherheitslücken, beheben Fehler und verbessern die Kompatibilität mit modernen PHP-Versionen. Vor einem Update müssen die Anforderungen der neuen Version und die Kompatibilität der installierten Erweiterungen und Skins geprüft werden.

Mindestvorbereitung für ein sicheres Update:

• Backup der Datenbank erstellen;
• Backup der Dateien erstellen, besonders von `LocalSettings.php`, `images`, `extensions`, `skins` und eigenen Anpassungen;
• Anforderungen der neuen MediaWiki-Version prüfen;
• kompatible Versionen der Erweiterungen und Skins vorbereiten;
• das Update nach Möglichkeit zuerst auf einer Kopie der Website testen.

Aktualisierung über den Browser

MediaWiki unterstützt eine Aktualisierung über den Browser im Verzeichnis `mw-config`, aber dieser Weg sollte auf produktiven Websites vorsichtig genutzt werden. Er ist praktisch auf einfachem Hosting ohne SSH-Zugang, eignet sich jedoch schlechter für größere Projekte, weil der Vorgang durch PHP-Zeitlimits oder Speichermangel unterbrochen werden kann.

Wenn die Aktualisierung über den Browser genutzt wird, sollte vorher ein vollständiges Backup vorhanden sein und die Datenbankverbindung muss bekannt sein. Nach dem Update müssen Hauptseite, Anmeldung, Bearbeitung, Datei-Upload, `Special:Version` und wichtige Erweiterungen geprüft werden.

Aktualisierung über SSH

Mit SSH-Zugang ist es meist zuverlässiger, MediaWiki über das Terminal zu aktualisieren. Ein allgemeines Schema sieht so aus:

# in das Verzeichnis der Website wechseln
cd /pfad/zu/mediawiki

# Datenbank mit den Werkzeugen des DBMS sichern
mysqldump -u db_user -p db_name > backup.sql

# Dateien sichern
cd ..
tar -czf mediawiki-files-backup.tar.gz mediawiki

# neue MediaWiki-Version herunterladen und entpacken
wget https://releases.wikimedia.org/mediawiki/1.43/mediawiki-1.43.5.tar.gz
tar -xzf mediawiki-1.43.5.tar.gz

# LocalSettings.php, images und notwendige eigene Dateien übertragen
cp mediawiki/LocalSettings.php mediawiki-1.43.5/
rsync -a mediawiki/images/ mediawiki-1.43.5/images/

# nach Vorbereitung des neuen Verzeichnisses die Datenbank aktualisieren
cd mediawiki-1.43.5
php maintenance/run.php update

In älteren MediaWiki-Anleitungen wird häufig `php maintenance/update.php` verwendet; in neueren Versionen sollten Wartungsskripte bevorzugt über `maintenance/run.php` gestartet werden. Vor dem Ausführen der Befehle sollte man immer die Anleitung für die konkrete MediaWiki-Version prüfen.

Aktualisierung von Erweiterungen

Erweiterungen und Skins müssen zur MediaWiki-Version passen. Nach der Aktualisierung des Kerns sollten auch die Erweiterungen aktualisiert werden, sonst kann die Website instabil arbeiten oder interne Fehler anzeigen.

Wenn eine Erweiterung über Git installiert wurde, wird normalerweise der Zweig aktualisiert, der zur MediaWiki-Version passt. Wenn die Erweiterung als Archiv installiert wurde, lädt man ein neues kompatibles Archiv von der Erweiterungsseite herunter. Nach dem Aktualisieren von Erweiterungen muss häufig erneut ausgeführt werden:

php maintenance/run.php update

Zur Kontrolle öffnet man `Special:Version`. Dort sind die MediaWiki-Version, installierte Erweiterungen, Skins und grundlegende Informationen zur Umgebung sichtbar.

Hinweis des Autors

MediaWiki ist eine der bequemsten Plattformen für strukturierte Informationswebsites. Die Installation ist relativ einfach, aber ein stabiles Projekt braucht regelmäßige Pflege: Updates, Backups, Prüfung der Erweiterungen und Aufmerksamkeit für Benutzerrechte. Fragen zur Installation, Aktualisierung oder Nutzung von MediaWiki können auf der Diskussionsseite gestellt werden.

Siehe auch

• CSS