Lokale Anpassungen

für die Liste aller Seiten

Ein Administrator des Wikis kann eine Menge Anpassungen vornehmen, indem er einfach Variablen in der local/config.php-Datei setzt und "cascading style sheets" (CSS) in der /pub/css/local.css-Datei definiert. Jede Gruppe oder Seite kann darüber hinaus ihre eigene Konfigurationsdatei und CSS-Konfigurationsdatei haben.

Diese Seite beschreibt, wie Anpassungen im Allgemeinen funktionieren, siehe Dokumentations-Index wegen genauerer Informationen über spezielle Anpassungen, die gewöhnlich bei vielen PmWiki Installationen durchgeführt werden, einschließlich:

• Layout Vorlagen - Grundlagen für die Anpassung des Skins (Layout)
• Internationalisierungen - Automatische Übersetzung von Phrasen und Seiten
• Eigene Auszeichnungen - Anpassung von Formatierungsanweisungen
• InterMap anpassen - wird weitergeleitet auf PmWikiDe.InterMap.

local/config.php

Von Anbeginn an wurde PmWiki so entworfen, dass ein Administrator des Wikis die Art, wie PmWiki Seiten anzeigt und wie die Auszeichnungssequenzen zum Seiten erzeugen genutzt werden, weitgehend anpassen kann. (Das wird sogar ausdrücklich in der PmWiki-Philosophie #4 - gemeinsame Wartung - erwähnt.) Im Ergebnis macht das zentrale pmwiki.php-Skript intensiven Gebrauch von Variablen, um zu bestimmen, wie Auszeichnungssequenzen verarbeitet werden sollen und was jede individuelle Seite ausgibt.

Die einfachste Art der Anpassung ist, eine Variable auf 1 zu setzen (oder auf TRUE). Hier ist ein Beispiel, das ?action=diag- und ?action=phpinfo-Aktionen möglich macht:

Sie können eine Zeile mit einem "#" beginnen (einem Doppelkreuz, auch bekannt als Nummernzeichen, "Fis" oder "Lattenzaun"), um damit einen Kommentar einzuleiten. Außerdem nehmen einige PmWiki-Variablen andere Werte als 1 und 0 (true und false) an. Hier ist ein weiteres Beispiel, das des Wikis Verhalten bezogen auf Suchmaschinenrobotern anpasst (siehe Cookbook:ControllingWebRobots):

# Entferne das standardmäßige "rel='nofollow'"-Attribut für externe Verweise.
$UrlLinkFmt = "<a class='urllink' href='\$LinkUrl' title='\$LinkAlt'>\$LinkText</a>"

Das Unterverzeichnis scripts/ (unter dem Verzeichnis, das pmwiki.php enthält) beinhaltet viele Anpassungen) Das PmWiki-Kochbuch enthält viele Beispiele zu Anpassungen, die Sie in Ihr cookbook/-Unterverzeichnis herunterladen können. Die erste paar Zeilen in jedem Skript enthalten generell Instruktionen, wie die Features des Skripts aktiviert und eingesetzt werden.

Diese Anpassungen werden in Ihre config.php-Datei eingefügt. Bei den meisten Skripts reichte es aus

und

irgendwo an Ende der Datei config.php unterzubringen, um dessen Funktionen zu aktivieren.

Manche Skripts werden automatisch über die Datei scripts/stdconfig.php aktiviert, solange man nicht $EnableStdConfig=0; in der Datei local/config.php setzt.

Reihenfolge der Befehle in config.php

Die folgende Reihenfolge ist zu empfehlen:

• definieren Sie $ScriptUrl und $PubDirUrl, wo nötig,
• definieren Sie eine angepasste PageStore_class wie SQLite, CompressedPageStore or PerGroupSubDirectories,
• als Nächstes fügen Sie (mit include_once) scripts/xlpage-utf-8.php ein,
• als Nächstes rufen Sie XLPage() auf, das erwartet, dass das definierte (rw) $WikiDir-Verzeichnis schon gesetzt ist, damit XLPage() die Wiki-Seite mit den Übersetzungen auch finden kann,
• als Nächstes müssen Sie authuser.php einfügen (wenn Sie das einsetzen wollen), weil PmWiki einige Seiten- und Gruppenautorisierungsniveaus zwischenspeichert, wenn auf eine Seite zugegriffen wird,
• als Nächstes fügen Sie alle anderen Skripte und Rezepte ein,
• jegliche direkten Funktionsaufrufe in config.php wie ResolvePageName(), CondAuth(), PageTextVar(), PageVar(), RetrieveAuthPage(), oder andere, sollten wenn möglich weit zum Ende der Datei hin erfolgen.

Beachten Sie, jedes dieser Teile ist nicht zwingend notwendig, wenn Sie sie aber einsetzen, dann ist dies die empfohlene Reihenfolge in config.php.

Zeichencodierung von config.php

Die Codierung hat einen Effekt, wenn Sie die config.php-Datei speichern. Ihr Editor sollte Ihnen erlauben, die Datei in der Codierung ihres Wikis zu speichern. (Die Voreinstellung von PmWiki ist ISO-8859-1, für neue Wikis wird empfohlen, UTF-8 zu aktivieren.)

Neuere Betriebssysteme wie GNU/Linux, FreeBSD und Apple haben generell die Voreinstellung Unicode/UTF-8 für das Speichern von Dateien. In Windows ist die Voreinstellung für die Codierung ANSI/Windows-1252, was fast das Gleiche wie PmWikis ISO-8859-1 ist.

Die folgenden frei verfügbaren Texteditoren können Dateien in verschieden Codierungen bearbeiten und speichern:

• Cross-platform: Kate (for KDE), Geany, Arachnophilia, SciTE, Bluefish, vim und andere.
• Windows: Notepad++, ConTEXT, Notepad 2.

Beachten Sie, dass Sie, wenn Sie UTF-8-Codierung benutzen, die Datei "ohne Byte Order Mark (BOM)" speichern müssen.

Irgendwann wird es ein PmWiki-Update mit der Voreinstellung auf die UTF-8-Codierung geben, mit der sich alle möglichen Alphabete und Sprachen darstellen lassen. Siehe UTF-8 wegen weiterer Informationen.

pub/css/local.css

Sie können diese Datei anlegen und dort ein paar angepasste CSS-Stile definieren, welche die vom Skin vorgegebenen Stile überschreiben. Zum Beispiel:

  h1, h2, h3, h4, h5 { color: #880000; } /*dunkelrote Titel*/
  a { text-decoration: none; } /* unterstreiche Verweise nicht */

Verändern Sie die pmwiki.php-Datei nicht direkt (auch keine anderen Kerndateien)

Man sollte der Versuchung widerstehen die Datei pmwiki.php oder die Dateien im Unterverzeichnis scripts/ direkt zu verändern. Jegliche Änderung wird vielleicht mit dem nächsten Upgrade überschrieben. Stattdessen sollte man Ausschau nach Anpassungen halten, die in der Datei config.php durchgeführt werden können. Man kann sogar sein eigenes Skript erzeugen und es mit include_once(...) in der config.php einbinden. Wenn man eigene Skripts mit Anpassungen erstellt, kann man diese problemlos im Unterverzeichnis cookbook/ speichern. Dort werden sie bei Upgrades nicht überschrieben. Eventuell möchte man auch diese Anpassungen anderen über die pmwiki-users Mailingliste oder das Kochbuch zur Verfügung stellen, so dass auch andere Benutzer davon profitieren können, oder es sogar in eine zukünftige Version von PmWiki einfließen kann.

FAQ

## Hole den Gruppen- und den Seitennamen
$pagename = ResolvePageName($pagename);
$page = PageVar($pagename, '$FullName');
$group = PageVar($pagename, '$Group');
$name = PageVar($pagename, '$Name');

für die Liste aller Seiten