Aus Ubuntu-Forum Wiki

Aktuelle Version vom 10. April 2012, 16:49 Uhr

1 Allgemeines

MediaWiki ist ein Open Source-Softwarepaket, welches dafür genutzt wird, ein eigenes Wikisystem zu installieren. Es basiert auf der gleichen Technologie, die auch von Wikipedia genutzt wird.

Die Software wird in einem dreimonatigen Releasezyklus veröffentlicht. Sie kann in ihrer Funktionalität durch Erweiterungen, den sogenannten Extensions, vielseitig erweitert werden.

2 Voraussetzungen

Zum Betrieb der Software benötigt man einen funktionierenden Webserver mit PHP und einer Datenbank, also in der Regel ein LAMPP-System. Zusätzlich benötigt man Zugriff auf den Server, um Daten auf ihn laden zu können. Dies geschieht in der Regel mit Hilfe eines FTP- oder SSH-Servers und einem entsprechenden Client auf dem lokalen Rechner.

2.1 Vorbereiten des Webservers

2.1.1 Alias setzen

Einen Alias muss man nur nutzen, wenn das Wiki nur ein Teil der Webpräsenz darstellen soll. MediaWiki kann aber auch direkt im DocumentRoot des Webservers installiert werden. Dann entfällt der folgende Schritt.

Durch einen Alias hat man den Vorteil, dass man nicht den kompletten Pfad zur MediaWiki-Installation eingeben muss. Man ersetzt diese mit einem Alias, der folgendermaßen konfiguriert wird. Dies muss mit Root-Berechtigung in einem Texteditor erfolgen:

sudo nano /etc/apache2/sites-available/default 

Dort wird dieser Abschnitt eingefügt:

Alias /wiki "/pfad/zum/wiki/"
<Directory "/pfad/zum/wiki/">
        Options Indexes MultiViews
        AllowOverride None
        Order allow,deny
        Allow from all
</Directory>

Es bietet sich an, MediaWiki in ein entsprechendes Unterverzeichnis im DocumentRoot zu installieren.

• mehr Informationen zu LAMPP

2.1.2 Datenbank anlegen

Zur Speicherung der Daten benötigt MediaWiki eine Datenbank. Es bietet sich dabei an, eine Datenbank mit entsprechendem Benutzer anzulegen. Es können aber auch schon bestehende Datenbankbenutzer genutzt werden. Komfortabler kann die Verwaltung mit Hilfe des Tools phpMyAdmin vorgenommen werden.

Wiki-Datenbank und -Benutzer anlegen

CREATE USER 'wiki'@'localhost' IDENTIFIED BY 'db_passwort';
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, FILE, INDEX,
ALTER ON * . * TO 'wiki'@'localhost' IDENTIFIED BY 'db_passwort' 
WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0 ;
 
CREATE DATABASE IF NOT EXISTS `wiki` ;
 
GRANT ALL PRIVILEGES ON `wiki` . * TO 'wiki'@'localhost';

3 Installation

3.1 Paketquellen

Obwohl MediaWiki auch in den Paketquellen von Ubuntu verfügbar ist und mit folgendem Befehl installiert werden kann, sollte diese Methode nicht genutzt werden. Die Quellen beinhalten eine ältere Version von Mediawiki, ob sie mit dem vierteljährlichen Updates Schritt halten werden, ist fraglich. Außerdem handelt es sich in diesem Fall, ähnlich zu Wordpress, nicht um ein Programm, sondern um ein CMS (Content Management System), also eine Art serverseitige Lösung.

sudo apt-get install mediawiki

3.2 Manuelle Installation

Zunächst muss das MediaWiki-Paket von der Projektseite heruntergeladen und im Anschluss entpackt werden.

cd /pfad/zum/downloadverzeichnis
tar xfvz /mediawiki-version.tar.gz

Danach wird der Inhalt dieses mediawiki-Verzeichnisses in das dafür bestimmte Verzeichnis auf dem Webserver kopiert. Anschließend muss das Unterverzeichnis config für den Webserver schreibbar gemacht werden. Je nach Zugriffsart kann man dies im Terminal mit folgendem Befehl realisieren:

chmod a+w config

Nutzt man einen FTP-Client wie Filezilla, können die entsprechenden Rechte auch mit ihm gesetzt werden.

4 Konfiguration

Ist die Software installiert, muss das Wiki im nächsten Schritt konfiguriert werden.

Dazu ruft man den entsprechenden URL für die Wiki-Startseite im Browser auf, z.B. http://localhost/wiki . Im weiteren Verlauf folgt man einfach den Anweisungen im Browser und trägt die verlangten Werte in die Felder ein.

Erklärung

* nicht erwähnte Werte brauchen nicht geändert werden

Sollten Fehler auftreten, meldet MediaWiki dies. Außerdem bietet es auch Lösungsansätze an. Nach Abschluss der Konfiguration werden die Werte im Wiki-Unterverzeichnis config in der Datei LocalSettings.php gespeichert. Diese Datei muss ins Wiki-Hauptverzeichnis kopiert werden. Zum Testen der Installation ruft man einfach erneut die Wiki-Startseite auf.

Erscheint die, etwas karge, Willkommensseite, kann man zur Sicherheit das config-Verzeichnis löschen. Das weitere Feintuning des Wikis findet in der LocalSettings.php statt. Dort können Funktionen, Berechtigungen etc. eingestellt werden.

4.1 LocalSettings.php

Werte ändern

# Uploads erlauben
$wgEnableUploads  = true;
 
# Wiki-Logo
$wgLogo= "/pfad/zum/bild.png";
 
# Favicon für die Adresszeile des Browsers
$wgFavicon= "/pfad/zum/favicon.ico";
 
# Standard-Skin für das Wiki definieren
$wgDefaultSkin = 'monobook';
 
# Überschriften immer nummerieren
$wgDefaultUserOptions['numberheadings']= 1;
 
# Benutzer muss angegebene E-Mail-Adresse erst bestätigen, bevor er Artikel schreiben/ändern darf
$wgEmailConfirmToEdit="true";
 
# Notfall-Adresse, z.B. vom Administrator
$wgEmergencyContact="e-mail-adresse";

4.2 Optische Änderungen

Die Darstellung der Inhalte werden in MediaWiki durch Skins (oder auch Themes) festgelegt. Das bekannteste und verbreitetste Skin, welches auch als Standard eingesetzt wird, nennt sich MonoBooK. Systemweit legt man ein Theme mit der Variablen $wgDefaultSkin in der LocalSettings.php fest.

Die Optik eines jeden Themes wiederum wird durch StyleSheets bestimmt. Die dafür verantwortliche Datei main.css findet man im Wiki-Unterverzeichnis skins/skin_name.

4.2.1 Navigation anpassen

Um die Navigation auf der linken Seite nach seinen persönlichen Vorstellungen zu gestalten, muss man die folgende Seite im Wiki aufrufen http://localhost/wiki/index.php?title=MediaWiki:Sidebar. Die Bearbeitung dieser Seite schlägt sich nach dem Speichern in der Navigation nieder. Das Ganze wird mit unsortierten Listen realisiert. Dabei wird der erste Listenpunkt als Überschrift gesetzt und die Verschachtelung als Navigations-Punkte.

Beispiel Wiki-Eintrag

* Wiki

** portal-url|Inhaltsverzeichnis

** Kategorie:Begriffserklärung|Begriffserklärungen

** Spezial:Kategorien|Kategorien

** Spezial:Letzte_Änderungen|Letzte Änderungen

Suche

Um das Feld für die Suche zu platzieren, setzt man den folgenden Code an die gewünschte Stelle:

* SEARCH

Diese Möglichkeit wurde allerdings erst ab Version 1.13 eingeführt.

4.3 Registrierungsseite ändern

Um Hinweise für die Registrierung unterzubringen, muss die Datei Userlogin.php im Wiki-Verzeichnis /includes/templates/ unter im Formular name="userlogin2" eingetragen werden. Diese Änderungen setzen allerdings Programmierkenntnisse in PHP und HTML voraus.

5 Backup

Um eine vollständige Sicherung durchzuführen, müssen folgende Schritte abgearbeitet werden:

1. Sichern des kompletten MediaWiki-Verzeichnisses
2. Sichern der MediaWiki-Datenbank (siehe Bigdump)

Für die Sicherung der Datenbank empfiehlt sich das Werkzeug phpMyAdmin.

6 Aktualisierung

MediaWiki lässt sich auf verschiedenen Wegen aktualisieren. Am komfortabelsten lässt sich ein Update durchführen, wenn man per (SSH-) Terminal Zugriff auf den Server hat. Eine genaue Anleitung zu diesem Verfahren bietet die MediaWiki-Projektseite. Leider ist dies aber nicht immer möglich, weil zum Beispiel der Webhoster diesen Zugriff aus Sicherheitsgründen nicht gestattet. In solchen Fällen muss man die Installationsroutine wiederholen.

Dazu lädt man sich zunächst die neue Version herunter und entpackt diese.

Danach benennt man die Datei LocalSettings.php auf dem Server in 'LocalSettings.php_backup um. Dies ist notwendig, um sie vor einem versehentlichen Überschreiben zu schützen, da sie nach der Aktualisierung weiterverwendet wird. Ist dies erledigt, kopiert man den Inhalt des entpackten Verzeichnisses auf den Webserver und lässt ältere Dateien einfach überschreiben.

Anschließend macht man das Unterverzeichnis config wieder schreibbar. Wurde das Unterverzeichnis nicht wie oben vorgeschlagen nach in der Installation gelöscht, muss man darauf achten, dass es keine LocalSettings.php. enthält. Ist dies dennoch der Fall, muss die Datei gelöscht werden. Der Installer nimmt sonst an, dass die Konfiguration bereits abgeschlossen ist. Das hat dann zur Folge, dass MediaWiki nicht komplett und vollständig aktualisiert wird, obwohl die aktuellere Version angezeigt wird. Eine Anpassung der Datenbank etwa bleibt aus. Später kann es dann zu unvorhersehbaren Fehlern kommen.

Nach dem Kopieren der Daten ruft man dann das Wiki im Browser auf und folgt den Anweisungen im Browser. Dabei ist es wichtig, dass die eingegebenen Daten mit denen übereinstimmen, die man zur Erstinstallation verwendetet hat. Zur Not kann man die Werte auch aus der zuvor umbenannten LocalSettings.php_backup entnehmen.

Ist die Installation abgeschlossen, kann man die LocalSettins.php_backup-Datei aus dem Wiki-Hauptverzeichnis wieder zurück in LocalSettings.php. benennen. Der Ordner config kann gelöscht werden.

Wurden Änderungen am Skin oder anderen Dateien vorgenommen, muss noch der entsprechende Ordner oder die Datei aus der Sicherung auf den Server kopiert werden.

7 Links

• LAMPP
• Mediawiki-Projektseite