Diese Seite erklärt den grundlegenden Umgang mit TortoiseSVN. Eine umfassende Dokumentation ist auf der Projektseite zu finden.

Mit TortoiseSVN ist es möglich lokale Repositories an einem beliebigen Ort auf dem Dateisystem zu erstellen. Diese sind jedoch nur für den Eigengebrauch geeignet und sollten nicht über ein Netzlaufwerk mit anderen gemeinsam verwendet werden. Grund für diese Einschränkung sind die fehlenden Lock-Funktionen der Windows-Dateisysteme. Dadurch kann das Repository unbrauchbar gemacht werden, wenn zwei Personen gleichzeitig einen Commit durchführen! Praktisch sind diese privaten Repositories jedoch, da man dadurch jederzeit wieder zu einer früheren Version zurückkehren kann und man die Änderungsschritte automatisch dokumentiert hat (natürlich nur wenn man die Änderungsmitteilung immer brav ausfüllt).

Ein Repository erstellen ist relativ einfach: Gewünschen Ordner aussuchen, Rechtsklick → TortoiseSVN → Create repository here. Anschliessend muss nur noch eine lokale Arbeitskopie erstellt werden.

Wird ein Projekt von mehreren Personen bearbeitet, eignet sich ein solches Repository nicht. Für eine einfach und sichere Zusammenarbeit stellt die NTB einen SVN-Server zur Verfügung.

Eine lokale Arbeitskopie kann in jedem beliebigen Ordner erstellt werden: Rechtsklick auf den Ordner → SVN Checkout…. In der daraufhin erscheinenden Maske muss nur noch die URL zum Repository angegeben werden. Befindet sich das Repository auf dem NTB-SVN-Server sieht die URL z.B. so aus: https://svn.ntb.ch/svnba/RepositoryName. Bei einem lokalen Repository z.B. so: file:///D:/work/SVN/WasAuchImmer.

Es ist wichtig, die lokale Arbeitskopie stets aktuell zu halten. Dazu wird ein sogenanntes update durchgeführt. Dies wird wie folgt gemacht: Rechtsklick auf den obersten Ordner → SVN Update.

Hat man in der lokalen Arbeitskopie Änderungen gemacht, sollten diese regelmässig wieder ins Repository übermittelt werden. Dazu wird ein sogenannter commit durchgeführt: Rechtsklick auf den obersten Ordner → SVN Commit. Anschliessend werden alle Dateien aufgelistet, die sich vom Repository unterscheiden. Man wählt diejenigen an, welche übertragen werden sollen, gibt einen Kommentar ein und klickt auf OK.

Ändert sich die URL von einem Repository, kann kein Update/Commit mehr ausgeführt werden. Um dieses Problem zu lösen muss TortoiseSVN mitgeteilt werden, wohin das Verzeichnis verschoben wurde. Dazu gibt es die Funktion Relocate:

1. Rechtsklick auf die lokale Arbeitskopie → TortoiseSVN → Relocate
2. URL anpassen und mit OK speichern
3. Update und Commit sollten nun wieder funktionieren.