Installation

für die Liste aller Seiten

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.38 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.

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):

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:

• Cookbook:PHP
• Cookbook:InstallOnIIS