Aktualisierungen
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:
cp -a pmwiki-x.y.z/. pmwiki
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:
cp -Rpv pmwiki-.x.y.z/. pmwiki
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 Problemlösungen 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
in die config.php-Datei.⚠ $SiteAdminGroup = $
SiteGroup; - 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. - Seitenlisten
- 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 einerequest=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, Seitenlisten 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
.
- Die Form
- 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
Wie kann ich herausfinden, welche Version von PmWiki bei mir läuft?
Siehe Version - So findet man die Version von PmWiki heraus..
Wie kann ich eine neue Version von PmWiki testen, ohne die vorige Version zu ändern, die die Besucher benutzen?
Der leichte Weg, das zu tun, ist, die neue Version in einem separaten Verzeichnis zu installieren und in deren local/config.php-Datei das Folgende einzufügen:
$WikiLibDirs = array(&$WikiDir, new PageStore('/path/to/existing/wiki.d/{$FullName}'), new PageStore('wikilib.d/{$FullName}'));
Wenn Seiten aufgerufen werden, werden sie (vorausgesetzt, an den Standardnamen wurde nichts geändert) der Reihe nach in wiki.d, /path/to/existing/wiki.d/ und wikilib.d gesucht. Der erste Fund wird dann geladen. Gespeichert wird das Ergebnis immer in wiki.d.
Das lässt Sie die neue Version mit existierenden Seiteninhalten testen, ohne Auswirkungen auf die existierende Site und ohne Modifikationen an den Seiten zu riskieren. (Natürlich müssen auch alle Rezepte und lokale Anpassungen in der neuen Version installiert werden.)
Wenn Sie dann irgendwann zufrieden mit der neuen Version sind und alles so zu funktionieren scheint wie in der alten Version, ist es sicher, die alte Version auf die neue upzugraden (und man kennt alle Konfigurations- und Seitenänderungen, die notwenig gemacht werden müssen.)
Übersetzung von PmWiki.Upgrades, Originalseite auf PmWikiDe.Upgrades — Rückverweise
Zuletzt geändert: | PmWikiDe.Upgrades | am 10.01.2020 |
PmWiki.Upgrades | am 21.11.2022 |