Wie kann ich in TortoiseSVN eine Datei oder einen Ordner „unversionieren“ und gleichzeitig zur Ignorierliste hinzufügen?
- Einleitung
- Die Bedeutung von unversionieren und ignorieren
- Vorgehensweise mit TortoiseSVN
- Beispiel
- Zusammenfassung
Einleitung
In der Versionskontrolle mit Subversion (SVN) kann es Situationen geben, in denen man versehentlich eine Datei oder einen Ordner zum Repository hinzugefügt hat, diese aber eigentlich nicht versionieren möchte. TortoiseSVN, ein beliebter Windows-Client für SVN, bietet die Möglichkeit, solche Dateien oder Ordner unversioniert zu machen und gleichzeitig dafür zu sorgen, dass sie in Zukunft ignoriert werden. Dies verhindert, dass diese Elemente erneut unerwünscht ins Repository gelangen. Im Folgenden wird Schritt für Schritt erläutert, wie man dies umsetzt.
Die Bedeutung von unversionieren und ignorieren
Der Begriff unversionieren bedeutet in diesem Zusammenhang, dass eine zuvor zum Repository hinzugefügte Datei oder ein Ordner wieder aus der Versionskontrolle entfernt wird. Dabei wird der lokale Eintrag aufgehoben, sodass Änderungen an dieser Datei nicht mehr verfolgt werden. Das Ignorieren hingegen sorgt dafür, dass die Subversion den angegebenen Pfad künftig automatisch überspringt und nicht mehr als nicht versioniert anzeigt, was das versehentliche Hinzufügen verhindert.
Vorgehensweise mit TortoiseSVN
Zunächst öffnet man im Windows-Explorer den Ordner, der die zu unversionierende Datei oder den Ordner enthält. Um eine Datei, die bereits versioniert ist, zu entfernen, kann man sie zunächst mit einem Rechtsklick aus dem Repository löschen, entweder über TortoiseSVN > Löschen oder direkt über das Kontextmenü. Wichtig ist, hierbei darauf zu achten, ob die Datei lokal behalten oder entfernt werden soll. Anschließend sollte man den Commit ausführen, um die Änderung im Repository zu speichern.
Um den Pfad danach zu ignorieren, wählt man die übergeordnete Ebene aus, also den Ordner, in dem sich die Datei oder der Ordner befindet. Durch einen Rechtsklick öffnet man im Kontextmenü TortoiseSVN > Einstellungen oder direkt Zum Ignorieren markieren. Dort kann man den Namen der Datei oder des Ordners eingeben oder auswählen und hinzufügen. Dadurch wird eine Einstellung in der Eigenschaft `svn:ignore` gesetzt, die Subversion anweist, diese Dateien künftig zu ignorieren.
Beispiel
Wenn man beispielsweise eine temporäre Datei namens debug.log versehentlich versioniert hat, sollte man diese zunächst mit TortoiseSVN > Löschen entfernen und dann committen. Danach klickt man auf den Ordner, klickt mit der rechten Maustaste, wählt TortoiseSVN > Ignore und fügt debug.log hinzu. Von nun an wird diese Datei bei Statusabfragen nicht mehr angezeigt und nicht ungewollt ins Repository aufgenommen.
Zusammenfassung
Das Unversionieren und Hinzufügen zur Ignorierliste ist ein zwei-geteilter Vorgang: Zuerst entfernt man die Datei oder den Ordner aus der Versionskontrolle durch Löschen und Committen, anschließend sorgt man mit der Ignorierfunktion von TortoiseSVN dafür, dass ähnliche Dateien in Zukunft automatisch ausgeschlossen werden. Diese Vorgehensweise verhindert, dass temporäre oder unerwünschte Dateien im Repository erscheinen und erleichtert die Pflege des Projektbestands erheblich.