MediaWiki konfigurieren
Installation MediaWiki siehe MediaWiki installieren (Debian)
Einrichtung von ShortURLs
Gut funktionierender MediaWiki Short-URL Builder siehe shorturls.redworks.org.
Grundlagen
Typischerweise werden ShortURLs für die URL http://www.domain.tld/wiki verwendet.
mediaWiki wird typischerweise in http://www.domain.tld/w (bzw. /var/www/w/) installiert.
Manuelle Einrichtung
Anpassungen an .htaccess (für das Root-Verzeichnis des Webservers):
RewriteEngine On RewriteRule ^/?wiki(/.*)?$ %{DOCUMENT_ROOT}/w/index.php [L] RewriteRule ^/?$ %{DOCUMENT_ROOT}/w/index.php [L]
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d RewriteRule ^/?w/images/thumb/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/w/thumb.php?f=$1&width=$2 [L,QSA,B]
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d RewriteRule ^/?w/images/thumb/archive/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/w/thumb.php?f=$1&width=$2&archived=1 [L,QSA,B]
Anpassungen in der LocalSettings.php:
$wgScriptPath = "/w";
$wgScriptExtension = ".php";
$wgArticlePath = "/wiki/$1";
$wgEnableUploads = true;
$wgGenerateThumbnailOnParse = false;
Logo und Theme anpassen
Logo austauschen: Logodatei nach wiki/skins/common/images/wiki.png kopieren.
Startseite definieren: In MediaWiki:Mainpage die neue Startseite eintragen.
Navigationsleiste anpassen: MediaWiki:Sidebar
Links auf Datenschutz und Impressum aus dem Footer-Bereich entfernen:
In den Seiten MediaWiki:Privacy und MediaWiki:Disclaimer nur einen Bindestrich "-" eintragen.
Texte im Footer anpassen:
- Letzte Änderung: MediaWiki:Lastmodifiedat
- Anzahl Seitenabrufe: MediaWiki:Viewcount
Visual Editor
Voraussetzungen
- MediaWiki-Plugin Visual Editor
- Node.JS
- Parsoid
Installation
Konfiguration von MediaWiki anpassen durch aktivieren der Extension:
# nano /var/www/w/LocalSettings.php
Inhalt:
require_once "$IP/extensions/VisualEditor/VisualEditor.php"; // Enable by default for everybody $wgDefaultUserOptions['visualeditor-enable'] = 1; // Don't allow users to disable it $wgHiddenPrefs[] = 'visualeditor-enable'; // OPTIONAL: Enable VisualEditor's experimental code features #$wgDefaultUserOptions['visualeditor-enable-experimental'] = 1; $wgVirtualRestConfig['modules']['parsoid'] = array( // URL to the Parsoid instance // Use port 8142 if you use the Debian package 'url' => 'http://localhost:8142' # Hier kann der Localhost verwendet werden // Parsoid "domain", see below (optional) // 'domain' => 'localhost', // Parsoid "prefix", see below (optional) // 'prefix' => 'localhost' );
Konfiguration des Parsoid-Service:
# nano /etc/mediawiki/parsoid/settings.js
Inhalt:
'use strict';
exports.setup = function(parsoidConfig) {
parsoidConfig.setMwApi({ uri: 'https://domain.tld/w/api.php'}); # Hier muss eine von außen erreichbare Adresse stehen
parsoidConfig.useSelser = true;
};
Performance
Counter deaktivieren
nano /var/www/wiki/LocalSettings.php
Am Ende folgende Zeile hinzufügen:
$wgDisableCounters = true;
HTML-Cache aktivieren
Erstellt statische HTML-Dateien für Wiki-Seiten.
Dabei findet Caching von HTML-Seiten jedoch nur für nicht eingeloggte User statt.
File-Caching akivieren (Erstellung von statischen HTML-Dateien):
- Neues MediaWiki-Unterverzeichnis, z. B. "filecache" anlegen (Directory-Owner: www-data).
- LocalSettings.php erweitern um:
$wgUseFileCache = true; $wgFileCacheDirectory = "$IP/filecache"; $wgShowIPinHeader = false;
Syntaxhighlighting aktivieren
Folgende Zeile am Ende in LocalSettings.php einfügen:
MediaWiki ≤ 1.24
require_once "$IP/extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php";
MediaWiki ≥ 1.25
wfLoadExtension( 'SyntaxHighlight_GeSHi' );
Backups erstellen
SQL-Dump der Datenbank
Vgl. MariaDB (Debian)
XML-Dump der Seiten
sudo -u www-data php dumpBackup.php --full > /var/backups/<dumpfilename>.xml
