SVN-Checkout mit ToirtoiseSVN - Wiki

Die Installation ist denkbar einfach: Abhängig vom Windows-Betriebssystem die 32bit- oder 64bit herunterladen und der Installations-Routine folgen. Hat man die Installation abgeschlossen und (wie unter Windows üblich) den Rechner neu gestartet kann man auch schon loslegen.

ToirtoiseSVN integriert sich vollständig in Windows und ist somit überall verfügbar. Man kann sich also einen beliebigen Ordner anlegen, rechtsklick auf den Ordner und findet dort das ToirtoiseSVN Menu. Unter Settings kann man sich das ganze noch ein wenig an seine eigenen Bedürfnisse anpassen, aber das soll erst mal weniger interessieren. Ein neuer Menu-Punkt ist "SVN Checkout...", und das ist hierbei der eigentlich relevante Punkt für uns.

Klickt man drauf, öffnet sich ein Fenster. Hier kann man nun als erstes die Repository-URL eingeben. Diese findet man auf der Assembla Seite von ImpressCMS. Für einen SVN Checkout der Version 2.0 einfach ein Checkout des trunk Ordners: "https://subversion.assembla.com/svn/impresscms/trunk", für die Mitverfolgung der aktuellen 1.3.x-Entwicklung bitte "https://subversion.assembla.com/svn/impresscms/branches/impresscms_1.3/" eingeben. Unter Checkout directory kann man entweder das gewählte lassen oder man navigiert zu einem anderen Verzeichnis, das einem beliebt. Den Rest lässt man einfach, wie es ist. Es gibt hier noch die Auswahl, in welcher Ordnertiefe, welche Revision man herunterladen möchte. Da wir die aktuelle Revisionsnummer wollen, um auch realistisch zu testen, bleiben wir bei "Head Revision" und fully recursive um alle Dateien und Ordner innerhalb des gewählten Pfades zu bekommen.

Nachdem man mit OK bestätigt hat, fängt das Programm nun an, alle Dateien aus dem gewählten Pfad in den Ordner zu kopieren. Gerade beim Core dauert das eine kleine Weile. Ist man damit fertig, sieht man in dem Ordner seine ganzen Unterordner/Dateien mit einem grünen Häkchen versehen, was im Prinzip nichts weiter heißt, als dass man an der Dateiversion keine Änderungen vorgenommen hat. Würde man eine der Dateien ändern, findet man statt dem grünen Häkchen ein rotes Ausrufezeichen (abhängig vom gewählten Icon-Set..). Dieses rote Ausrufezeichen heißt, dass entweder die Datei, eine Ordnereinstellung oder der Inhalt eines Ordners nicht mehr mit der Original-Version übereinstimmt. Allerdings trifft das nur auf lokale Änderungen zu und nicht auf Änderungen im Repository.

Das Programm bietet einem nun verschiedene Möglichkeiten mit den Dateien an. Mal angenommen, wir hätten den Checkout beispielsweise nach D:\icms\icms_1.3\ gemacht, der Webserver liegt unter D:\xampp\htdocs\, da wir erst mal nicht mit der checkout-Version installieren wollen. Klickt man nun (rechtsklick) auf den Checkout-Ordner, findet man "SVN Export" in seinem Menu (abhängig von den Einstellungen direkt im Menu oder als Unterpunk in ToirtoiseSVN). Daraufhin öffnet sich nun erneut ein Fenster, in dem man den Export-Ordner wählen kann. Hier kann man nun seinen Export-Ordner wählen, bestätigen und das Programm packt alle Dateien in den gewählten Ordner. Hier nun ohne Check auf Änderungen. Also keine kleinen Häkchen mehr. Ist man neu in dem Programm kann das von Vorteil sein, da sich bei der Installation verschiedene Dateien und Ordner ändern.

Ok, setzen wir den Fall, wir hätten das checkout direkt in unseren Webserver (D:\xampp\htdocs\icms13\gemacht und führen die Installation nach dem Checkout durch. Nun wird man feststellen, dass man z.B. an der mainfile.php, an dem (vermutlich leeren Ordner) istall sowie den Ordnern cache, templates_c und modules ein rotes Ausrufezeichen findet, anstatt eines Häkchens. Das liegt einfach an der Installation von ImpressCMSund kann so weit ignoriert werden. Dem Programm kann man das auch mitteilen, dass man das ignorieren möchte. Beispielsweise ein rechtsklick auf mainfile.php -> "unversion and add to ignore list" auswählen und das Programm ignoriert künftig die mainfile.php. Die Ordner kann man ignorieren oder es so lassen wie es ist. Würde man die Dateien Aktualisieren bekommt man zwar von ImpressCMS eine Meldung, dass der insallationsordner noch vorhanden ist, aber ansosnten hat man weiter keine Nachteile davon. Ein Rücksetzen der mainfile.php hätte jedoch zur folge, dass das System neu installieren möchte, was zu Tests nun wenig beiträgt.

Wollen wir uns also als nächstes das Rücksetzen der Dateien anschauen. Eine Datei, die geändert wurde soll wieder in den ursprünglichen Zustand versetzt werden: Dafür bietet das Programm die Funktion "SVN Revert" aus, und man bekommt die Datei wieder so, wie sie sich bei Assembla befindet. Praktisch, wenn man nur etwas testen wollte und das nun wieder Rückgängig machen will.

Weiß man entweder, dass sich Dateien im SVN Server geändert haben oder will schauen, ob dem so ist, geht man auf den zu prüfenden Ordner (z.B. libraries oder auch den haupt-Ordner, in dem sich der Checkout befindet) und wählt unter rechtsklick "SVN Update" aus. Nun prüft das System auf neue/geänderte Dateien auf dem Server und aktualisiert die lokalen Dateien. Eine weitere nützliche Funktion in Bezug auf updates aus dem Server mag hier noch "update to revision" sein. Vorhin haben wir quasi ein checkout der Head-Revision gemacht, also der aktuellsten Version. Mal angenommen, man hat ein update dieser version gemacht, bekommt aber plötzlich eine Weiße seite, einen Fatal error oder ähnliches, so kann man nun auf die vorherige Revision oder eine andere zurückgehen. In der Entwicklungsversion kann dies zumindest mal vorkommen, wenn es auch nicht gerade Gang ung Gebe ist, dass sich die Trunk-Version nicht nutzen lässt.

So, das sind nun erst mal die Grundzüge, um mit ToirtoiseSVN schnell einsteigen zu können. Bei Fragen/Problemen bitte jederzeit im Forum anfragen. Hilfe kann man jederzeit bekommen.