Upgrade von PmWiki 1

für die Liste aller Seiten

Diese Seite bringt Vorschläge für das Umsteigen von einer laufenden PmWiki 1.x Installation auf PmWiki 2.0. Es wird hier davon ausgegangen, dass eine vom Administrator des Wikis eingerichtete Webseite mit PmWiki Version 1.x oder einer noch früheren Version in einer Standardkonfiguration läuft, die unter der Version 2.0 lauffähig gemacht werden soll.

Wie üblich können Fragen und Hilfeersuchen an die Mailinglisten geschickt werden. Fehler und Schwierigkeiten mit den unten beschriebenen Verfahren können hier verbessert werden, oder man trägt sie in das PmWiki Issue Tracking System ein.

Umwandlung

Durch den grundlegenden Neuaufbau von PmWiki 2.0, wird es für den Administrator des Wikis bei der Umwandlung einer Website zu 2.0 höchstwahrscheinlich zu einer ganzen Reihe von Unannehmlichkeiten kommen. Der hier gezeigte Ansatz erlaubt es dem Administrator PmWiki 2.0 zu installieren, zu konfigurieren und mit vorhandenen Seiten zu testen, ohne Schaden an einer vorhandenen 1.x-Installation zu riskieren.

Schritt 0: Es ist – wie immer – eine gute Idee, eine Sicherungskopie der laufenden PmWiki 1.x Installation anzufertigen, bevor irgendetwas anderes gemacht wird &ndash das gilt insbesondere für die Dateien in den Verzeichnissen local/ und wiki.d/.

Schritt 1: Installation von PmWiki 2.0 in ein neues von 1.x getrenntes Verzeichnis.

Schritt 2: Überprüfen Sie kurz die "PmWiki 2.0"-Installation und überzeugen Sie sich, dass diese richtig funktioniert - d.h. einige Seiten verändern und wieder speichern. Danach entfernen Sie die gerade erzeugten Dateien wieder (aus dem wiki.d/-Verzeichnis von PmWiki 2.0 oder Sie löschen das ganze wiki.d/-Verzeichnis von PmWiki 2.0).

Schritt 3: Fügen Sie folgende Zeilen in die local/config.php-Datei der 2.0 Installation hinzu und ersetzen Sie dabei die Pfadangabe "/Pfad/zu/pmwiki1/wiki.d" mit dem Pfad zum wiki.d/-Verzeichnis der "PmWiki 1.x"-Installationen auf der eigenen Festplatte.

include_once("$FarmD/scripts/compat1x.php");
UseV1WikiD("/Pfad/zu/pmwiki1/wiki.d");

Zum Beispiel verwendet meine 2.0-Test-Umwandlung:

include_once("$FarmD/scripts/compat1x.php");
UseV1WikiD("/home/pmichaud/pmwiki/wiki.d");

Schritt 4: Nach obiger Änderung sollten alle existierenden Seiten in der neuen 2.0-Installation auftauchen. Wenn Sie dann auf "Bearbeiten" irgendeiner der vorhandenen Seiten klicken, sollten Sie sehen, dass alle "PmWiki 1.x"-Formatierungsanweisungen (Verweise, usw.) in die für die neue Version gültigen Formatierungsanweisungen umgesetzt wurden.

Alle mit der "PmWiki 2.0"-Installation bearbeiteten/gespeicherten Seiten werden getrennt von den Seiten der früheren Installation aufbewahrt. Auf diese Weise kann man ohne Risiko mit dem Bearbeiten und Verändern der Seiten auf der neuen Website experimentieren, ohne die existierende 1.x-Website zu beeinflussen.

Schritt 5: Nachdem alle Seiten in der 2.0-Installation verfügbar sind, können Sie mit dem Rest der 2.0-Webseitenanpassung fortfahren, wie es in den ersten Einstellungen erklärt ist, und alle gewünschten lokalen Anpassungen vornehmen. Viele lokale Anpassungen (z. B. Seitenlayout-Vorlagen) unterscheiden sich nicht zwischen Version 1.x und 2.0, andere (z.B. Eigene Auszeichnungen oder Kochbuch-Rezepte) müssen für die Version 2.0 angepasst werden.

Hinweis: WikiWort-Verweise sind ab der Version 2.1beta2 von PmWiki standardmäßig abgeschaltet. Sie können das Verwenden von WikiWörtern entweder aktivieren, indem Sie $LinkWikiWords = 1; in der config.php-Datei setzen oder Sie konvertieren Ihre WikiWort-Verweise manuell in die neue Standardform mit doppelten eckigen Klammern. Um alte WikiWort-Verweise einfacher zu finden, können sie durch den folgenden Eintrag in config.php farblich hervorgehoben werden:

$HTMLStylesFmt['wikiword'] = "span.wikiword { background:yellow; }";

Schritt 6: Führen Sie die neue Installation genau so weiter, als würden Sie eine neue PmWiki-Website einrichten. Wenn Sie "PmWiki 1.x"-Formatierungsauszeichnungen finden, die nicht oder falsch umgewandelt worden sind, schreiben Sie bitte einen neuen PITS-Eintrag, damit das Umwandlungsskript verbessert werden kann.

Schritt 7: Wenn Sie mit der Umwandlung zufrieden sind und nun alle 1.x-Seiten auf das 2.0-Format bringen wollen, dann sollten Sie den oben beschriebenen UseV1WikiD(...)-Befehl in der local/config.php-Datei in ConvertV1WikiD(...) umändern, wie nachfolgend beschrieben:

include_once("$FarmD/scripts/compat1x.php");
ConvertV1WikiD("/Pfad/zu/pmwiki1/wiki.d");

Wenn das pmwiki.php-Skript dann gestartet wird, erscheinen einige Formulare, die es ermöglichen, einige oder alle 1.x-Seiten in das 2.0-Format umzuwandeln. Nach der Umwandlung können Sie beide Zeilen wieder aus der Konfigurationsdatei entfernen. Nun läuft die "PmWiki 2.0"-Installation völlig eigenständig.

Wenn Sie lokale Anpassungen vorgenommen haben, für deren korrekte Umwandlung Einträge der Art $Compat1x['/match/'] = 'replace'; erforderlich sind, dann achten Sie darauf, dass diese Einträge vor dem Aufruf von ConvertV1WikiD gemacht werden.

Es ist nicht notwendig, alle Seiten umzuwandeln oder das wiki.d/-Verzeichnis der Version 1.x zu löschen -- PmWiki kann problemlos parallel dazu arbeiten. Außerdem ist es gut, eine Sicherungskopie zu haben.

Schritt 8: Wenn Sie zuversichtlich sind, dass die "PmWiki 2.0"-Website Ihren eigenen Ansprüchen genügend eingerichtet ist, können Sie die alte 1.x-Webseite abschalten und stattdessen die neue 2.0-Webseite nutzen. Wenn Sie feststellen, dass Ihnen die Version 2.0 nicht gefällt, ist die 1.x-Webseite immer noch intakt geblieben und kann weiter verwendet werden.

Schritt 9: Wenn Ihre alte Installation ein Verzeichnis uploads/ hatte, wollen Sie dieses vermutlich an den neuen Ort kopieren oder verschieben.

Verweise auf externe Seiten

• Fix Links in wiki pages from version 0.4.23 to 2.2.1 with UEDIT

Der folgende Link ist nur in der deutschen Doku aufgeführt

• siehe auch: PmWiki2 Konfigurationshinweise (Winfried Mueller)

<< | Dokumentationsindex | >> für die Liste aller Seiten