Deutsches Wiki

(deutsche Übersetzung der Seite PmWiki.LocalCustomizations, Stand 18.09.2005)

Von Anfang an wurde PmWiki so entwickelt, dass ein Administrator des Wikis sehr stark beeinflussen kann, wie PmWiki Seiten anzeigt bzw. welche Auszeichnungen verwendet werden. (Besonders erwähnt unter PmWiki Philosophie Punkt 4.) Als ein Ergebnis davon verwendet das pmwiki.php Skript reichlich Variablen um Einflußdarauf zu nehmen, wwie Auszeichnungen verarbeitet werden und was die einzelnen Seiten ausgeben werden. Dadurch kann ein Administrator viele Anpassungen vornehmen, indem er einfach Variablen in der Datei config.php setzt.

Der Großteil dieser Seite beschreibt, wie Anpassungen im Allgemeinen funktionieren. Siehe Dokumentationsindex für genauere Informationen über spezielle Anpassungen, die häufiger bei vielen PmWiki Installationen durchgeführt werden, z.B.:

Das Unterverzeichnis scripts/ (unter dem Verzeichnis, das pmwiki.php enthält) und das PmWiki Cookbook (Kochbuch) enthält viele Beispiele zu Anpassungen, die man in die eigene config.php Konfiguration integrieren kann. die ersten paar Zeilen jedes Skript enthalten im Allgemeinen Anweisungen wie man die Funktionen aktiviert (und nutzt). Bei den meisten Skripts reichte es aus

include_once("scripts/skriptdatei.php");

irgendwo in der Datei config.php unterzubringen um dessen Funktionen zu aktivieren. Manche Skripts werden automatisch übder die Datei scripts/stdconfig.php aktiviert, solange man nicht $EnableStdConfig=0; in der Datei local/config.php setzt.

Man sollte der Versuchung wiederstehen 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 erzeugecn 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 wird es 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 einfliessen kann.

<< Layout Vorlagen | Dokumentationsindex | Upgrades >>