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.

Navigation

Startseite definieren: In MediaWiki:Mainpage die neue Startseite eintragen.

Navigationsleiste anpassen: MediaWiki:Sidebar

Footer

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