Installation
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.37 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.
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):
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.
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 .
chmod
-Befehl funktioniert auch in vielen FTP Programmen. Durch das Erzeugen von wiki.d/
auf diese Weise werden
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
Česky (Czech) Arabic Bulgarian Català Chinese (Traditional) Chinese simplified Dansk Deutsch English Español Esperanto Farsi (Persian) Français Greek Indonesian Italiano Japanese Korean Latviešu (Latvian) Lietuvių (Lithuanian) Macedonian Magyar (Hungarian) Nederlands Norsk Polski Portuguese Portuguese (Br) Românã Russian Shqip Slovenčina Slovenščina Suomi Svenska Türkçe Tagalog Tamil Ukrainian Việt ngữ
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 wiepmwiki.php
hinzufügen. Erzeugen Sie eine neue Datei namensindex.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.
Übersetzung von PmWiki.Installation, Originalseite auf PmWikiDe.Installation — Backlinks
Zuletzt geändert: | PmWikiDe.Installation | am 19.02.2024 |
PmWiki.Installation | am 18.02.2024 |