Aktualisierungen

für die Liste aller Seiten

PmWiki erlaubt ein Upgrade, ohne bestehende und angelegte Wikiseiten oder Dateien zu beeinträchtigen. Für die meisten Upgrades kopiert man einfach die Dateien der neuen Version über die bestehende Installation.

Anmerkung für PmWiki 1.0-Seiten: Das Upgraden von 1.0.x zu 2.0 bedarf mehr als nur das einfache Kopieren der 2.0-Software über die 1.0-Installation. Siehe Umstieg von PmWiki V1 auf V2 für nähere Informationen.

Das Upgraden von PmWiki:

1. Lesen der 'release notes'

Wenn man auf eine neue größere Version umsteigt (eine Version wo sich die zweite Stelle ändert, wie von 0.5.27 zu 0.6.0), dann sollte man sorgfältig die PmWiki:ReleaseNotes lesen, bevor der Umstieg vollzogen wird. Es ist zu überprüfen, ob bedeutendende Änderungen oder Vorbereitungen vor dem Upgrade nötig sind. Das Upgrade von einer 2.0-Beta-Version ist einfach, ein Blick auf die PmWiki:ReleaseNotes schadet aber trotzdem nicht.

2. Backup

Es ist immer eine gute Maßnahme, vor dem Beginn der Aktion eine Sicherungskopie der laufenden PmWiki-Installation anzufertigen. Man kann das gesamte Verzeichnis, welches die bestehende Installation beinhaltet, kopieren, oder man sichert zumindest das wiki.d/ Verzeichnis und andere lokale Anpassungsdateien, die angelegt wurden (z.B., config.php, localmap.txt, usw.).

3. Herunterladen und entpacken

Laden Sie die gewünschte Version von PmWiki von der Download-Seite herunter.

Packen Sie das tar-Image mit tar xvfz tgzfile aus, wobei tgzfile die tar-Datei ist, die Sie vorher heruntergeladen haben. Diese wird ein Verzeichnis pmwiki-x.y.z mit der neuen Version der Software erzeugen. Unter Windows benutzen Sie hierfür z. B. das frei erhältliche Programm 7-Zip oder Sie laden die geringfügig größere Datei mit der Endung '.zip' herunter.

4. Kopieren

Kopieren Sie die Dateien in pmwiki-x.y.z über die Dateien ihrer bestehenden PmWiki-Installation. Wenn zum Beispiel Ihre laufende PmWiki-Installation in einem Verzeichnis namens pmwiki liegt, wäre eine Möglichkeit, die neuen Dateien über die existierenden mit folgendem Befehl zu kopieren:

Beachten Sie dabei, dass BSD-Systeme keine Option -a für cp als Befehlszeilen Argument kennen. Das ist aber kein Problem, weil es nur ein Kurzbefehl für cp -dpR ist. Hier wird also einfach dies statt -a verwendet.

Bei einigen FreeBSD-Servern und 'Mac OS X'-Systemen funktioniert statt dessen:

Sie können die Dateien auch mittels eines Programms zum Hochladen von Dateien auf Ihren Server übertragen, z. B. mit Filezilla oder WinSCP, wenn Sie mit Windows arbeiten. Möglicherweise haben Sie diese Programme schon zur Installation benutzt.

5. Aktualisieren der Anpassungen und Kochbuch-Rezepte

Das ist alles! Die Basis-Installation von PmWiki ist komplett.

Um herauszufinden, welche Kochbuch-Rezepte aktualisiert werden können, benutzen Sie PmWiki:Site Analyzer.

So lange keine Veränderungen am pmwiki.php Skript oder in den Dateien in scripts/ vorgenommen wurden, sollte die PmWiki-Installation einwandfrei laufen! (Änderungen an diesen Dateien sind nicht empfohlen.)

Lokale Einstellungen sollten in local/config.php, pub/css und pub/skins/SkinName vorgenommen werden.

Hinweis: Zusätzliche Tipps sind auf der Seite Troubleshooting? zu finden.

Upgrading von Version 2.1.27 auf 2.2.0

Zwischen der stabilen Version 2.1.27 und 2.2.0 gibt es einige Neuerungen. Einige von ihnen könnten Anpassungen in lokalen Konfigurationsdateien oder in Wikiseiten nötig machen. Diese sind hier umrissen. Für die vollständige Liste an Änderungen sehen Sie in den ReleaseNotes? nach.

Wenn Sie von einer 2.2.beta-Version upgraden, könnte Ihr Wiki diese Features bereits enthalten.

• Einige Seiten, die früher in der Site.*-Gruppe waren, sind nun in einer separaten lese-geschützten SiteAdmin.*-Gruppe: Site.AuthUser, Site.AuthList, Site.NotifyList, Site.Blocklist, und Site.ApprovedUrls. Wenn Sie von einer früheren Version upgraden, wird PmWiki diese Dateien an ihren neuen Ort verschieben, falls das nötig ist (nach einer Bestätigung durch Sie). Wenn eine Site die alte Site.*-Gruppe für diese Dateien erhalten möchte, setzen Sie einfach $SiteAdminGroup = $SiteGroup; in die config.php-Datei.
• Um Lesen oder Schreiben in den geschützten Bereichen zu autorisieren, sollte das frühere Passwort "nopass" jetzt durch "@nopass" ersetzt werden.
• Wikiworte sind nun standardmäßig deaktiviert. Um sie zu reaktivieren, setzen Sie entweder $LinkWikiWords oder $EnableWikiWords auf 1.
• Die $ROSPatterns-Variable hat sich geändert — Ersatzstrings werden nicht länger durch FmtPageName() geschleust, das muss nun explizit gemacht werden.
• Seitenverweise? innerhalb eingefügter Seiten, Sidebars, Headers oder Footers werden nun als relativ zu der Seite behandelt, in der sie geschrieben stehen, anstatt relativ zu der Seite, in der sie erscheinen. In Site.SideBar zum Beispiel setzen Sie immer die Gruppe in einem WikiLink wie [[Main/HomePage]] oder mit einer Seitenvariablen [[{*$Group}/Homepage]], weil ein Verweis [[HomePage]] auf die Seite Site.HomePage verweisen wird.
• PageLists?
  • Leerzeichen trennen Muster mit Jokerzeichen (wildcard patterns) nicht länger voneinander — benutzen Sie Kommata.
  • {$PageCount}-, {$GroupCount}- und {$GroupPageCount}-Variablen, die in Seitenlistenvorlagen benutzt werden, sind nun {$$PageCount}, {$$GroupCount} und {$$GroupPageCount}.
  • Die Direktive akzeptiert Parameter von dem URL nicht länger standardmäßig. Um sie zum Akzeptieren solcher Parameter zu bewegen (was in Version 2.2 und früher Standard war), fügen Sie zur (:pagelist:)-Direktive eine request=1-Option hinzu.
• Skin templates erfordern nun die <!--HTMLHeader-->- und <!--HTMLFooter-->-Direktiven.
• Authentifizierung mittels Active Directory ist nun vereinfacht, siehe PmWiki.AuthUser.

Upgrading von version 2.2.0 zur jüngsten Version

Einige Neuerungen seit der Version 2.2.0 könnten Änderungen an lokalen Konfigurationsdateien oder an Wikiseiten erforderlich machen. Diese sind hier umrissen. Für die vollständige Liste an Änderungen sehen Sie in den ReleaseNotes? und im change log? nach.

• Version 2.2.10: $EnableRelativePageVars wurde geändert, um standardmäßig aktiv zu sein. Das wirkt sich auf Seitenspezifische Variablen von eingefügten Seiten, Sidebars, Headers und Footers aus.
  • Die Form {*$var} bezieht sich auf die "aktuell betrachtete Seite", wogegen sich {$var} ohne den Stern auf die physikalische Seite bezieht, in der die Seitenvariable steht.
  • Seiten, die entworfen wurden, um auf der "aktuell betrachteten Seite" zu funktionieren, sollten {*$FullName} anstelle von {$FullName} benutzen. Administratoren sollten jegliche selbst angepasste Version der Seiten Site.PageActions, Site.EditForm, Site.PageNotFound, SideBar-Seiten, $GroupHeaderFmt, $GroupFooterFmt, PageLists? in Sidebars, Headers und Footers inspizieren. Siehe spezielle Referenzen.
  • Wenn Ihr Wiki stark auf das frühere Verhalten angewiesen ist, können Sie dahin zurückkehren, siehe $EnableRelativePageVars.
• Version 2.2.35: Wichtige Änderung für internationale Wikis: Die XLPage()-Funktion lädt nicht länger 'encoding scripts' wie xlpage-utf-8.php. Wenn Sie upgraden, müssen Sie diese Skripten mittels der config.php-Datei aufrufen, bevor der Aufruf von XLPage() passiert:

    include_once("scripts/xlpage-utf-8.php"); # wenn Ihr Wiki UTF-8 benutzt
    XLPage('bg','PmWikiBg.XLPage');
  

FAQ

    $WikiLibDirs = array(&$WikiDir,
      new PageStore('/path/to/existing/wiki.d/{$FullName}'),
      new PageStore('wikilib.d/{$FullName}'));

für die Liste aller Seiten