Übersetzung fertig gestellt

Author: max123kl

book/07-git-tools/sections/submodules.asc

@@ -783,17 +783,17 @@ $ git commit -am 'Fast forward to a common submodule child'
 
 Damit wird dasselbe erreicht, aber zumindest können Sie auf diese Weise überprüfen, ob es wirklich funktioniert und Sie haben den Code in Ihrem Submodul-Verzeichnis, wenn Sie fertig sind.
 
-==== Submodule Tips
+==== Tipps für Submodule
 
 There are a few things you can do to make working with submodules a little easier.
 
-===== Submodule Foreach
+===== Submodul Foreach
 
-There is a `foreach` submodule command to run some arbitrary command in each submodule.
-This can be really helpful if you have a number of submodules in the same project.
+Es gibt das Submodul-Kommando `foreach`, um in jedem Submodul ein beliebiges Kommando auszuführen.
+Das kann wirklich hilfreich sein, wenn Sie mehrere Submodule im gleichen Projekt haben.
 
-For example, let's say we want to start a new feature or do a bugfix and we have work going on in several submodules.
-We can easily stash all the work in all our submodules.
+Nehmen wir zum Beispiel an, wir wollen ein neues Feature starten oder einen Bugfix durchführen und arbeiten an mehreren Submodulen.
+Wir können leicht die gesamte Arbeit in all unseren Submodulen stashen.
 
 [source,console]
 ----
@@ -805,7 +805,7 @@ Saved working directory and index state WIP on stable: 82d2ad3 Merge from origin
 HEAD is now at 82d2ad3 Merge from origin/stable
 ----
 
-Then we can create a new branch and switch to it in all our submodules.
+Dann können wir einen neuen Branch erstellen und von allen unseren Submodulen zu diesem wechseln.
 
 [source,console]
 ----
@@ -816,8 +816,9 @@ Entering 'DbConnector'
 Switched to a new branch 'featureA'
 ----
 
-You get the idea.
-One really useful thing you can do is produce a nice unified diff of what is changed in your main project and all your subprojects as well.
+Sie verstehen die Idee dahinter?
+Eine wirklich sinnvolle Methode, die Ihnen hilft, ein gutes, einheitliches Diff zwischen den Änderungen in Ihrem Hauptprojekt und all Ihren Subprojekten zu erstellen.
+
 
 [source,console]
 ----
@@ -855,13 +856,13 @@ index 1aaefb6..5297645 100644
         struct strbuf out = STRBUF_INIT;
 ----
 
-Here we can see that we're defining a function in a submodule and calling it in the main project.
-This is obviously a simplified example, but hopefully it gives you an idea of how this may be useful.
+Hier können Sie sehen, dass wir eine Funktion in einem Submodul definieren und sie im Hauptprojekt aufrufen.
+Das ist natürlich ein vereinfachtes Beispiel, aber es gibt Ihnen hoffentlich eine Vorstellung davon, wie hilfreich das sein könnte.
 
-===== Useful Aliases
+===== Nützliche Aliase
 
-You may want to set up some aliases for some of these commands as they can be quite long and you can't set configuration options for most of them to make them defaults.
-We covered setting up Git aliases in <<ch02-git-basics-chapter#_git_aliases>>, but here is an example of what you may want to set up if you plan on working with submodules in Git a lot.
+Vielleicht möchten Sie Aliase für manche dieser Befehle einrichten, da sie ziemlich lang sein können und Sie können für die meisten dieser Befehle keine Konfigurationsoptionen festlegen, um sie zu Standardeinstellungen zu machen.
+Wir haben die Einrichtung von Git-Aliasen in <<ch02-git-basics-chapter#_git_aliases>> behandelt, hier ist aber ein Beispiel dafür, was Sie vielleicht einrichten sollten, wenn Sie viel mit Submodulen in Git arbeiten wollen.
 
 [source,console]
 ----
@@ -870,16 +871,16 @@ $ git config alias.spush 'push --recurse-submodules=on-demand'
 $ git config alias.supdate 'submodule update --remote --merge'
 ----
 
-This way you can simply run `git supdate` when you want to update your submodules, or `git spush` to push with submodule dependency checking.
+Auf diese Weise können Sie einfach `git supdate` ausführen, wenn Sie Ihre Submodule aktualisieren wollen, oder `git spush`, um einen Push mit der Überprüfung der Submodul-Abhängigkeiten durchzuführen.
 
-==== Issues with Submodules
+==== Probleme mit Submodulen
 
-Using submodules isn't without hiccups, however.
+Die Verwendung von Submodulen ist jedoch nicht ohne Schwierigkeiten.
 
-===== Switching branches
+===== Branches wechseln
 
-For instance, switching branches with submodules in them can also be tricky with Git versions older than Git 2.13.
-If you create a new branch, add a submodule there, and then switch back to a branch without that submodule, you still have the submodule directory as an untracked directory:
+So kann beispielsweise das Wechseln von Branches mit darin enthaltenen Submodulen bei älteren Git-Versionen (vor Git 2.13) ebenfalls knifflig sein.
+Wenn Sie einen neuen Branch erstellen, dort ein Submodul hinzufügen und dann wieder zu einem Branch ohne dieses Submodul wechseln, haben Sie darin das Submodul-Verzeichnis immer noch als ungetracktes Verzeichnis:
 
 [source,console]
 ----
@@ -915,8 +916,8 @@ Untracked files:
 nothing added to commit but untracked files present (use "git add" to track)
 ----
 
-Removing the directory isn't difficult, but it can be a bit confusing to have that in there.
-If you do remove it and then switch back to the branch that has that submodule, you will need to run `submodule update --init` to repopulate it.
+Das Entfernen des Verzeichnisses ist nicht schwierig, aber es kann etwas verwirrend sein, das darin enthalten zu haben.
+Wenn Sie es entfernen und dann wieder zu dem Branch wechseln, der dieses Submodul besitzt, müssen Sie `submodule update --init` ausführen, um es neu zu befüllen.
 
 [source,console]
 ----
@@ -935,9 +936,9 @@ $ ls CryptoLibrary/
 Makefile	includes	scripts		src
 ----
 
-Again, not really very difficult, but it can be a little confusing.
+Auch das ist nicht wirklich schwierig, aber es kann ein wenig verwirrend sein.
 
-Newer Git versions (Git >= 2.13) simplify all this by adding the `--recurse-submodules` flag to the `git checkout` command, which takes care of placing the submodules in the right state for the branch we are switching to.
+Neuere Git-Versionen (ab Git 2.13) vereinfachen das alles, indem sie das Flag `--recurse-submodules` zum Befehl `git checkout` hinzufügen, der sich darum kümmert, die Submodule in den richtigen Zustand für den Branch zu bringen, auf den wir wechseln.
 
 [source,console]
 ----
@@ -967,21 +968,22 @@ Your branch is up-to-date with 'origin/master'.
 nothing to commit, working tree clean
 ----
 
-Using the `--recurse-submodules` flag of `git checkout` can also be useful when you work on several branches in the superproject, each having your submodule pointing at different commits.
-Indeed, if you switch between branches that record the submodule at different commits, upon executing `git status` the submodule will appear as ``modified'', and indicate ``new commits''. That is because the submodule state is by default not carried over when switching branches.
+Die Verwendung des Flags `--recurse-submodules` mit `git checkout` kann auch praktisch sein, wenn Sie auf mehreren Branches im Hauptprojekt arbeiten, wobei jedes Ihrer Submodule auf unterschiedliche Commits zeigt.
+Tatsächlich, wenn Sie zwischen den Branches wechseln, die das Submodul bei verschiedenen Commits erfassen, wird das Submodul bei der Ausführung von `git status` als „modifiziert“ erscheinen und „neue Commits“ anzeigen.
+Das liegt daran, dass der Submodul-Status beim Wechseln der Branches standardmäßig nicht mit übertragen wird.
 
-This can be really confusing, so it's a good idea to always `git checkout --recurse-submodules` when your project has submodules.
-(For older Git versions that do not have the  `--recurse-submodules` flag, after the checkout you can use `git submodule update --init --recursive` to put the submodules in the right state.)
+Das kann äußerst verwirrend sein, deshalb ist es besser, immer den Befehl `git checkout --recurse-submodules` zu verwenden, wenn Ihr Projekt Submodule hat.
+(Für ältere Git-Versionen, die das Flag `--recurse-submodules` nicht kennen, verwenden Sie nach dem Auschecken `git submodule update --init --recursive`, um die Submodule in den richtigen Zustand zu versetzen.)
 
-Luckily, you can tell Git (>=2.14) to always use the  `--recurse-submodules` flag by setting the configuration option `submodule.recurse`: `git config submodule.recurse true`.
-As noted above, this will also make Git recurse into submodules for every command that has a `--recurse-submodules` option (except `git clone`).
+Glücklicherweise können Sie Git (≥2.14) anweisen, immer das Flag `--recurse-submodules` zu verwenden, indem Sie die Konfigurationsoption `submodule.recurse` setzen mit: `git config submodule.recurse true`.
+Wie oben schon erwähnt, wird das auch dazu führen, dass Git in Submodulen jeden Befehl entsprechend umwandelt, der eine `--recurse-submodules` Option hat (außer bei `git clone`).
 
-===== Switching from subdirectories to submodules
+===== Wechseln von Unterverzeichnissen zu Submodulen
 
-The other main caveat that many people run into involves switching from subdirectories to submodules.
-If you've been tracking files in your project and you want to move them out into a submodule, you must be careful or Git will get angry at you.
-Assume that you have files in a subdirectory of your project, and you want to switch it to a submodule.
-If you delete the subdirectory and then run `submodule add`, Git yells at you:
+Die andere Warnung, die viele Anwender zu beachten haben, ist der Wechsel von Unterverzeichnissen zu Submodulen.
+Wenn Sie Dateien in Ihrem Projekt getrackt haben und sie in ein Submodul verschieben wollen, müssen Sie vorsichtig sein, sonst wird Git Ihnen das nicht verzeihen.
+Angenommen, Sie haben Dateien in einem Unterverzeichnis Ihres Projekts und wollen es in ein Untermodul verschieben.
+Wenn Sie das Unterverzeichnis löschen und dann `submodule add` ausführen, wird Git Sie etwa so anbrüllen:
 
 [source,console]
 ----
@@ -990,8 +992,8 @@ $ git submodule add https://github.com/chaconinc/CryptoLibrary
 'CryptoLibrary' already exists in the index
 ----
 
-You have to unstage the `CryptoLibrary` directory first.
-Then you can add the submodule:
+Sie müssen zuerst das `CryptoLibrary` Verzeichnis aus der Staging-Area entfernen (engl. unstage).
+Danach können Sie das Submodul hinzufügen:
 
 [source,console]
 ----
@@ -1005,8 +1007,8 @@ Unpacking objects: 100% (11/11), done.
 Checking connectivity... done.
 ----
 
-Now suppose you did that in a branch.
-If you try to switch back to a branch where those files are still in the actual tree rather than a submodule – you get this error:
+Nehmen wir jetzt an, Sie hätten das in einer Branch getan.
+Wenn Sie versuchen, wieder zu einer Branch zu wechseln, in der sich diese Dateien noch im aktuellen Verzeichnisbaum und nicht in einem Submodul befinden, erhalten Sie diesen Fehler:
 
 [source,console]
 ----
@@ -1019,7 +1021,7 @@ Please move or remove them before you can switch branches.
 Aborting
 ----
 
-You can force it to switch with `checkout -f`, but be careful that you don't have unsaved changes in there as they could be overwritten with that command.
+Sie können den Wechsel mit `checkout -f` erzwingen, aber achten Sie darauf, dass dort keine ungesicherten Änderungen enthalten sind, weil diese mit dem Befehl überschrieben werden könnten.
 
 [source,console]
 ----
@@ -1028,10 +1030,10 @@ warning: unable to rmdir CryptoLibrary: Directory not empty
 Switched to branch 'master'
 ----
 
-Then, when you switch back, you get an empty `CryptoLibrary` directory for some reason and `git submodule update` may not fix it either.
-You may need to go into your submodule directory and run a `git checkout .` to get all your files back.
-You could run this in a `submodule foreach` script to run it for multiple submodules.
+Dann, wenn Sie zurückwechseln, erhalten Sie aus bestimmten Gründen ein leeres `CryptoLibrary` Verzeichnis, und `git submodule update` kann es auch nicht beheben.
+Möglicherweise müssen Sie in Ihr Submodul-Verzeichnis gehen und `git checkout .` ausführen, um alle Ihre Dateien zurück zu bekommen.
+Sie könnten das mit einem `submodule foreach` Skript erledigen, um es für mehrere Submodule anzuwenden.
 
-It's important to note that submodules these days keep all their Git data in the top project's `.git` directory, so unlike much older versions of Git, destroying a submodule directory won't lose any commits or branches that you had.
+Es ist wichtig zu wissen, dass Submodule heute alle ihre Git-Daten im `.git`-Verzeichnis des Hauptprojekts speichern, so dass im Gegensatz zu vielen älteren Git-Versionen, mit dem Löschen eines Submodul-Verzeichnisses keine Commits oder Branches verloren gehen, die Sie zuvor schon hatten.
 
-With these tools, submodules can be a fairly simple and effective method for developing on several related but still separate projects simultaneously.
+Mit diesen Werkzeugen können Submodule eine ziemlich einfache und effektive Methode sein, um an mehreren verwandten, aber dennoch unterschiedlichen Projekten gleichzeitig zu entwickeln.

status.json

@@ -73,7 +73,7 @@
       "sections/searching.asc": 100,
       "sections/signing.asc": 100,
       "sections/stashing-cleaning.asc": 100,
-      "sections/submodules.asc": 20,
+      "sections/submodules.asc": 100,
       "sections/subtree-merges.asc": 100
     },
     "08-customizing-git": {