TuLzAdoOM am 26. November 2005 um 18:39 Uhr

2005-11-26T18:39:55Z

Neue Seite

{{Handbuch Kopfzeile}}

Prinzipiell lässt sich die Benutzeroberfläche der Wikis nach Belieben verändern. Oft genügt es, die Stylesheets zu bearbeiten um die Optik zu beeinflussen, doch reicht dies nicht aus, wenn man inhaltliche Änderungen vornehmen will. Um beispielsweise die Links der Navigationsleiste am linken Bildrand zu bearbeiten, sind Änderungen im Quelltext nötig.

''Hinweis:'' Alle Angaben beziehen sich auf MediaWiki Version 1.4.0. Zum Anpassen der Version 1.5 siehe: [[MediaWiki_FAQ#How_do_I_change_the_contents_of_the_navigation_toolbar.3F|FAQ]] und [[Help:Navigation bar]]

== Links zur Navigationsleiste hinzufügen ==

Seit Version 1.4 werden die Links über eine Variable mit Arrays in der <tt>DefaultSettings.php</tt> gespeichert.
Dort finden Sie den Eintrag:

<pre>$wgNavigationLinks = array (
array(
</pre>

Um die Variable bearbeiten zu können, müssen Sie diese Zeilen in die Datei <tt>LocalSettings.php</tt> hineinkopieren.

Die Angaben hinter <tt>text</tt> und <tt>href</tt> beziehen sich jeweils auf MediaWiki-Meldungen. Diese beziehen sich auf MediaWiki-Seiten, die entweder schon bestehen oder durch die Meldung neu angelegt werden.
Eine MediaWiki-Seite legt man also ganz einfach an, indem man in die Adressleiste beispielsweise eintippt: '''"Meine URL"/index.php/MediaWiki:NeueSeite''' oder '''"Meine URL"/index.php/MediaWiki:KanzlerSchroeder''' . Es erscheint dann die neue Seite mit genau diesem Titel, also '''MediaWiki:Neue Seite''' oder '''MediaWiki:KanzlerSchroeder'''.

'''1. Beispiel:''' Sie wollen in der Navigation einen Link zur Seite ''Inhalt'' anlegen und in der Navigationsleiste soll dieser Link als Eintrag ''Übersicht'' erscheinen. Den neuen Arraywert, der in der Datei <tt>LocalSettings.php</tt> für diesen Navigationsleisteneintrag definiert werden muss, könnte man wie folgt anlegen (gekürzt):

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

Sie haben also nun einen neuen Arraywert '''array( 'text'=>'contents', 'href'=>'contents-url' )''' angelegt.

Beachten Sie, dass Sie hinter die Zeile des vorletzten Arraywertes <tt>array( 'text'=>'sitesupport' ...</tt> ein Komma setzen, da es sonst zu einer Fehlermeldung kommt, wenn Sie ihre MediaWiki-Website aufrufen.

Im nächsten Schritt muss nun die Seite '''MediaWiki:Contents-url''' angelegt werden. In die Adressleiste tragen Sie ein: '''"Meine URL"/index.php/MediaWiki:Contents-url''' (Statt "Meine URL" tragen Sie Ihre tatsächliche URL ein!).

Es erscheint erwartungsgemäß nun die neue Seite mit dem Titel '''MediaWiki:Contents-url'''.
Klicken Sie auf "Bearbeiten" und tragen Sie in das Textfeld der Seite ein:

Inhalt

Speichern Sie die Seite.

Nun muss die Seite '''MediaWiki:Contents''' auf die gleiche Weise angelegt werden.
Klicken Sie auf "Bearbeiten" und tragen Sie in das Textfeld der Seite ein:

Übersicht

Speichern Sie die Seite.

Jetzt müssen Sie nur noch in der Datei LanguageDe.php folgendes einfügen:

"contents" => "Übersicht",
"contents-url" => "{{ns:4}}:Übersicht",

Auf der Navigationsleiste erscheint jetzt der Eintrag '''Übersicht''', der auf die Seite '''Inhalt''' verweist.

Im Hinblick auf das Endergebnis ist es unerheblich, ob Sie wie in diesem Beispiel zuerst die Seite '''MediaWiki:Contents''' oder die Seite '''MediaWiki:Contents-url''' anlegen.

'''2. Beispiel:''' Sie wollen in der Navigationsleiste einen Link zu einer Seite namens ''Themen'' anlegen und diesen Link ebenfalls mit ''Themen'' beschriften:

<pre>$wgNavigationLinks = array(
...
array( 'text'=>'help', 'href'=>'helppage' ),
array( 'text'=>'sitesupport', 'href'=>'sitesupport-url' ),
array( 'text'=>'themen', 'href'=>'themen-lnk' )
);</pre>

Zunächst muss die Seite '''MediaWiki:Themen-lnk''' angelegt werden und in deren Textfeld eingetragen werden:

Themen

Anschließend wird die Seite '''MediaWiki:Themen''' angelegt. Auf "Bearbeiten" klicken und in das Artikel-Textfeld ebenfalls eintragen:

Themen

Auf der Navigationsleiste erscheint nun der Eintrag "Themen", der auf den Artikel "Themen" verweist.

Wollen Sie stattdessen einen Hyperlink auf eine Website anlegen, tragen Sie einfach die URL in die MediaWiki-Meldung ein, achten Sie aber dabei darauf, dass die URL mit <tt><nowiki>http://</nowiki></tt> beginnt. Es sind auf diese Weise auch Links auf die eigene Mediawiki-Site möglich, beispielsweise um Kategorien aufzulisten. Siehe nachfolgenden Abschnitt.

== Externe Links zur Navigationsleiste hinzufügen ==

Sie möchten einen Eintrag auf der Navigationsleiste, der auf
http://de.wikipedia.org verweist und als "Deutsche Wikipedia" auf der Navigationsleiste erscheint:

<pre>$wgNavigationLinks = array (
array( 'text'=>'mainpage', 'href'=>'mainpage' ),
array( 'text'=>'portal', 'href'=>'portal-url' ),
array( 'text'=>'currentevents', 'href'=>'currentevents-url' ),
array( 'text'=>'mylink', 'href'=>'mylink-url' ),
array( 'text'=>'help', 'href'=>'helppage' ),
array( 'text'=>'sitesupport', 'href'=>'sitesupport-url' )
...
array( 'text'=>'externer_Link', 'href'=>'externerLink-url' )
...
);</pre>

Seite ''externerLink-url'' anlegen (in die Adressleiste eintragen: "Meine URL"//index.php/MediaWiki:ExternerLink-url). Auf "Bearbeiten" klicken und eintragen:

<tt><nowiki>http://de.wikipedia.org</nowiki></tt>

Danach Artikel speichern.

Eine Seite ''Externer_Link" anlegen und in der Seite eintragen:

Deutsche Wikipedia

Auf der Navigationsleiste erscheint nun "Deutsche Wikipedia". Durch Anklicken gelangt man nun direkt zur deutschen Wikipedia

== Eine neue Sektion zur Navigationsleiste hinzufügen ==

In einem neu installierten MediaWiki lassen sich auf der Navigationsleiste folgende Sektionen erkennen: "''Navigation''", "''Suche''" und "''Werkzeuge''", unter Umständen auch "''Andere Sprachen''". Mit einigen tieferen Eingriffen in den Quelltext lässt sich leicht eine neue Sektion hinzufügen.

Beispielhaftes Ziel dieses Abschnittes soll es sein, eine Sektion "''Wichtige Seiten''" zu erstellen. Das Durchführen der Prozedur setzt grundlegende PHP- und HTML-Kentnisse voraus.

'''Schritt 1:''' ''Vorbereiten der SkinTemplate-Klasse''<br />
Die <tt>SkinTemplate.php</tt>, die sich im <tt>includes</tt>-Verzeichnis befindet, enthält die Klasse <tt>SkinTemplate</tt>, welche über eine Funktion <tt>buildNavigationUrls</tt> verfügt. Diese Funktion verarbeitet die Variable <tt>$wgNavigationLinks</tt> (zu finden in <tt>DefaultSettings.php</tt>) und legt deren Inhalt intern ab.

Die Funktion <tt>buildNavigationUrls</tt> verarbeitet also letztlich all die Links, die sich in der "''Navigation''"-Sektion befinden. Legen wir also nun eine neue Funktion nach dem Vorbild der <tt>buildNavigationUrls</tt> an, um die Links unserer geplanten Sektion "''Wichtige Seiten''" zu bearbeiten.

#Kopieren Sie den kompletten Quelltext der Funktion <tt>buildNavigationUrls</tt> und fügen Sie ihn am besten direkt unterhalb neu ein. Benennen Sie diese zweite Funktion beispielsweise <tt>buildCustomUrls</tt>.
#Die <tt>buildNavigationUrls</tt> holt sich die Links aus der Variablen <tt>$wgNavigationLinks</tt>. Wir werden später eine ähnliche Variable mit dem namen <tt>$wgCustomLinks</tt> anlegen. Ersetzen Sie die beiden Referenzen auf <tt>$wgNavigationLinks</tt> in unserer neuen Funktion durch <tt>$wgCustomLinks</tt>.
#Die Funktion <tt>buildNavigationUrls</tt> wird derzeit lediglich an einer Stelle aufgerufen, nämlich etwas weiter oben am Ende der Funktion <tt>outputPage</tt>. Dort befinden sich folgende Zeilen:
$tpl->set( 'navigation_urls', $this->buildNavigationUrls() );
$tpl->set( 'nav_urls', $this->buildNavUrls() );
:Die erste Zeile bedeutet, dass das Array mit den verarbeiteten Links, das die <tt>buildNavigationUrls</tt> zurückgibt, intern unter "''navigation_urls''" abgelegt wird. Das Gleiche müssen wir nun für unsere Funktion <tt>buildCustomUrls</tt> machen. Fügen Sie also folgende Zeile hinzu:
$tpl->set( 'custom_urls', $this->buildCustomUrls() );

'''Schritt 2:''' ''Hinzufügen der Links''<br />
Die Links für den Abschnitt "''Navigation''" werden in der Variablen <tt>$wgNavigationLinks</tt> in der <tt>DefaultSettings.php</tt> abgelegt. Wir brauchen nun ebenfalls eine solche Variable, nämlich die <tt>$wgCustomLinks</tt>. Da die <tt>DefaultSettings.php</tt> nicht geändert werden soll, tragen wir die Variable also in der <tt>LocalSettings.php</tt> ein.

Folgen Sie beim Anlegen der neuen Variablen der Deklaration der <tt>$wgNavigationLinks</tt>. Weitere Angaben hierzu finden Sie auf dieser Seite im Abschnitt [[#Links zur Navigationsleiste hinzufügen|Links zur Navigationsleiste hinzufügen]]. Zum jetzigen Zeitpunkt könnte die Angabe für unsere <tt>$wgCustomLinks</tt> beispielsweise so aussehen:

<pre>$wgCustomLinks = array (
array( 'text'=>'contents', 'href'=>'contents-url' )
);</pre>

Mit diesem Quelltext würde der im Abschnitt [[#Links zur Navigationsleiste hinzufügen|Links zur Navigationsleiste hinzufügen]] angelegte Link seinen Platz in unserer neuen Sektion finden.

Natürlich können Sie beliebig viele Links eintragen.

'''Schritt 3:''' ''Anpassen des HTML-Quelltextes''<br />
Zuletzt muss der Quelltext, der dem Skin zugrunde liegt angepasst werden, um die neue Sektion anzuzeigen. Der Quelltext befindet sich in der <tt>MonoBook.php</tt>, die im <tt>skins</tt>-Verzeichnis lagert.

Die einzelnen Sektionen werden jeweils durch <tt><nowiki><div></nowiki></tt>-Tags beschrieben und beginnen wie folgt:

; Navigation : <pre><div class="portlet" id="p-nav"></pre>

; Suche : <pre><div id="p-search" class="portlet"></pre>

; Werkzeuge : <pre><div class="portlet" id="p-tb"></pre>

Suchen Sie sich einen Ort für die neue Sektion aus.

#Wir haben uns bisher immer an den Quelltext für die Sektion "''Navigation''" gehalten - so auch jetzt. Kopieren Sie den Quelltext dieser Sektion und fügen Sie ihn an der gewünschten Stelle ein. Die Bezeichnung ''Navigation'' wird durch die MediaWiki-Meldung [[MediaWiki:Navigation]] erzeugt. Ändern Sie die entsprechende Zeile von <pre><h5><?php $this->msg('navigation') ?></h5></pre> um zu <pre><h5><?php $this->msg('customlinks') ?></h5></pre>, sodass die Überschrift unserer neuen Sektion nun durch die MediaWiki-Meldung [[MediaWiki:Customlinks]] festgelegt wird. Legen Sie diese Seite zusammen mit den Seiten für die Links in der Sektion (Schritt 2) an, wenn Sie fertig sind.
#Außerdem wird der Inhalt unserer neuen Sektion bisher noch aus den intern abgelegten Navigations-Links (<tt>data['navigation_urls']</tt>) geladen, ändern Sie also die Zeile <pre><?php foreach($this->data['navigation_urls'] as $navlink) { ?></pre> um in <pre><?php foreach($this->data['custom_urls'] as $navlink) { ?></pre> (siehe Schritt 1).

'''Fertig!''' ''Die neue Sektion sollte nun verfügbar sein.''<br />
Vergessen Sie nicht, die MediaWiki-Meldungen anzulegen.

[[Category:MediaWiki-Handbuch|Anpassen]]

Hilfe:Anpassen - Versionsgeschichte

TuLzAdoOM am 26. November 2005 um 18:39 Uhr