📝 Add the removal of git lfs

Author: veit

CHANGELOG.rst

@@ -16,6 +16,14 @@ Notfälle, wenn Zweige für ältere Versionen erstellt werden müssen.
 
 .. _changelog
 
+`Unreleased <https://github.com/cusyio/Python4DataScience-de/compare/24.3.0...HEAD>`_
+------------------------------------------------------------------------------------
+
+Added
+~~~~~
+
+* 📝 Add the removal of git lfs
+
 `24.3.0 <https://github.com/cusyio/Python4DataScience-de/compare/24.2.0...24.3.0>`_: 2024-11-19
 -----------------------------------------------------------------------------------------------
 

docs/productive/git/advanced/index.rst

@@ -46,6 +46,7 @@ Fortgeschrittenes Git
    jupyter-notebooks
    binary-files
    batch
+   lfs
    vs-code/index
    gitlab/index
    git-big-picture

docs/productive/git/advanced/lfs.rst

@@ -0,0 +1,47 @@
+Git LFS entfernen
+=================
+
+Dienste wie GitHub bieten zwar `Git LFS <https://git-lfs.com>`_ für ihre
+Repositories an, diese dürfen jedoch nicht den zusätzlichen Storage von 1 GiB
+überschreiten. Zusätzliche Kontingente bei GitHub einzukaufen ist dann ziemlich
+teuer.
+
+.. seealso::
+   * `Informationen zur Speicher- und Bandbreitennutzung
+     <https://docs.github.com/de/repositories/working-with-files/managing-large-files/about-storage-and-bandwidth-usage>`_
+
+Nur wie wird man Git LFS in einem solchen Repository wieder los?
+
+Die folgenden Schritte ermöglichen, Git LFS wieder loszuwerden:
+
+#. Mit ``git lfs ls-files`` erhaltet ihr eine Liste aller Dateien, die von Git
+   LFS verwaltet werden.
+
+#. Als Nächstes sollten wir sicherstellen, dass alle großen Dateien ausgecheckt
+   sind mit
+
+   .. code-block:: console
+
+      $ git lfs fetch --all
+      $ git lfs checkout
+
+#. Entfernt die Git LFS-Filter:
+
+   #. Hierzu müssen zunächst Einträge, wie :abbr:`z.B. (zum Beispiel)`
+         ::samp:`*.{png} filter=lfs diff=lfs merge=lfs -text` aus eurer
+         :file:`.gitattributes`-Datei entfernt werden.
+   #. Anschließend könnt ihr für jeden gelöschten Eintrag in der
+      :file:`.gitattributes`-Datei :abbr:`z.B. (zum Beispiel)` mit :samp:`git
+      lfs untrack '*.{png}'` auch die Nachverfolgung durch Git beenden.
+
+      Alternativ könnt ihr auch ``cut -f 1 < .gitattributes | xargs "git lfs
+      untrack {}"`` für alle mit Git LFS verwalteten Dateien verwenden.
+
+   #. Schließlich sollten noch die Zeilenenden normalisiert werden mit ``git add
+      --renormalize .``.
+
+#. Nun kann Git LFS deinstalliert werden mit ``git lfs uninstall``.
+#. Schließlich müssen die Änderungen noch auf den Server übertragen werden.
+
+Nun könnt ihr :abbr:`z.B. (zum Beispiel)` zu :doc:`DVC <../../dvc/index>`
+wechseln, um damit große Dateien versioniert zu verwalten.