Was ist MediaWiki?

MediaWiki ist eine freie php- und MySQL-basierte Wiki-Engine, die z.B. von der freien Enzyklopädie Wikipedia benutzt und weiterentwickelt wird.

Installation

Installiere Dir Deine eigene MediaWiki-Version. (Dies ist eine Installations-Anleitung, die einiges an Fachwissen voraussetzt)

Voraussetzungen

Folgende Komponente müssen bereits installiert sein:

• Zwingend:
  • Apache
  • PHP: ab MediaWiki-Version 1.7x ist PHP5 unbedingt notwendig. Wer nur auf PHP4 zurückgreifen kann, sollte Version 1.6x installieren.
  • MySQL
• Optional:
  • phpMyAdmin zur besseren MySQL-Konfiguration

Quelle downloaden

Den Quellcode findest Du auf http://sourceforge.net/projects/wikipedia

Installieren

Einfach den Ordner entpacken und dem Webserver hinzufügen. Erstelle nun eine MySQL-Datenbank die (beispielsweise) MyWiki heisst, und einen MySQL-User, der (beispielsweise) wikibuttler heisst, und volle (auch grant) Rechte auf die Datenbank MyWiki hat.

Gehe per Terminal in das entpackte MediaWikiVerzeichnis, und gib dort ein:

Öffne nun die MediaWiki/config/index.php mit Deinem Browser, und befolge die weiteren Anweisungen. Die restliche Installation läuft bequem und inforeich über die Webseite.

Fertig... fast... Nach Beendigung der Webseiten-Schritte musst Du die Datei LocalSettings.php aus dem Verzeichnis config ins MediaWiki-Hauptverzeichnis verschieben.

Das war`s aber...

... außer man weiß überhaupt nicht, von welchem Betriebssystem hier die Rede ist... oder man blutiger Anfänger ist, da muss man dann auch rumprobieren, wie man denn etwas dem "Webserver hinzufügt"

Konfiguration

Upload aktivieren

Damit die User Bilder uploaden können öffne mit einem Editor im WikiMedia-Hauptverzeichnis die Datei LocalSettings.php

• Suche die Stelle # $wgEnableUploads = true; und entferne die #
• Stelle sicher, dass in das Verzeichnis images geschrieben werden darf

ImageMagick verwenden

Wenn Du ImageMagick installiert hast, kannst Du's über die upload-Datei laufen lassen:

• xampp-win32-1.4.14-installer
• mediawiki-1.5beta3 installiert auf dem Server
• ImageMagick-5.5.7-Q16-windows-dll.exe installiert auf dem Server (mit der aktuellen Distribution klappt es z.B. nicht)
• Localsettings.php

Frage: Welchen Vorteil hat es, wenn ich ImageMagick verwende? Grüße Thomas

 $wgEnableUploads		= true;
 $wgUseImageResize		= true;
 $wgUseImageMagick = true;
 $wgImageMagickConvertCommand = "convert"; #<- das stand vorher anders da

:Vermutlich kann man den Convert Befehl deshalb so angeben, weil es ja im Path drin steht.

• php.ini

 ;extension=php_imagick.dll #<- das Semikolon entfernen

(Wie wird das Commando umgesetzt ?!)
$wgUseImageResize sorgt dafür, das die Bilder im Wiki skaliert oder als Thumbnails dargestellt werden können.

Andere Dateitypen

Um andere Dateitypen, wie ZIP oder PDF, im Wiki hinterlegen zu können, muss man noch mal die DefaultSettings.php editieren:

• Suche nach der Stelle $wgFileExtensions
• Füge der Klammer die gewünschten Dateitypen hinzu, z.B.:

 $wgFileExtensions = array('png','gif','jpg','jpeg','zip','pdf');

(BTW: weiß jemand, wie man ihn dazu bringt auch *.tar.gz zu akzeptieren? Klappt hier nämlich als einziges nicht) Die Fileextension gz ist die Suffix. tar steht vor der Suffix und gehört deshalb nicht dazu. : Kannst Du nicht einfach nur ".gz" angeben? Schließlich ist es ja nur ein .tar file, das gzipped wurde. Ggf könnte man sie auch in ".gz" umbenennen..

Ich würde eher sagen, dass die o.g. Zeile in die LocalSettings.php kopiert werden soll - ist bei späteren Updates einfacher

Eigenes Logo einfügen

Das von MediaWiki verwendete Logo heisst wiki.png und liegt im Verzeichnis (MediaWiki)/skins/common/images/...

• Lege Dein Logo (im PNG-Format) in (oben genanntes) Verzeichnis (MediaWiki)/stylesheets/images/
  • Entweder: Ändere den Dateinamen deines Logos auf wiki.png

 $wgStylePath        = "$wgScriptPath/skins";
 $wgStyleDirectory   = "$IP/skins";
 $wgLogo             = "$wgStylePath/common/images/wiki.png";   # <- hier kommt Dein Dateiname hin

und ersetzte das wiki.png durch Deinen Logo-Dateinamen

favicon.ico hinzufügen

Ein favicon.ico ist letztendlich das kleine Icon, welches bei manchen Webpages in der Adresszeile des Browsers angezeigt wird.

Um ein persönliches favicon.ico dem MediaWiki hinzuzufügen:

• Erstelle ein favicon.ico (<- falls du nicht weisst, wie sowas geht, klicke hier drauf)
• Quick and Dirty
  • Kopiere deine favicon.ico-Datei ins MediaWiki-Hauptverzeichnis (wo auch die index.php und LocalSettings.php liegen)
  • Lösche Deinen Cache, und voila... das war's
• Seit mediawiki1.4beta6
  • Die exakte Lokalisation der favicon.ico-Datei kann in der includes/DefaultSettings.php bestimmt werden.
  • Kopiere also deine favicon.ico-Datei irgendwo hin, und gib den entsprechenden Pfad in der includes/DefaultSettings.php an.
  • $wgFavicon = '/favicon.ico';
  • Lösche Deinen Cache, und voila... das war's

Navigationsleiste bearbeiten

Die Navigationsleiste ist recht einfach anzupassen, alle Punkte, die in der Navigationsleiste vorhanden sein sollen, müssen wie unten in LocalSettings.php aufgenommen werden.

 $wgNavigationLinks = array(
    array( 'text'=>'help', 'href'=>'helppage' ),
    array( 'text'=>'sitesupport', 'href'=>'sitesupport-url' ),
    array( 'text'=>'contents', 'href'=>'contents-url' )
 );

und sind durch die entsprechenden neuen Punkte zu ergänzen

Dies kann dann beispielhaft so aussehen;

 $wgNavigationLinks = array(
     array( 'text'=>'help', 'href'=>'helppage' ),
     array( 'text'=>'sitesupport', 'href'=>'sitesupport-url' ),
     array( 'text'=>'themen', 'href'=>'themen-link' ),
     array( 'text'=>'ziele', 'href'=>'ziele-link' ),
     array( 'text'=>'aufgaben', 'href'=>'zukuenftigeaufgaben' ),
     array( 'text'=>'erfolge', 'href'=>'bishererreichtes' ),
     array( 'text'=>'contents', 'href'=>'contents-url' )
 );

Danach müssen folgende Seiten über die Browserleiste aufgerufen werden:

• "Deine Wiki-Url"/MediaWiki:Themen
  • Hier im Textfeld "Themen" oder "Die Themen" eingeben, je nach dem wie der Text der Navileiste heißen soll
• "Deine Wiki-Url"/MediaWiki:Ziele
  • Hier im Textfeld "Ziele" oder "Unsere Ziele" eingeben
• "Deine Wiki-Url"/MediaWiki:Aufgaben
  • Hier im Textfeld "Aufgaben" oder "aktuelle Aufgaben" eingeben
• "Deine Wiki-Url"/MediaWiki:Erfolge
  • Hier im Textfeld "Erfolge" oder "bisher erreichtes" eingeben

Danach muss noch der Wiki mitgeteilt werden, wohin sie verlinken soll, dies ist auf den Seiten die mit 'href' beannt worden sind zu tun. Öffne deshalb folgende Seiten:

• "Deine Wiki-Url"/MediaWiki:Themenlink
  • Gib hier nun die "normale" Wikiseite an auf die gezeigt (verlinkt) werden soll. Üblicherweise wird dies in der Wiki-Syntax mit [ (eckiger Klammer auf) und ] (eckiger Klammer zu) gemacht.
  • Für diesen Fall könntest Du im Textfeld also "Themen" eingeben

öffne dann

• "Deine Wiki-Url"/MediaWiki:Ziele-link
• "Deine Wiki-Url"/MediaWiki:Zukuenftigeaufgaben
• "Deine Wiki-Url"/MediaWiki:Bishererreichtes
  • und schreibe jeweis den passenden link, z.B.: "Ziele", "Aufgaben 2007", "Bericht 2000-2005"

P.S: Diese Methode funktioniert ab 1.4

Änderung der Navigationsleiste (ab MediaWiki Version 1.5)

Quelle: http://meta.wikimedia.org

The navigation bar or side bar is shown at the left hand side of each MediaWiki page by default. In versions 1.5 and newer, it can be modified using the "MediaWiki:Sidebar" page.

Format of the sidebar page

The sidebar page is laid out similar to the following:

<pre>

 * navigation
 ** mainpage|mainpage
 ** mypage-url|My Page

 * tools
 ** Special:Allpages|All Pages

</pre>

Headings

The items on the outer level

• navigation
• tools

are the headings used on the sidebar. In this manner, the bar can be split into sections.

Items The second level items

• mainpage|mainpage
• mypage-url|My Page

are the actual items that appear on the sidebar; see below for instructions on setting these up.

All items on the sidebar take a format which is split by a pipe (|) character.

The left-hand portion of the pipe corresponds to the target of the link, and refers to:

• a MediaWiki namespace page<br />

OR

• a wiki page name

If a MediaWiki namespace page of the same name exists, then the contents of that page are used to determine where the link points. For instance, the default contents of MediaWiki:Mainpage are Main Page - this is the name of the page to be used.

To link to an external URL, simply create the namespace page containing the URL, e.g. the contents of Special:Mypage-url (from the example above) might be http://www.domain.com.

Display text

The right-hand portion of the pipe corresponds to the display form of the link, and is either:

• a MediaWiki namespace page name<br />

OR

• plain text

If a MediaWiki namespace page of the same name exists, then the contents of that page are used to determine the text used for the link. For instance, the default contents of MediaWiki:Mainpage are Main Page - this is what is displayed.

You can also place the text here without using a namespace page; so if MediaWiki:My_Page doesn't exist, then the text My Page would be displayed, using the example about.

Versions-Update

Für Updates siehe auch die Englische Anleitung

1.3.x -> 1.4beta

• So wie Version 1.3.x -> 1.3.x

Version 1.3.x -> 1.3.x

Diese Updates sollten problemlos ablaufen, zur Sicherheit solltest Du aber auf jedenfall Deine Datenbank dumpen !!!

1. Erstelle ein Datenbank-Backup (zur Sicherheit)
2. Sichere Dir den Ordner [MediaWiki]/images , denn sonst gehen alle Bilder verloren
3. Sichere Dir die LocalSettings.php damit Du später dort Deine Einstellung vergleichen kannst, und keine vergisst (z.B. Upload-Freigabe)...
4. Kopiere/ entpacke die neue Version einfach über das Verzeichnis drüber
5. Rufe die Seite mit Deinem Webbrowser auf. Sie erkennt automatisch, dass Du was geupdatet hast.
6. Das Update läuft wie eine normale Installation ab, gebe aber die bestehenden Datenbankinformationen ein. Die Datenbank wird dann automatisch (falls erforderlich) geupdatet.
7. Alle Änderungen in der LocalSettings.php müssen erneut vorgenommen werden. Am besten kopierst du dir die alte Version (zum Vergleichen), damit Du später keine Einstellung vergisst...
8. Kopiere den images-Ordner wieder zurück

FAQ - Häufig gestellte Fragen

Was möchtest Du wissen ?!

Wie gebe ich einem angemeldetem Benutzer Administratorrechte, so dass er Artikel löschen kann?

Dazu musst du zuerst über die Datenbank-Tabelle users die uid des Benutzers herausfinden, indem du seinen Benutzernamen (Case Sensitive) benutzt:

 SELECT uid FROM user WHERE user_name='Der Benutzer';

Führe nun folgende Abfrage aus, um den Benutzer mit der uid=1 zum Administrator zu machen:

 INSERT INTO user_groups (ug_user, ug_group) VALUES (1, 'sysop');

Soll er auch die Benutzerrechte bearbeiten können, so muss er zum Administrator ernannt werden:

 INSERT INTO user_groups (ug_user, ug_group) VALUES (1, 'bureaucrat');

Gibt es sowas wie einen Bot?

Ja, unter anderem:

• Den Pywikipediabot

Als Administrator einloggen

Der Administrator hat den Username WikiSysop und das Passwort, welches bei der Installation vergeben wurde. Du kannst Dir übrigens auch auf deinen Benutzer-Account Adminrechte geben.

Adminrechte entziehen

Wie kann ich einem User die Admin-Rechte wieder entziehen?!

Derzeit gibt es kein Webinterface, dass diese Arbeit erledigt. Deshalb musst du zu Fuss über nen SQL-String die Rechte entziehen

• Version 1.3: UPDATE user SET user_rights="" WHERE user_name="gewünschter Username"
• Version 1.4 Ab er Version 1.4 hat sich die Datenbankstruktur geändert.
• # Suche aus der Tabelle user die passende user_id des gewünschten Users heraus (nicht den Usernamen, sondern die ID !!!)
• # Der SQL-String lautet dann: UPDATE user_rights SET ur_rights="" WHERE ur_user="die herausgesuchte UserID"

Kann ich mehrere Wiki-Boards nebeneinander laufen lassen?

• Wenn jedes seine eigene Datenbank bekommt: selbstverständlich.
• Es funktioniert aber auch innerhalb einer Datenbank - man muss bei der Installation einen anderen (Tabellen-)Präfix setzen, es sollten auch je ein MySQL Benutzer pro Datenbank verwendet werden (aus Sicherheitsgründen)

In welcher Datei kann ich das Menü ändern und z.B. "Spenden" rausnehmen?

• Siehe oben -> Änderung der Navigationsleiste, nach dem Kopieren von $wgNavigationLinks in LocalSettings.php können eben dort auch die unerwünschten Links entfernt werden.

In welcher Datei kann ich einstellen, dass bei Aktuelle Ereignisse nicht Current events als Überschrift steht?

Die Frage wird in der Wikimedia-Hilfe ausführlich erklärt.

Backups

Gibt es ein Script, das bequeme Backups des Wiki samt SQL-Datenbank vornimmt? Sie womöglich sogar per eMail verschickt? Ich stelle mir das in etwa vor wie die "bigAPE Backup"-Komponente für Mambo.

Hilfreich ist schon folgendes:

Datenbank sichern:

 mysqldump --host=hostname --user=username --password=userpassword --opt name-der-datenbank 
 > backup-datei.sql

Wieder einspielen:

 mysql --host=hostname --user=username --password=userpassword name-der-datenbank
 < backup-datei.sql;

Und noch LocalSettings.php sichern.

Und nicht vergessen ggf. auch das images Verzeichnis zu sichern, sonst sind die Dateien weg.

Wo soll ich den Quellcode hinschreiben?

Weblinks

• Englische Hilfeseiten der MediaWiki (sehr detailliert)
• MediaWiki-Homepage
• Handbuch der Wikipedia mit Anleitung zur Funktionsweisen des MediaWiki
• Deutsche Version von Wikipedia
• Web Apps with Tiger: MediaWiki - MacDevCenter (engl.)

Kategorien

Tutorials, MacGyver