LokaleAnpassungen

(deutsche Übersetzung der Seite PmWiki.LocalCustomizations, Stand 22.Nov 2004)

Die ursprüngliche Designidee von PmWiki ist, daß WikiAdministratoren großzügig die Art und Weise wie PmWiki Seiten darstellt und die für die Seitengenerierung gebrauchten Formatierungsanweisungen ändern können. (Dieses ist sogar ausdrücklich in Punkt 4 der PmWiki Philosophie #4. erwähnt.)<-- später noch ein Ankerchen setzen

Dem zu Folge greift das Hauptskript pmwiki.php laufend auf PmWiki.Variables zurück um festzustellen wie Formatierungsanweisungen behandelt werden und was jede einzelne Seite am Ende anzeigen soll. Daher kann der WikiAdministrator eine Menge Anpassungen einfach durch das Setzen von Variablen in der Datei config.php (früher local.php genannt) <-- kann das jetzt raus, stand schon in der PmWiki1 Doku? erreichen.

Der Großteil dieser Seite beschreibt, wie Anpassungen im Allgemeinen funktionieren. Für spezielle Anpassungen, die häufig vorgenommen werden, verweisen wir auf die Übersicht der Dokumentation. Zu diesen typischen Anpassungen gehören unter anderem:

Ändern des Layouts von PmWiki-Seiten
Internationalisierungen -- nicht englisch-sprachige Wikis
Custom Markup ?
Custom InterMaps ?

Das Unterverzeichnis scripts/ (unterhalb des Verzeichnisses, welches das Skript pmwiki.php enthält) und das Kochbuch enthalten viele Beispiele für Anpassungen, die Du in die lokale Konfigurationsdatei config.php übernehmen kannst. Die ersten paar Zeilen in jedem dieser Skripte enthalten im Allgemeinen Informationen, wie die durch das entsprechende Skript zur Verfügung gestellten Features aktiviert und genutzt werden können. Das Hinzufügen einer Zeile wie

        include_once("scripts/scriptfile.php");

in der Datei config.php aktiviert die Skripte. Einige der Skripte sind durch das Skript scripts/stdconfgi.php automatisch aktiviert, es sei denn, Du deaktivierst diese Standardkonfiguration, indem Du $EnableStdConfig=0 in der Datei config.php setzt.

Beachte, dass Du der Versuchung, das Skript pmwiki.php oder die Skripte im Unterverzeichnis scripts/ direkt zu ändern, unbedingt widerstehen solltest. Alle Modifikationen die Du an diesen Dateien vornimmst, werden höchstwahrscheinlich überschrieben, wenn Du ein Upgrade auf eine neue Version von PmWiki vornimmst. Schaue Dir stattdessen lieber die verschiedenen Beispiele für Anpassungsmöglichkeiten an (etwa die Beispielskripte im Unterverzeichnis scripts/), um dann Deine Anpassungen mit Hilfe von config.php vorzunehmen. Du kannst sogar ein eigenes Skript für Deine Anpassungen erstellen und es mit der Anweisung include_once(...) in config.php aktivieren.

Wenn Du ein eigenes Skript zur Anpassung schreibst, kannst Du es problemlos im Unterverzeichnis local/ aufbewahren -- dort wird es Dir nicht bei einem Upgrade überschrieben. Gern kannst Du Deine Anpassungen auch auf der http://www.pmichaud.com/lists/pmwiki-users pmwiki-users mailing list veröffentlichen oder sie zum Kochbuch hinzufügen, so dass andere Benutzer von PmWiki sie verwenden oder aus ihnen lernen können. Es bestünde dann sogar die Möglichkeit sie in einer künftigen Version von PmWiki zu integrieren.

<< Die ersten Einstellungen | PmWikiDe.DokumentationsIndex | Layout Grundlagen >>