promo­wiki

Doktorandenwiki der {iw,mi}

(deutsche Übersetzung der Seite PmWiki.InitialSetupTasks, Stand 07.09.2005) Administratoren (Grundlagen)

Wenn PmWiki auf Ihrer Webseite erst einmal läuft (siehe Installation), kann man es den eigenen Bedürfnissen anpassen. Die meisten Anpassungen erfolgen in einer Datei namens local/config.php. Einige Einstellungen werden auf speziellen Seiten in der Site Gruppe getätigt. Ein Beispiel ist das Menü in der Seitenleiste (Site.SideBar).

config.php anpassen

Wenn man PmWiki das erste Mal installiert gibt es noch keine Datei local/config.php. Kopieren Sie in diesem Fall die Datei sample-config.php (im docs/ Verzeichnis) nach local/config.php und verwenden diese als Startpunkt. Man kann natürlich die Datei local/config.php von Null auf erzeugen, allerdings enthält die Datei sample-config.php bereits die meisten Optionen, die man wahrscheinlich verwenden möchte.

Hier ein Beispiel zur Datei config.php:

<?php if (!defined('PmWiki')) exit();
$WikiTitle = "Mein neues Wiki";
$PageLogoUrl = "http://www.beispiel.de/MeinLogo.gif";

$DefaultPasswords['admin'] = crypt('geheim');

$EnableUpload = 1;
$DefaultPasswords['upload'] = crypt('geheim2');

putenv("TZ=EST5EDT");
$TimeFmt = '%B %d, %Y, um %I:%M %p EST';

Man beachte, dass die Datei config.php mit <?php beginnt. Die PHP-Endkennzeichnung ?> ist optional und kann weggelassen werden, um die Kompatibilität mit manchen Betriebssystemen zu verbessern. Vor <?php oder nach ?> dürfen keine Leerzeichen oder Leerzeilen erscheinen, andernfalls kann es passieren, dass man seltsame Meldungen am Anfang der Wikiseiten sieht.

Die obige Datei config.php setzt die Werte von vier PHP Variablen, die von PmWiki verwendet werden:

  • Die Variable $WikiTitle enthält den Namen der Webseite, der in der Titelzeile des Webbrowsers erscheint.
  • Die Variable $PageLogoUrl enthält die Internetadresse der Grafik, die in der oberen linken Ecke auf jeder Seite des Wikis erscheint.
  • $DefaultPasswords['admin'] setzt das Administartorpasswort.
  • Das Setzen von $EnableUpload auf "1" ermöglicht Hochladen (das Hochladen von Dateien). $DefaultPasswords['upload'] setzt das Passwort für das Hochladen.
  • Die TZ Umgebungsvariable definiert eine bestimmte Zeitzone.
  • Die Variable $TimeFmt bestimmt das Erscheinungsbild von Datums-/Zeitanzeigen und lokalisiert sie (zusammen mit TZ) für eine bestimmte Zeitzone.

Durch das Setzen dieser (und anderer) Variablen in local/config.php, kann man das Aussehen und Verhalten von PmWiki von dessen Standardeinstellungen abweichend einstellen. Manchmal sogar beträchtlich anders. Siehe Variablen für eine Liste der von PmWiki verwendeten Variablen. Siehe auch PmWiki:PmWikiUsers für Beispiele von Webseiten, die PmWiki mit eigenen Anpassungen einsetzen.

Setzen des Administratorpassworts

Die Seiten in der Site Gruppe (außer Site.SideBar) sind standardmäßig vor der Bearbeitung geschützt. Um die Seiten in dieser Gruppe bearbeiten zu können, muss man ein globales Administartorpasswort in local/config.php setzen. Um das globale Administratorpasswort auf "geheimnis" zu setzen, ändern Sie die entsprechende zeile folgendermaßen:

$DefaultPasswords['admin'] = crypt('geheimnis');

Man muss die crypt() Funktion verwenden, um ein Passwort mit einem für Sie verständlichen Wert zu setzen. Siehe Administration der Passwörter? um näheres darüber herauszufinden, wie man Passwörter sicherer macht.

Verändern Sie pmwiki.php nicht

Wenn man die Konfiguration der eigenen Webseite verändert sollte man die Änderungen nur in der Datei local/config.php durchführen bzw. Dateien in das cookbook/ Verzeichnis kopieren. Verändern Sie weder pmwiki.php noch die Dateien im scripts/ Verzeichnis. PmWiki wurde so entwickelt, dass alle Anpassungen ohne Änderung der Orginaldateien erfolgen kann -- einer der Entwicklungsziele war die Fähigkeit einfacher Upgrades. PmWiki schreibt niemals in Dateien in den Verzeichnissen local/ oder cookbook/. Darum ist es einfacher Änderungen und Upgrades zurückzuverfolgen, ohne dass Anpassungen verloren gehen.

Man sollte pmwiki.php auch nicht umbenennen. Viele Administratoren erzeugen eine Datei index.php im pmwiki Verzeichnis, die nur die nachfolgende einzelen Zeile enthält:

<?php include('pmwiki.php'); ?>

Andere Anpassungen

Nach dem Anpassen der Datei local/config.phpmöchte man vielleicht weitere Lokale Anpassungen durchführen. Siehe auch PmWiki Kochbuch (Cookbook) für eine Vielzahl von Anpassungen, die zur Verfügung gestellt wurden. Und keine Angst vor Kochbuch-Rezepten - Sie sind gut vorbereitet, so dass die meisten nur das Herunterladen einer Datei und das Einfügen einer include Zeile in der config.php erfordern - und schon läufts!

Wenn man mehr als ein Wiki auf dem Server laufen lassen will, sollte man sich Wikifarm ansehen.

Und jetzt?

Vergessen Sie nicht sich bei der Mailingliste anzumelden, bei der Sie andere Wiki-Administratoren? um Hilfe bei der Konfiguration bitten und sich bei Diskussionen über Verbesserungen von PmWiki beteiligen können. Wenn Ihre Seite läuft, vergessen Sie auch nicht diese unter PmWiki:PmWikiUsers einzutragen, damit andere es auch wissen.

<< Installation | DocumentationIndex | Lokale Anpassungen >>