Installation

für die Liste aller Seiten

Administratoren (Grundlagen)

< Besondere Seiten | Dokumentations-Index | Erste Einstellungen >

Auf dieser Seite wird erklärt, wie PmWiki 2.1 bis 2.3 heruntergeladen und installiert wird. Hier noch eine Liste dazugehörender Seiten:

Voraussetzungen - Voraussetzungen zum Einrichten des PmWiki-Wiki-Systems
Upgrades - Umstellung auf neuere Versionen von PmWiki
Wikifarm - Begriffserklärung und Installation von Wiki-Farmen
Liste der Änderungen - Verfügbare neue Funktionen und Fehlerbehebungen in Englisch

Verbesserungen an diesen Anleitungen sind immer willkommen. Berichten Sie jedes Problem in den Mailinglisten der PmWiki-User oder tragen es im PmWiki Issue Tracking System ein.

Installation von PmWiki

Wenn Sie PmWiki aktualisieren, lesen Sie bitte sorgfältig die Seiten Aktualisierungen und Release Notes.

1. Download

Laden Sie die letzte stabile PmWiki-Version

als ZIP Archiv (pmwiki-latest.zip) oder
als `geZIPtes Tarball (pmwiki-latest.tgz)

von https://www.pmwiki.org/pub/pmwiki/ herunter
oder laden Sie die letzte Betaversion von der PmWiki:Subversion-Seite herunter.

2. Auspacken

Entpacken Sie das heruntergeladene Archiv mittels tar zxvf pmwiki-latest.tgz oder unzip pmwiki-latest.zip. Dadurch wird ein pmwiki-x.y.z Verzeichnis erzeugt, in dem die PmWiki-Software zu finden ist. Zum Beispiel sollte das aktuelle "latest" Paket in ein Verzeichnis namens pmwiki-2.3.35 entpackt werden. Das Verzeichnis enthält u. a. folgende Dateien und Verzeichnisse:

    README.txt         Ein einführendes Dokument
    pmwiki.php         Das PmWiki-Hauptprogramm
    local/             Verzeichnis für lokale Anpassungen mittels Konfigurationsskripten
    cookbook/          Verzeichnis für Rezepte (add-ons) aus dem Kochbuch
    docs/              kurze Dokumentation, Beispiele für Konfigurationsdateien
    pub/               Verzeichnis für frei zugängliche Dateien
    pub/css/           Verzeichnis für zusätzliche CSS-Dateien
    pub/guiedit/
    pub/skins/         Verzeichnis für Layout Vorlagen für ein individuelles Aussehen 
    scripts/           Einige Erweiterungsmodule als Teil von PmWiki
    wikilib.d/         Verzeichnis mit den Standard-PmWiki-Seiten

Das Verzeichnis pmwiki-x.y.z sollte an einem Platz abgelegt werden, auf den der Webserver zugreifen kann (z. B. in irgendeinem public_html-Verzeichnis (htdocs, www, ...)). Man kann die Dateien und Verzeichnisse mit verschiedenen Werkzeugen ablegen – FTP oder die Unixbefehle mv oder cp erledigen die Arbeit im Allgemeinen.

Hinweis: Es wird empfohlen, den Verzeichnisnamen "pmwiki-x.y.z" in "pmwiki" oder einfach "wiki" umzubenennen.

3. Verzeichnisse anlegen

Meistens erledigt PmWiki das für Sie. Öffnen Sie pmwiki.php auf dem Server in Ihrem Webbrowser (also nicht die Datei auf Ihrem Rechner mit dem URL file://...). PmWiki analysiert dann das System und gibt Anweisungen (falls notwendig), um das Verzeichnis wiki.d/ zu erzeugen. In diesem Verzeichnis werden die neu erzeugten Seiten Ihres Wikis gespeichert.

Ansonsten gibt es zwei Möglichkeiten, das Verzeichnis zu erzeugen (Benutzen Sie Filezilla oder WinSCP, um die Verzeichnisrechte zu setzen):

3a. Sie können das Verzeichnis wiki.d/ manuell erzeugen und ihm dann volle Schreibrechte zuweisen (d. h. "chmod 777 wiki.d"). Verwenden Sie diese Methode, wenn auf Ihrem Server der "Safe Mode" bei PHP eingeschaltet ist.

3b. Auf manchen Systemen ist es möglich, das Verzeichnis wiki.d/ von PmWiki erzeugen zu lassen, indem das Verzeichnis, das pmwiki.php enthält, kurzzeitig das Recht 2777 erhält. Unter Unix wird hierzu normalerweise in das Verzeichnis gewechselt, das pmwiki.php enthält und folgender Befehl ausgeführt

chmod 2777 .

(Beachten Sie den Punkt am Ende). Der chmod-Befehl funktioniert auch in vielen FTP Programmen. Durch das Erzeugen von wiki.d/ auf diese Weise werden

(1) das Verzeichnis für den Webserver beschreibbar gemacht, damit das Verzeichnis für die Wikidateien erzeugt werden kann,

(2) die Gruppenrechte des Verzeichnisses auf neue Verzeichnisse übertragen, so dass das Erzeugerkonto des Verzeichnisses die Dateien in diesem Verzeichnis bearbeiten kann und

(3) Zugriffe auf die Dateien im Verzeichnis wiki.d/ von anderen Konten (Accounts) auf dem gleichen Server aus erschwert.

Nachdem alle Verzeichnisrechte eingestellt wurden, öffnen Sie nochmal das pmwiki.php-Skript im Webbrowser. Wenn alles gutgegangen ist, wurde das Verzeichnis wiki.d erzeugt und man sieht die Standard-Startseite.

Wichtig: Wenn Sie die Methode 3b verwendet haben, sollten Sie die Rechte in dem Verzeichniss, das pmwiki.php enthält, mit dem Befehl "chmod 755 ." wieder zurücksetzen.

Siehe auch Dateirechte

4. Initialisieren

Nehmen Sie die ersten Einstellungen unter die Lupe, wenn Sie weitere Anpassungen für die eigene PmWiki-Installation durchführen möchten, zusätzlich könnten Sie die Anmerkungen zu den Versionen (Englisch) genauer durchlesen für weitere Informationen.

5. Sprache einstellen

Wenn Sie PmWiki in einer anderen Sprache nutzen möchten, können Sie sich das gewünschte internationale Sprachpaket (z. B. i18n-de.zip) oder alle (i18n-all.zip) als ZIP Archiv von https://www.pmwiki.org/pub/pmwiki/i18n/ herunterladen. Dann werden die Dateien entpackt und auf dem Server in das Verzeichnis wikilib.d/ kopiert. Damit haben Sie die Dokumentationsseiten auch in Ihrer Sprache.

Verfügbare Sprachen sind

In dem entpackten i18n-Archiv gibt es zwei Verzeichnisse, scripts/ und wikilib.d/. Kopieren Sie die Dateien, die in diesen Verzeichnissen enthalten sind, in die entsprechenden schon vorhandenen Verzeichnisse scripts/ und wikilib.d/ Ihrer Installation. Für eine deutsche Lokalisation müssen beispielsweise die Dateien PmWikiDe.* und PmWiki.* in dem gleichen Verzeichnis sein.

Aktivieren Sie dann die Lokalisation, indem Sie folgenden Eintrag (im Beispiel für die deutsche Übersetzung) in die local/config.php-Datei einfügen:

XLPage('de','PmWikiDe.XLPage');

Weitere Informationen finden sie unter Internationalisierungen.

6. HTTPS

Die Internetgemeinde bewegt sich rasch in Richtung sicherer Webseiten, indem sie HTTPS (Hypertext Transfer Protocol Secure) nutzt. Auch wenn es zu den fortgeschritteneren Themen gehört, werfen Sie doch mal einen Blick in HTTPS aufsetzen.

Anmerkungen

Die PmWiki-Distribution enthält absichtlich keine index.php-Datei. Sie können leicht Ihr eigenes "Wrapperskript" in das gleiche Verzeichnis wie pmwiki.php hinzufügen. Erzeugen Sie eine neue Datei namens index.php mit der folgenden einzigen Textzeile (und lassen Sie das schließende Tag "?>" ganz bewusst weg):
<?php include_once('pmwiki.php');

Widerstehen Sie der Versuchung, ''pmwiki.php in index.php'' umzubenennen, denn wenn Sie die Datei umbenennen, wird sie bei einem Update nicht überschrieben.

Wenn Sie den Unix-Befehl tar für das Entpacken des Archivs in Schritt 2 verwendet haben, müssen Sie sicherstellen, dass die Dateien mit ausreichenden Rechten erzeugt wurden, damit der Webserver darauf zugreifen kann. Normalerweise können Sie das erreichen, indem Sie in der Befehlszeile umask 002 eingeben, bevor das Archiv entpackt wird.
Wenn die Installation auf einem Windows-Rechner erfolgt, sollten Sie unbedingt einen Blick auf Cookbook:SimultaneousEdits werfen, um zeitgleiches Bearbeiten von Seiten auf dieser Plattform zu verhindern.
Zusätzliche Tipps finden Sie unter den Problemlösungen.

Siehe auch:

Könnte ich nicht pmwiki.php in index.php umbenennen?

Vom Umbenennen wird abgeraten. Statt dessen erzeugen Sie eine neue Datei namens index.php mit der folgenden einzigen Textzeile (und lassen Sie das schließende Tag "?>" ganz bewusst weg):

<?php include_once('pmwiki.php');

Wie mache ich pmwiki.php zur Standardseite einer Website?

Erzeugen Sie eine index.php-Datei, die PmWiki aus einem Unterverzeichnis heraus startet (z. B. aus pmwiki/) und setzen Sie sie in das Wurzelverzeichnis der Site (das Hauptverzeichnis der Website).

<?php chdir('pmwiki'); include_once('pmwiki.php');

Annmerkung: Sie müssen auch ausdrücklich die $PubDirUrl-Variable setzen (beispielsweise auf "https://example.com/pmwiki/pub" in der local/config.php-Datei.

Wie kann ich "saubere URLs" aktivieren, die kürzer sind und mehr nach Pfaden zu meinen Wikiseiten aussehen? Warum scheint pmwiki.org eher eine Verzeichnisstruktur zu haben anstelle von "?n=seitenname" in den URLs?

Siehe Cookbook:CleanUrls.

Wie kann ich PmWiki auf einer selbstständigen Maschine (offline, portabel) laufen lassen?

Siehe Cookbook:Standalone oder Cookbook:WikiOnAStick. für die Liste aller Seiten