Upgrade von PmWiki 1

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.

Verfahren 1: Test-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 vorhadenen 1.x-Installation zu risikieren.

Schritt 0: Es ist, wie immer, eine gute Idee eine Sicherungskopie der laufenden PmWiki 1.x Installation anzufertigen, bevor irgendetwas anderes gemacht wird -- das gilt insbesondere für die Dateien in der 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 abspeichern. Danach entfernt man die gerade erzeugten Dateien wieder (aus dem wiki.d/-Verzeichnis von PmWiki 2.0 oder man löscht 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 man dann auf "Bearbeiten" irgendeiner der vorhandenen Seiten klickt, sollte man 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, kann man mit dem Rest der 2.0-Webseitenanpassung fortfahren, wie es in den ersten Einstellungen erklärt ist und kann 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 aktiviern, indem Sie $LinkWikiWords = 1; in config.php setzen oder Sie konvertieren Ihre WikiWort-Verweise manuall 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: Die neue Installation wird genau so weitergeführt, als würde man 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 man mit der Umwandlung zufrieden ist und nun alle 1.x-Seiten auf das 2.0-Format bringen will, dann sollte man den oben beschrieben 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 gestarte wird, erscheinene einige Formulare, die es ermöglichen, einige oder alle 1.x-Seiten in das 2.0-Format umzuwandeln. Nach der Umwandlung kann man 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 umwandeln 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 man zuversichtlich ist, dass die "PmWiki 2.0"-Webseite den eigenen Ansprüchen genügend eingerichtet ist, kann man die alte 1.x-Webseite abschalten und stattdessen die neue 2.0-Webseite nutzen. Wenn man feststellt, dass einem die Version 2.0 nicht gefällt, ist die 1.x-Webseite immer noch intakt gebliebene 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.

Der fogende Link ist nur in der deutschen Doku aufgeführt siehe auch: PmWiki2 Konfigurationshinweise (Winfried Mueller)

<< | Dokumentationsindex | >>

Übersetzung von PmWiki.UpgradingFromPmWiki1 Originalseite auf PmWikiDe.UpgradingFromPmWiki1 - Rückverweise
Zuletzt geändert:
PmWikiDe.UpgradingFromPmWiki1 am 10.09.2011
PmWiki.UpgradingFromPmWiki1 am 02.08.2012