Merge pull request #93 from max123kl/include-English-commits

max123kl · web-flow · commit 0269dd5fc0d8 · 2020-04-22T12:30:45.000+02:00
Including commits from English repo up to 2020_04_21
diff --git a/book/05-distributed-git/sections/contributing.asc b/book/05-distributed-git/sections/contributing.asc
@@ -465,7 +465,7 @@ Fast forward
 1 files changed, 9 insertions(+), 1 deletions(-)
 ----
 
-Schließlich möchte Jessica noch ein paar geringfügige Änderungen an dem gesamten, zusammengeführten Inhalt vornehmen. Sie kann diese Änderungen vornehmen, sie in ihren lokalen Branch `featureA` comitten und das Endergebnis zurück auf den Server übertragen.
+Schließlich möchte Jessica noch ein paar geringfügige Änderungen an dem gesamten, zusammengeführten Inhalt vornehmen. Sie kann diese Änderungen vornehmen, sie in ihren lokalen Branch `featureA` comitten und das Endergebnis zurück auf den Server übertragen:
 
 [source,console]
 ----
diff --git a/book/06-github/sections/1-setting-up-account.asc b/book/06-github/sections/1-setting-up-account.asc
@@ -14,7 +14,7 @@ Fahren Sie fort indem Sie die erhaltene E-Mail bestätigen; das ist ziemlich wic
 [NOTE]
 ====
 GitHub bietet fast alle Funktionen kostenlos an, mit Ausnahme einiger erweiterter Funktionen.
-Darüber hinaus sind private Repositorys auf 3 Mitarbeiter beschränkt.
+
 Die kostenpflichtigen Tarife von GitHub umfassen erweiterte Tools und Funktionen sowie erhöhte Limits für kostenlose Dienste. Diese werden in diesem Buch jedoch nicht behandelt.
 Weitere Informationen zu verfügbaren Tarifen und deren Vergleich erhalten Sie unter https://de.github.com/pricing.html[].
 ====
diff --git a/book/07-git-tools/sections/credentials.asc b/book/07-git-tools/sections/credentials.asc
@@ -164,9 +164,9 @@ Noch einmal zur Erinnerung: Wir werden diese Erweiterung in Ruby schreiben, aber
 Hier ist der vollständige Quellcode unseres neuen Anmeldehelfers:
 
 [source,ruby]
---------
+----
 include::../git-credential-read-only[]
---------
+----
 
 <1> Hier parsen wir die Befehlszeilenoptionen und erlauben dem Benutzer, die Eingabedatei zu spezifizieren.
     Die Vorgabe ist `~/.git-credentials`.
diff --git a/book/07-git-tools/sections/signing.asc b/book/07-git-tools/sections/signing.asc
@@ -51,7 +51,7 @@ user: "Ben Straub <ben@straub.cc>"
 Wenn Sie `git show` auf dieses Tag laufen lassen, können Sie Ihre GPG-Signatur daran angehängt sehen:
 
 [source,console]
---------
+----
 $ git show v1.5
 tag v1.5
 Tagger: Ben Straub <ben@straub.cc>
@@ -75,7 +75,7 @@ Author: Scott Chacon <schacon@gee-mail.com>
 Date:   Mon Mar 17 21:52:11 2008 -0700
 
     Change version numberr
---------
+----
 
 ==== Überprüfen der Tags
 
diff --git a/book/07-git-tools/sections/submodules.asc b/book/07-git-tools/sections/submodules.asc
@@ -688,7 +688,7 @@ Das müssen Sie einmischen und auflösen.
 Sie können entweder direkt versuchen, den Merge mit dem SHA-1 durchzuführen oder Sie können einen Branch dafür erstellen und dann versuchen, diesen zu verschmelzen.
 Wir empfehlen letzteres – und sei es nur, um eine bessere Merge-Commit-Meldung zu erhalten.
 
-Wir werden also in unser Submodul-Verzeichnis wechseln, einen Branch basierend auf diesem zweiten SHA-1 aus `git diff` erstellen und manuell mergen.
+Wir werden also in unser Submodul-Verzeichnis wechseln, einen Branch namens „try-merge“, basierend auf diesem zweiten SHA-1 aus `git diff` erstellen und manuell mergen.
 
 [source,console]
 ----
@@ -698,7 +698,8 @@ $ git rev-parse HEAD
 eb41d764bccf88be77aced643c13a7fa86714135
 
 $ git branch try-merge c771610
-(DbConnector) $ git merge try-merge
+
+$ git merge try-merge
 Auto-merging src/main.c
 CONFLICT (content): Merge conflict in src/main.c
 Recorded preimage for 'src/main.c'
diff --git a/book/A-git-in-other-environments/sections/bash.asc b/book/A-git-in-other-environments/sections/bash.asc
@@ -8,9 +8,9 @@ Zunächst müssen Sie eine Kopie der Datei `contrib/completion/git-completion.ba
 Kopieren Sie es irgendwo hin, bspw. in ihr Home-Verzeichnis und fügen Sie folgendes Ihrer `.bashrc` hinzu:
 
 [source,console]
------
+----
 . ~/git-completion.bash
------
+----
 
 Wechseln Sie anschließend in ein Git-Repository und geben Sie Folgendes ein:
 
@@ -27,11 +27,11 @@ Dies kann so einfach oder komplex sein, wie Sie möchten. Im Allgemeinen gibt es
 Um diese zu Ihrer Eingabeaufforderung hinzuzufügen, kopieren Sie einfach die Datei `contrib/completion/git-prompt.sh` aus dem Quellrepository von Git in Ihr Home Verzeichnis. Fügen Sie Ihre `.bashrc` Datei folgendes hinzu:
 
 [source,console]
------
+----
 . ~/git-prompt.sh
 export GIT_PS1_SHOWDIRTYSTATE=1
 export PS1='\w$(__git_ps1 " (%s)")\$ '
------
+----
 
 Das `\w` bedeutet das Ausgeben des aktuellen Arbeitsverzeichnisses, das `\$` gibt den  `$` Teil der Eingabeaufforderung aus und `__git_ps1 "(% s)"` ruft die von` git-prompt.sh` bereitgestellte Funktion mit einem Formatierungsargument auf.
 Jetzt sieht Ihre Bash-Eingabeaufforderung so aus, wenn Sie sich irgendwo in einem Git Projekt befinden:
diff --git a/book/A-git-in-other-environments/sections/guis.asc b/book/A-git-in-other-environments/sections/guis.asc
@@ -17,8 +17,7 @@ Wenn Sie Git installieren, erhalten Sie auch die visuellen Tools `gitk` und `git
 
 `gitk` ist ein grafischer Verlaufsbetrachter.
 Stellen Sie sich das wie eine leistungsstarke GUI-Shell über `git log` und `git grep` vor.
-Dies ist das Tool, mit dem Sie versuchen, etwas zu finden, das in der Vergangenheit passiert ist, oder den Verlauf Ihres Projekts zu visualisieren.
-Dies ist das Tool, welches sie nutzen sollten, wenn sie versuchen, etwas zu finden, das in der Vergangenheit passiert ist, oder wenn sie den Verlauf Ihres Projekts visualisieren wollen.
+Dies ist das Tool, welches sie nutzen sollten, wenn sie versuchen, etwas zu finden, das in der Vergangenheit passiert ist oder wenn sie den Verlauf Ihres Projekts visualisieren wollen.
 
 Gitk lässt sich am einfachsten über die Befehlszeile aufrufen.
 Geben Sie einfach eine CD in ein Git-Repository ein und geben Sie Folgendes ein:
@@ -32,7 +31,7 @@ Gitk akzeptiert viele Befehlszeilenoptionen, von denen die meisten an die zugrun
 Wahrscheinlich eines der nützlichsten ist das `--all`-Flag, das gitk anweist, Commits anzuzeigen, die von jedem Ref erreichbar sind, nicht nur von HEAD.
 Die Benutzeroberfläche von Gitk sieht folgendermaßen aus:
 
-.The `gitk` history viewer.
+.Der `gitk` Verlaufsbetrachter.
 image::images/gitk.png[Der `gitk` Verlaufsbetrachter.]
 
 Im oberen Teil sieht man etwas, das ein bisschen wie die Ausgabe von `git log --graph` aussieht. Jeder Punkt steht für ein Commit, die Linien für übergeordnete Beziehungen und Refs werden als farbige Kästchen angezeigt.
@@ -44,14 +43,14 @@ Dazwischen befindet sich eine Sammlung von Steuerelementen, die zum Durchsuchen
 Es kann ebenfalls sehr einfach über die Befehlszeile aufgerufen werden:
 
 [source,console]
------
+----
 $ git gui
------
+----
 
 Es sieht in etwa wo aus:
 
-.The `git-gui` commit tool.
-image::images/git-gui.png[Das `git-gui` commit Werkzeug.]
+.Das `git-gui` Commit-Tool.
+image::images/git-gui.png[Das `git-gui` Commit-Tool.]
 
 Links ist der Index. „Unstage“ Änderungen befinden sich oben, „staged“ Änderungen unten.
 Sie können ganze Dateien zwischen den beiden Status verschieben, indem Sie auf deren Symbole klicken. Weiterhin können Sie eine Datei zum Anzeigen auswählen, indem Sie auf ihren Namen klicken.
@@ -74,10 +73,10 @@ GitHub hat zwei Workflow-orientierte Git-Clients erstellt: einen für Windows un
 Diese Clients sind ein gutes Beispiel für Workflow-orientierte Tools. Anstatt alle Funktionen von Git zu implementieren, konzentrieren sie sich stattdessen auf eine Reihe häufig verwendeter Funktionen, die gut zusammenarbeiten.
 Sie sehen so aus:
 
-.GitHub for macOS.
+.GitHub für macOS.
 image::images/github_mac.png[GitHub für macOS.]
 
-.GitHub for Windows.
+.GitHub für Windows.
 image::images/github_win.png[GitHub für Windows.]
 
 Sie sind so konzipiert, dass sie sehr ähnlich aussehen und funktionieren. Daher werden wir sie in diesem Kapitel wie ein einziges Produkt behandeln.
@@ -117,12 +116,12 @@ Wir behandeln dies ausführlicher in <<ch06-github#ch06-github_flow>>, aber der
 Das Branchmanagement ist einer der Bereiche, in denen sich die beiden Tools unterscheiden.
 Unter macOS gibt es oben im Fenster eine Schaltfläche zum Erstellen eines neuen Branches:
 
-.``Create Branch'' button on macOS.
+.„Create Branch“ Knopf auf macOS.
 image::images/branch_widget_mac.png[„Create Branch“ Knopf auf macOS.]
 
 Unter Windows wird dazu der Name des neuen Branches in das Branchwechsel-Widget eingegeben:
 
-.Creating a branch on Windows.
+.Einen Branch auf Windows erstellen.
 image::images/branch_widget_win.png[Einen Branch auf Windows erstellen.]
 
 Sobald Ihre Branch erstellt ist, ist das Erstellen neuer Commits ziemlich einfach.
diff --git a/book/A-git-in-other-environments/sections/powershell.asc b/book/A-git-in-other-environments/sections/powershell.asc
@@ -12,7 +12,9 @@ Folgendermaßen sieht es aus:
 image::images/posh-git.png[PowerShell mit Posh-git.]
 
 ==== Installation
+
 ===== Voraussetzungen (Nur für Windows)
+
 Bevor Sie PowerShell-Skripte auf Ihrem Computer ausführen können, müssen Sie Ihre lokale ExecutionPolicy auf RemoteSigned (im Allgemeinen alles außer Undefiniert und Eingeschränkt) einstellen.
 Wenn Sie AllSigned anstelle von RemoteSigned auswählen, müssen auch lokale Skripte (Ihre eigenen) digital signiert sein, damit sie ausgeführt werden können.
 Mit RemoteSigned müssen nur Skripte signiert werden, bei denen „ZoneIdentifier“ auf Internet eingestellt ist (sie wurden aus dem Web heruntergeladen), andere nicht.
@@ -23,20 +25,25 @@ Weitere Informationen zu PowerShell-Bereichen unter: https://docs.microsoft.com/
 
 Weitere Informationen zu PowerShell ExecutionPolicy unter: https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/set-executionpolicy[]
 
+Um den Wert von `ExecutionPolicy` für alle Benutzer auf `RemoteSigned` zu setzen, verwenden Sie den nächsten Befehl:
+
 [source,powershell]
------
+----
 > Set-ExecutionPolicy -Scope LocalMachine -ExecutionPolicy RemoteSigned -Force
------
+----
 
 ===== PowerShell Galerie
+
 Wenn Sie mindestens PowerShell 5 oder PowerShell 4 mit PackageManagement installiert haben, können Sie posh-git mithilfe des Paketmanagers installieren.
 
-Weitere Informationen zur PowerShell-Galerie unter: https://docs.microsoft.com/en-us/powershell/gallery/overview[]
+Weitere Informationen zur PowerShell-Galerie unter: https://docs.microsoft.com/en-us/powershell/scripting/gallery/overview[]
+
 [source,powershell]
------
+----
 > Install-Module posh-git -Scope CurrentUser -Force
 > Install-Module posh-git -Scope CurrentUser -AllowPrerelease -Force # Newer beta version with PowerShell Core support
------
+----
+
 Wenn Sie posh-git für alle Benutzer installieren möchten, verwenden Sie stattdessen „-Scope AllUsers“ und führen Sie den Befehl über eine PowerShell-Konsole mit admin Rechten aus.
 Wenn der zweite Befehl fehlschlägt und ein Fehler wie `Module 'PowerShellGet' was not installed by using Install-Module`, müssen Sie zuerst einen anderen Befehl ausführen:
 
@@ -49,26 +56,31 @@ Dann können Sie zurückgehen und es erneut versuchen.
 Dies liegt daran, dass die mit Windows PowerShell gelieferten Module mit einem anderen Veröffentlichungszertifikat signiert sind.
 
 ===== Aktualisierung der PowerShell Eingabeaufforderung
+
 Um Git-Informationen in Ihre Eingabeaufforderung aufzunehmen, muss das Posh-Git-Modul importiert werden.
 Wenn posh-git bei jedem Start von PowerShell importiert werden soll, führen Sie den Befehl Add-PoshGitToProfile aus, mit dem die import-Anweisung in Ihr $profile-Skript eingefügt wird.
 Dieses Skript wird jedes Mal ausgeführt, wenn Sie eine neue PowerShell-Konsole öffnen.
-Beachten Sie, dass es mehrere $profile-Skripte gibt.
-Z.B. eins für die Konsole und eins separate für die ISE.
+Beachten Sie, dass es mehrere `$profile` Skripte gibt.
+Z.B. eins für die Konsole und ein separates für die ISE.
+
 [source,powershell]
------
+----
 > Import-Module posh-git
 > Add-PoshGitToProfile -AllHosts
------
+----
 
 ===== Vom Quellcode
+
 Laden Sie einfach eine posh-git-Version von (https://github.com/dahlbyk/posh-git[]) herunter und entpacken Sie sie.
 Importieren Sie dann das Modul unter Verwendung des vollständigen Pfads zur Datei posh-git.psd1:
+
 [source,powershell]
------
+----
 > Import-Module <path-to-uncompress-folder>\src\posh-git.psd1
 > Add-PoshGitToProfile -AllHosts
------
+----
 
 Dies fügt die richtige Zeile zu Ihrer `profile.ps1`-Datei hinzu und posh-git wird beim nächsten Öffnen von PowerShell aktiviert.
+
 Eine Beschreibung der in der Eingabeaufforderung angezeigten Git-Statuszusammenfassungsinformationen finden Sie unter: https://github.com/dahlbyk/posh-git/blob/master/README.md#git-status-summary-information[]
 Weitere Informationen zum Anpassen Ihrer posh-git-Eingabeaufforderung finden Sie unter: https://github.com/dahlbyk/posh-git/blob/master/README.md#customization-variables[]
diff --git a/book/A-git-in-other-environments/sections/zsh.asc b/book/A-git-in-other-environments/sections/zsh.asc
@@ -37,14 +37,12 @@ Dies führt zu einer Anzeige des aktuellen Branches auf der rechten Seite des Te
 (Die linke Seite wird natürlich auch unterstützt; kommentieren Sie einfach die PROMPT Zuweisung zu aus.)
 Es sieht in etwa so aus:
 
-.Customized `zsh` prompt.
-image::images/zsh-prompt.png[Customized `zsh` prompt.]
+.Benutzerdefinierter `zsh` Prompt
+image::images/zsh-prompt.png[Benutzerdefinierter `zsh` Prompt]
 
-Weitere Informationen zu vcs_info finden Sie in der Dokumentation
-         in der `zshcontrib (1)` Manpage,
-         oder online unter http://zsh.sourceforge.net/Doc/Release/User-Contributions.html#Version-Control-Information[].
+Weitere Informationen zu `vcs_info` finden Sie in der Dokumentation in der `zshcontrib(1)` Manpage oder online unter http://zsh.sourceforge.net/Doc/Release/User-Contributions.html#Version-Control-Information[].
 
-Anstelle von vcs_info bevorzugen Sie möglicherweise das im Lieferumfang von Git enthaltene Skript zur Anpassung der Eingabeaufforderung mit dem Namen „git-prompt.sh". Weitere Informationen finden Sie unter https://github.com/git/git/blob/master/contrib/completion/git-prompt.sh[].
+Anstelle von `vcs_info` bevorzugen Sie möglicherweise das im Lieferumfang von Git enthaltene Skript zur Anpassung der Eingabeaufforderung mit dem Namen `git-prompt.sh`. Weitere Informationen finden Sie unter https://github.com/git/git/blob/master/contrib/completion/git-prompt.sh[].
 `git-prompt.sh` ist sowohl mit Bash als auch mit Zsh kompatibel.
 
 Zsh ist mächtig genug, dass es ganze Frameworks gibt, um es besser zu machen.
@@ -53,5 +51,5 @@ Das Plugin-System von oh-my-zsh verfügt über eine leistungsstarke Git-Tab-Verv
 << oh_my_zsh_git >> ist nur ein Beispiel dafür, was mit diesem System möglich ist.
 
 [[oh_my_zsh_git]]
-.An example of an oh-my-zsh theme.
-image::images/zsh-oh-my.png[An example of an oh-my-zsh theme.]
+.Ein Beispiel für ein oh-my-zsh Theme
+image::images/zsh-oh-my.png[Ein Beispiel für ein oh-my-zsh Theme]
diff --git a/book/B-embedding-git/sections/dulwich.asc b/book/B-embedding-git/sections/dulwich.asc
@@ -11,7 +11,7 @@ Dulwich folgt dem Git-Design und trennt die beiden grundlegenden API-Bereiche: B
 Das folgende Beispiel zeigt die API der low-level (Basis-)Ebene, um auf die Commit-Beschreibung des letzten Commits zuzugreifen:
 
 [source, python]
------
+----
 from dulwich.repo import Repo
 r = Repo('.')
 r.head()
@@ -23,19 +23,19 @@ c
 
 c.message
 # 'Add note about encoding.\n'
------
+----
 
 Zum Drucken eines Commit-Protokolls mit der high-level Standard-API kann man folgendes verwenden:
 
 [source, python]
------
+----
 from dulwich import porcelain
 porcelain.log('.', max_entries=1)
 
 #commit: 57fbe010446356833a6ad1600059d80b1e731e15
 #Author: Jelmer Vernooĳ <jelmer@jelmer.uk>
 #Date:   Sat Apr 29 2017 23:57:34 +0000
------
+----
 
 
 ==== Weiterführende Informationen
diff --git a/book/B-embedding-git/sections/go-git.asc b/book/B-embedding-git/sections/go-git.asc
@@ -10,20 +10,19 @@ go-git konzentriert sich auf Erweiterbarkeit und Kompatibilität. Es unterstütz
 Hier ist ein einfaches Beispiel für die Verwendung der Go-APIs:
 
 [source, go]
------
+----
 import "github.com/go-git/go-git/v5"
 
 r, err := git.PlainClone("/tmp/foo", false, &git.CloneOptions{
     URL:      "https://github.com/go-git/go-git",
     Progress: os.Stdout,
 })
------
+----
 
 Sobald Sie eine `Repository` Instanz haben, können Sie auf Informationen zugreifen und Änderungen daran vornehmen:
 
-
 [source, go]
------
+----
 // retrieves the branch pointed by HEAD
 ref, err := r.Head()
 
@@ -37,20 +36,19 @@ history, err := commit.History()
 for _, c := range history {
     fmt.Println(c)
 }
------
-
+----
 
 ==== Erweiterte Funktionalität
 
 go-git hat nur wenige nennenswerte fortgeschrittene Funktionen, von denen eine ein erweiterbares Speichersystem ist, das den Libgit2-Backends ähnlich ist.
 Die Standard-Implementierung ist der In-Memory Storage, welcher sehr effizient ist.
 
 [source, go]
------
+----
 r, err := git.Clone(memory.NewStorage(), nil, &git.CloneOptions{
     URL: "https://github.com/go-git/go-git",
 })
------
+----
 
 Die anpassbare Speicherlösung bietet viele interessante Optionen.
 So können Sie beispielsweise mit https://github.com/go-git/go-git/tree/master/_examples/storage[] Referenzen, Objekte und Konfiguration in einer Aerospike-Datenbank speichern.
@@ -61,23 +59,23 @@ Mit https://pkg.go.dev/github.com/go-git/go-billy/v5?tab=doc#Filesystem[] ist es
 Ein weiterer fortgeschrittener Verwendungszweck enthält einen fein anpassbaren HTTP-Client, wie er bei https://github.com/go-git/go-git/blob/master/_examples/custom_http/main.go[] zu finden ist.
 
 [source, go]
------
+----
 customClient := &http.Client{
-	Transport: &http.Transport{ // accept any certificate (might be useful for testing)
-		TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
-	},
-	Timeout: 15 * time.Second,  // 15 second timeout
-		CheckRedirect: func(req *http.Request, via []*http.Request) error {
-		return http.ErrUseLastResponse // don't follow redirect
-	},
+  Transport: &http.Transport{ // accept any certificate (might be useful for testing)
+      TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
+  },
+  Timeout: 15 * time.Second,  // 15 second timeout
+      CheckRedirect: func(req *http.Request, via []*http.Request) error {
+      return http.ErrUseLastResponse // don't follow redirect
+  },
 }
 
 // Override http(s) default protocol to use our custom client
 client.InstallProtocol("https", githttp.NewClient(customClient))
 
 // Clone repository using the new client if the protocol is https://
 r, err := git.Clone(memory.NewStorage(), nil, &git.CloneOptions{URL: url})
------
+----
 
 
 ==== Weiterführende Informationen
diff --git a/book/B-embedding-git/sections/libgit2.asc b/book/B-embedding-git/sections/libgit2.asc
