UpgradingFromPmWiki1
Umstieg von PmWiki Version 1 auf PmWiki Version 2
(deutsche Übersetzung der Seite PmWiki.UpgradingFromPmWiki1, Stand 12.Dez 2004)
Diese Seite gibt einen Einblick für das Umsteigen von einer laufenden PmWiki 1.x Installation, um PmWiki 2.0 benutzen zu können. Auf dieser Seite gehen wir davon aus, daß schon eine vom Administrator eingerichtete Website mit PmWiki 1.x oder noch früheren Version in einer Standardkonfiguration läuft, die zu 2.0 umgewandelt werden soll.
Wie üblich können Fragen und Hilfeersuchen an die PmWiki-Benutzer Mailing-Liste geschickt werden. Fehler und Schwierigkeiten mit den unten beschriebenen Verfahren können hier verbessert werden, oder Du trägst 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 Wiki Administrator 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 zu Installieren, zu Konfigurieren und PmWiki 2.0 mit einem, vom alten Wiki erzeugten Seitensatz auszuprobieren, ohne die gesamte 1.x Installation gefährden zu müssen.
Schritt 0: Es ist, wie immer, eine gute Vorgehensweise eine Sicherungskopie Deiner laufenden PmWiki 1.x Installation anzufertigen, bevor irgendetwas anderes passieren soll -- das gilt insbesondere für die Dateien in der Verzeichnissen local/ und wiki.d/.
Schritt 1: Installiere PmWiki 2.0 in ein neues von 1.x getrenntes Verzeichnis
Schritt 2: Teste kurz die PmWiki 2.0 Installation und überzeuge Dich vom ordnungsgemäßen Verhalten des Programms - beispielsweise kannst Du ein paar Seiten verändern und speichern. Danach entfernst Du die von Dir veränderten Seiten wieder (Du kannst einfach die gerade erzeugten Dateien aus dem PmWiki 2.0 wiki.d/ Verzeichnis herausnehmen oder das ganze PmWiki 2.0 wiki.d/ Verzeichnis löschen).
Schritt 3: Füge die folgenden Zeilen zu der local/config.php -Datei der 2.0 Installation dazu und ersetze die unten stehende Pfadangabe "/path/to/pmwiki1/wiki.d" mit dem Stelle, wo das wiki.d/ Verzeichnis auf der Festplatte Deiner PmWiki 1.x Installationen steht.
include_once("$FarmD/scripts/compat1x.php");
UseV1WikiD("/path/to/pmwiki1/wiki.d");
Zum Beispiel, meine 2.0 Test Umwandlung gebraucht:
include_once("$FarmD/scripts/compat1x.php");
UseV1WikiD("/home/pmichaud/pmwiki/wiki.d");
Schritt 4: Nach der obigen Änderung sollten alle Deine existierenden Seiten in der neuen 2.0 Installation auftauchen. Mehr noch, wenn Du auf "Bearbeiten" irgendeiner der vorhandenen Seiten klickst, solltest Du sehen, daß alle PmWiki 1.x Formatierungsanweisungen (Verweise, usw.) in die neue Sprache der Formatierungsanweisungen umgewandelt worden sind.
Alle Seiten, die mit der PmWiki 2.0 Installation bearbeitet/gespeichert werden, werden getrennt von den Seiten der vorigen Installation gehalten. Auf diese Weise kannst Du sicher mit dem Bearbeiten und Verändern der Seiten auf der neuen Website experimentieren, ohne die laufende 1.x Website zu beeinflussen.
Schritt 5: Wenn Du erstmal siehst, daß Deine vorhandenen Seiten in der 2.0 Installation verfügbar sind, kannst Du mit dem Rest der 2.0 Websiteanpassung fortfahren, wie in den ersten Einstellungen erklärt, um alle gewünschten lokale Anpassungen vorzunehmen. Viele lokale Anpassungen (z.B. Seitenlayout-Vorlagen) bleiben gleich zwischen 1.x und 2.0, andere, wie in "Formatierungsanweisungen anpassen" oder Kochbuch-Rezepte beschrieben, müssen ebenfalls an 2.0 angepaßt werden.
Schritt 6: Mache mit der neuen Installation so weiter, als würdest Du eine neue PmWiki-Website errichten. Wenn Du PmWiki 1.x Formatierungsanweisungen findest, die nicht oder falsch umgewandelt worden sind, schreibe bitte einen neuen PITS Eintrag, so daß wir das Umwandlungsskript verbessern können.
Schritt 7: Wenn Du mit der Umwandlung zufrieden bist und damit weiter machen möchtest und alle 1.x Seiten auf das 2.0 Format bringen willst, so ändere den weiter oben beschrieben UseV1WikiD(...) Befehl in der local/config.php-Datei statt dessen zu ConvertV1WikiD(...), so wie hier beschrieben:
include_once("$FarmD/scripts/compat1x.php");
ConvertV1WikiD("/path/to/pmwiki1/wiki.d");
Wenn das pmwiki.php läuft wirst Du mit ein paar Formularen konfrontiert, die es Dir dann erlauben massenweise viele oder alle Deiner 1.x Seiten in das 2.0 Format zu migrieren. Nachdem Du die Seiten umgewandelt hast, kannst Du die beiden Zeilen von Deiner Konfiguration wieder entfernen, so daß Deine PmWiki 2.0 nun eigenständig läuft.
Wir weisen darauf hin, daß Du nicht alle Seiten umwandeln mußt um das 1.x wiki.d/-Verzeichnis loszuwerden -- PmWiki kann problemlos mit ihm zusammenleben. Es ist einfach gut eine Sicherungskopie zu behalten.
Schritt 8: Wenn Du Dir die PmWiki 2.0 -Website gut eingerichtet hast, so daß sie all Deinen Bedürfnissen entspricht, kannst Du die alte 1.x Website von der neuen 2.0 Website abtrennen. Oder Du kommst Du dem Schluß, daß die Version 2.0 nichts für Dich ist, so daß Du die immer noch intakt gebliebene 1.x Website wie gewohnt weiter benutzen kannst.
<< Changes from PmWiki 1? | PmWikiDe.DokumentationsIndex | >>