Skip to content

Commit

Permalink
appendix b - vom sie zum du (#404)
Browse files Browse the repository at this point in the history
  • Loading branch information
pastatopf authored Oct 21, 2024
1 parent d3ec35f commit 1c5c772
Show file tree
Hide file tree
Showing 12 changed files with 138 additions and 136 deletions.
6 changes: 3 additions & 3 deletions B-embedding-git-in-your-applications.asc
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
[[B-embedding-git-in-your-applications]]
[appendix]
== Git in Ihre Anwendungen einbetten
== Git in deine Anwendungen einbetten

Wenn Ihre Anwendung für Software-Entwickler gedacht ist, stehen die Chancen gut, dass sie von der Integration mit der Quellcode-Versionsverwaltung profitieren kann.
Wenn deine Anwendung für Software-Entwickler gedacht ist, stehen die Chancen gut, dass sie von der Integration mit der Quellcode-Versionsverwaltung profitieren kann.
Auch Anwendungen, die nicht für Entwickler bestimmt sind, wie z.B. Texteditoren, könnten potenziell von Funktionen der Versionskontrolle profitieren. Das Git-System funktioniert sehr gut für viele unterschiedliche Einsatzszenarien.

Wenn Sie Git in Ihre Anwendung integrieren müssen, haben Sie im Wesentlichen zwei Möglichkeiten: eine Shell zu erzeugen und damit das Git-Kommandozeilenprogramm aufzurufen oder eine Git-Bibliothek in Ihre Anwendung einzubetten.
Wenn du Git in deiner Anwendung integrieren musst, hast du im Wesentlichen zwei Möglichkeiten: eine Shell zu erzeugen und damit das Git-Kommandozeilenprogramm aufzurufen oder eine Git-Bibliothek in deine Anwendung einzubetten.
Hier werden wir die Befehlszeilenintegration und einige der beliebtesten, integrierbaren Git-Bibliotheken behandeln.

include::book/B-embedding-git/sections/command-line.asc[]
Expand Down
34 changes: 17 additions & 17 deletions CONTRIBUTING.asc
Original file line number Diff line number Diff line change
@@ -1,48 +1,48 @@
= Zur Übersetzung der zweiten Auflage von Git Pro beitragen

== Ihre Arbeit an uns lizenzieren
== Deine Arbeit an uns lizenzieren

Wenn Sie einen Pull-Request öffnen, erklären Sie sich damit einverstanden, dass Ihre Arbeit unter der link:LICENSE.asc[Projektlizenz] veröffentlicht wird.
Außerdem erklären Sie sich damit einverstanden, eine solche Lizenz an Ihrer Arbeit den Hauptautoren @ben und @schacon zu gewähren, die sie für zukünftige, gedruckte Ausgaben benötigen.
Sollten Ihre Änderungen in einer gedruckten Fassung erscheinen, so werden Sie in die Liste der link:book/contributors.asc[Mitwirkenden] aufgenommen.
Wenn du einen Pull-Request öffnest, erklärst du dich damit einverstanden, dass deine Arbeit unter der link:LICENSE.asc[Projektlizenz] veröffentlicht wird.
Außerdem erklärst du dich damit einverstanden, eine solche Lizenz an deiner Arbeit den Hauptautoren @ben und @schacon zu gewähren, die sie für zukünftige, gedruckte Ausgaben benötigen.
Sollten deine Änderungen in einer gedruckten Fassung erscheinen, so wirst du in die Liste der link:book/contributors.asc[Mitwirkenden] aufgenommen.

== Ein Problem (Issue) melden

Suchen Sie nach ähnlichen Issues, bevor Sie ein neues erstellen.
Suche bitte nach ähnlichen Issues, bevor du ein neues erstellst.

Wenn Sie das Problem auch auf der link:https://git-scm.com[Git-Website] entdeckt haben, überprüfen Sie bitte, ob das Problem auch in der PDF-Version vorhanden ist.
Wenn du das Problem auch auf der link:https://git-scm.com[Git-Website] entdeckt hast, überprüfe bitte, ob das Problem auch in der PDF-Version vorhanden ist.
Möglicherweise wurde das Problem bereits in den Quelldateien korrigiert, aber noch nicht auf der link:https://git-scm.com[Git-Website] veröffentlicht.

== Kleinere Korrekturen

Fehlerkorrekturen und grundlegende Klarstellungen werden akzeptiert, wenn wir uns einig sind, dass sie den Inhalt verbessern.
Sie können auch ein Issue öffnen, so dass wir diskutieren können, wie oder ob das Issue gelöst werden muss.
Du kannst auch ein Issue öffnen, so dass wir diskutieren können, wie oder ob das Issue gelöst werden muss.

Wenn Sie dies noch nie zuvor getan haben, kann der link:https://guides.github.com/introduction/flow/[Flow Guide] hilfreich sein.
Wenn du dies noch nie zuvor getan hast, kann der link:https://guides.github.com/introduction/flow/[Flow Guide] hilfreich sein.

== Größere Änderungen

Öffnen Sie ein Issue zur Diskussion, bevor Sie beginnen.
Öffnen einen Issue zur Diskussion, bevor du beginnst.
Eine umfangreiche Korrektur neigt dazu, sehr subjektiv zu sein und die Dinge oft nur für eine kleinere Anzahl von Lesern zu verbessern.
Professionelle Textredakteure haben diesen Inhalt bereits mehrfach überprüft.
Es ist unwahrscheinlich, dass Ihre neue Textfassung *so* viel besser wird, dass es sich lohnt, große Teile des Inhalts zu ändern.
Es ist unwahrscheinlich, dass deine neue Textfassung *so* viel besser wird, dass es sich lohnt, große Teile des Inhalts zu ändern.

== Abbildungen

Die Bilder in diesem Buch wurden mit link:https://www.sketchapp.com/[Sketch 3] und der link:https://github.com/progit/progit2/blob/master/diagram-source/progit.sketch[mitgelieferten Sketchbook-Datei] erstellt.

Um eine Abbildung zu erstellen:

1. Fügen Sie eine Seite zum Sketchbook hinzu.
Verwenden Sie, wo immer möglich, die mitgelieferten Symbole.
2. Fügen Sie Ihrer Seite einen „Slice“ hinzu.
Geben Sie ihm einen Namen, der mit dem PNG-Dateinamen des Ziels übereinstimmt, relativ zur Root des Quellverzeichnisses.
3. Stellen Sie den Export Ihres Slice auf „800w“ ein.
1. Füge eine Seite zum Sketchbook hinzu.
Verwende, wo immer möglich, die mitgelieferten Symbole.
2. Füge deine Seite einen „Slice“ hinzu.
Gib ihm einen Namen, der mit dem PNG-Dateinamen des Ziels übereinstimmt, relativ zur Root des Quellverzeichnisses.
3. Stelle den Export Ihres Slice auf „800w“ ein.

== Übersetzungen

Wenn Sie einen Beitrag zur Übersetzung von Pro Git in Ihre Sprache leisten möchten, werfen Sie einen Blick auf link:https://github.com/progit/progit2-de/blob/master/TRANSLATING.md[TRANSLATING.md].
Wenn du einen Beitrag zur Übersetzung von Pro Git in deiner Sprache leisten möchtest, wirf einen Blick auf link:https://github.com/progit/progit2-de/blob/master/TRANSLATING.md[TRANSLATING.md].

== Weiterführende Hinweise zur deutschen Übersetzung

Alle weiterführenden Hinweise zur deutschen Übersetzung finden Sie im Dokument link:TRANSLATION_NOTES_DE.asc[Hinweise zur deutschen Übersetzung].
Alle weiterführenden Hinweise zur deutschen Übersetzung findest du im Dokument link:TRANSLATION_NOTES_DE.asc[Hinweise zur deutschen Übersetzung].
20 changes: 10 additions & 10 deletions README.asc
Original file line number Diff line number Diff line change
Expand Up @@ -2,20 +2,20 @@

Herzlich willkommen bei der zweiten Auflage des Buchs „Pro Git“.

Sie finden dieses Buch online unter: https://git-scm.com/book/de/v2
Du findest dieses Buch online unter: https://git-scm.com/book/de/v2

Wie die erste, ist auch die zweite Auflage von *Pro Git* Open Source und steht unter der Creative Commons-Lizenz.

Im Vergleich zur ersten Auflage haben sich in der zweiten Auflage allerdings ein paar Dinge geändert:
Unter anderem haben wir von Markdown auf das fantastische AsciiDoc-Format für den Text des Buches umgestellt. Sie finden unter https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/[AsciiDoc Syntax Quick Reference] eine kleine Starthilfe
Unter anderem haben wir von Markdown auf das fantastische AsciiDoc-Format für den Text des Buches umgestellt. Du findest unter https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/[AsciiDoc Syntax Quick Reference] eine kleine Starthilfe

Statt eines großen Repositorys für alle Sprachen wird jede Sprache mittlerweile in einem eigenen Repository verwaltet.
In den Dokumenten link:TRANSLATING.md[Pro Git Übersetzung] und link:TRANSLATION_NOTES_DE.asc[Hinweise zur deutschen Übersetzung] finden Sie weitere Informationen.
In den Dokumenten link:TRANSLATING.md[Pro Git Übersetzung] und link:TRANSLATION_NOTES_DE.asc[Hinweise zur deutschen Übersetzung] findest du weitere Informationen.

== Wie kann das Buch erstellt werden?

Sie können die E-Book-Dateien manuell mit Asciidoctor erzeugen.
Wenn Sie die folgenden Befehle ausführen, können Sie auch HTML-, Epub-, Mobi- und PDF-Ausgabedateien erhalten:
Du kannst die E-Book-Dateien manuell mit Asciidoctor erzeugen.
Wenn du die folgenden Befehle ausführst, kannst du auch HTML-, Epub-, Mobi- und PDF-Ausgabedateien erhalten:

----
$ bundle install
Expand All @@ -30,8 +30,8 @@ Converting to PDF...
-- PDF output at progit.pdf
----

Sie können auch nur eins der unterstützten Formate (HTML, EPUB, mobi, or PDF) erstellen.
Nutzen sie eins der folgenden Kommandos:
Du kannst auch nur eins der unterstützten Formate (HTML, EPUB, mobi, or PDF) erstellen.
Nutze eins der folgenden Kommandos:

Um das HTML Buch zu erstellen:

Expand Down Expand Up @@ -59,11 +59,11 @@ $ bundle exec rake book:build_pdf

== Ein Problem melden

Bevor Sie ein Problem melden, bitten wir Sie zu überprüfen, ob sich nicht ein ähnliches oder gar dasselbe Problem bereits im Bugtracking-System befindet.
Bevor du ein Problem meldest, überprüfe bitte, ob sich nicht ein ähnliches oder gar dasselbe Problem bereits im Bugtracking-System befindet.

Wenn Sie dieses Problem auf der Website git-scm.com entdeckt haben, überprüfen Sie bitte nochmals, ob es in diesem Repo noch vorhanden ist.
Wenn du dieses Problem auf der Website git-scm.com entdeckt hast, überprüfe bitte nochmals, ob es in diesem Repo noch vorhanden ist.
Das Problem wurde eventuell schon behoben, aber die Änderungen noch nicht eingespielt.

== Mithelfen

Wenn Sie uns bei der Übersetzung helfen wollen, sei es um einen Text neu zu übersetzen oder einen Rechtschreibfehler zu verbessern, finden Sie in dem Dokument link:CONTRIBUTING.asc[Contributor Guide] weitere Informationen.
Wenn du uns bei der Übersetzung helfen willst, sei es um einen Text neu zu übersetzen oder einen Rechtschreibfehler zu verbessern, findest du in dem Dokument link:CONTRIBUTING.asc[Contributor Guide] weitere Informationen.
2 changes: 1 addition & 1 deletion Special_Characters.asc
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Die Eingabe von Sonderzeichen mit der normalen Standard-Tastatur ist je nach Bet

Das Ziel dieser Datei ist es, für die häufigsten Sonderzeichen ein `copy + paste` zu ermöglichen.

Falls für ein notwendiges Sonderzeichen in der folgenden Tabelle kein Eintrag vorhanden ist, sollten Sie entweder selbst einen Vorschlag machen oder über „New Issue“ eine Nachricht hinterlassen.
Falls für ein notwendiges Sonderzeichen in der folgenden Tabelle kein Eintrag vorhanden ist, solltest du entweder selbst einen Vorschlag machen oder über „New Issue“ eine Nachricht hinterlassen.

[TIP]
====
Expand Down
53 changes: 27 additions & 26 deletions TRANSLATING.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,19 +6,19 @@ Die Übersetzungen werden dezentral verwaltet. Jedes Übersetzungsteam pflegt se

Pro Git ist ein Buch über ein technisches Werkzeug, daher ist die Übersetzung im Vergleich zu einer nicht-technischen Übersetzung schwierig.

Die folgenden Richtlinien sollen Ihnen auf Ihrem Weg helfen:
* Bevor Sie beginnen, lesen Sie das gesamte Git Pro Buch auf Englisch, damit Sie den Inhalt kennen und mit dem verwendeten Stil vertraut werden.
* Stellen Sie sicher, dass Sie über gute Grundkenntnisse in git verfügen, so dass die Erklärung der Fachbegriffe möglich ist.
* Halten Sie sich an einen gemeinsamen Stil und ein gemeinsames Format für die Übersetzung.
* Lesen und verstehen Sie unbedingt die Grundlagen der [Asciidoc-Formatierung](https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/). Die Nichteinhaltung der asciidoc-Syntax kann zu Problemen beim Erstellen/Kompilieren der für das Buch benötigten pdf-, epub- und html-Dateien führen.
Die folgenden Richtlinien sollen dir auf deinem Weg helfen:
* Bevor du beginnst, lies das gesamte Git Pro Buch auf Englisch, damit du den Inhalt kennst und mit dem verwendeten Stil vertraut wirst.
* Stelle sicher, dass du über gute Grundkenntnisse in git verfügst, so dass die Erklärung der Fachbegriffe möglich ist.
* Halte dich an einen gemeinsamen Stil und ein gemeinsames Format für die Übersetzung.
* Lese und verstehe unbedingt die Grundlagen der [Asciidoc-Formatierung](https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/). Die Nichteinhaltung der asciidoc-Syntax kann zu Problemen beim Erstellen/Kompilieren der für das Buch benötigten pdf-, epub- und html-Dateien führen.

## Das Buch in eine andere Sprache übersetzen

### Mithilfe bei einem bestehenden Projekt

* Suchen Sie in der folgenden Tabelle nach einem bereits vorhandenen Projekt.
* Gehen Sie auf die GitHub-Projektseite.
* Eröffnen Sie ein Issue, stellen Sie sich vor und fragen Sie, wo Sie helfen können.
* Suche in der folgenden Tabelle nach einem bereits vorhandenen Projekt.
* Gehe auf die GitHub-Projektseite.
* Eröffne ein Issue, stelle dich vor und frage, wo du helfen kannst.

| Sprache | GitHub Projektseite |
| :------------- | :------------- |
Expand Down Expand Up @@ -54,17 +54,17 @@ Die folgenden Richtlinien sollen Ihnen auf Ihrem Weg helfen:

### Eine neue Übersetzung beginnen

Wenn es noch kein Projekt für Ihre Sprache gibt, können Sie eine eigene Übersetzung starten.
Wenn es noch kein Projekt für deine Sprache gibt, kannst du eine eigene Übersetzung starten.

Grundlage Ihrer Arbeit ist die zweite Ausgabe des Buches, die [hier](https://github.com/progit/progit2) verfügbar ist. So sollten Sie vorgehen:
1. Wählen Sie den richtigen [ISO 639-Code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) für Ihre Sprache.
1. Erstellen Sie eine [GitHub-Organisation](https://docs.github.com/en/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch), z.B. `progit2-[Ihr_Code]` auf GitHub.
1. Erstellen Sie ein Projekt ``progit2``.
1. Kopieren Sie die Struktur von progit/progit2 (dieses Projekt) in Ihr Projekt und beginnen Sie mit der Übersetzung.
Grundlage deiner Arbeit ist die zweite Ausgabe des Buches, die [hier](https://github.com/progit/progit2) verfügbar ist. So solltest du vorgehen:
1. Wähle den richtigen [ISO 639-Code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) für deine Sprache.
1. Erstelle eine [GitHub-Organisation](https://docs.github.com/en/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch), z.B. `progit2-[Ihr_Code]` auf GitHub.
1. Erstelle ein Projekt ``progit2``.
1. Kopiere die Struktur von progit/progit2 (dieses Projekt) in dein Projekt und beginne mit der Übersetzung.

### Den Bearbeitungsstatus Ihrer Übersetzung aktualisieren
### Den Bearbeitungsstatus deiner Übersetzung aktualisieren

Auf https://git-scm.com sind die Übersetzungen in drei Kategorien eingeteilt. Sobald Sie eine dieser Levels erreicht haben, kontaktieren Sie die Betreuer von https://git-scm.com/, damit sie die Änderungen übernehmen können.
Auf https://git-scm.com sind die Übersetzungen in drei Kategorien eingeteilt. Sobald du eine dieser Levels erreicht hast, kontaktiere die Betreuer von https://git-scm.com/, damit sie die Änderungen übernehmen können.

| Kategorie | fertiggestellt |
| :------------- | :------------- |
Expand All @@ -76,22 +76,23 @@ Auf https://git-scm.com sind die Übersetzungen in drei Kategorien eingeteilt. S

GitHub Actions ist ein [Continuous Integration](https://de.wikipedia.org/wiki/Kontinuierliche_Integration)-Dienst, der in GitHub integriert ist. GitHub Actions wird verwendet, um sicherzustellen, dass ein Pull-Request den Build oder die Kompilierung nicht unterbricht. GitHub Actions kann auch kompilierte Versionen des Buchs bereitstellen.

Die Konfiguration für GitHub-Aktionen ist im Verzeichnis `.github/workflows` enthalten, und wenn Sie den `main`-Branch des Root-Repositorys einbinden, erhalten Sie sie kostenlos.
Wenn Sie jedoch Ihr Übersetzungsrepo erstellt haben, indem Sie das Root-Repository _geforked_ haben, müssen Sie einen zusätzlichen Schritt ausführen (wenn Sie keinen Fork gemacht haben, können Sie diesen Teil überspringen).
GitHub geht davon aus, dass Forks verwendet werden, um zu dem Repository beizutragen, aus dem sie geforked wurden. Sie müssen also die Registerkarte „Aktionen“ in Ihrem geforktem Repository aufrufen und auf die Schaltfläche „Ich verstehe meine Workflows“ klicken, um die Aktionen zuzulassen.
Die Konfiguration für GitHub-Aktionen ist im Verzeichnis `.github/workflows` enthalten, und wenn du den `main`-Branch des Root-Repositorys einbindest, erhältst du sie kostenlos.
Wenn du jedoch dein Übersetzungsrepo erstellt hast, indem du das Root-Repository _geforked_ hast, musst di einen zusätzlichen Schritt ausführen (wenn du keinen Fork gemacht hast, kannst du diesen Teil überspringen).
GitHub geht davon aus, dass Forks verwendet werden, um zu dem Repository beizutragen, aus dem sie geforked wurden. Du musst also die Registerkarte „Aktionen“ in deinem geforktem Repository aufrufen und auf die Schaltfläche „Ich verstehe meine Workflows“ klicken, um die Aktionen zuzulassen.

## Einrichtung einer Publikationskette für E-Books
## Einrichtung einer Veröffentlichungs-Pipelne für E-Books

Das ist eine technische Sache, bitte kontaktieren Sie @jnavila, um mit der Veröffentlichung von epub zu beginnen.
Das ist eine technische Sache, bitte kontaktiere @jnavila, um mit der Veröffentlichung von epub zu beginnen.

## Abgesehen von Pro Git

Die Übersetzung des Buches ist der erste Schritt. Sobald das fertig ist, können Sie die Benutzeroberfläche von Git selbst übersetzen.
Die Übersetzung des Buches ist der erste Schritt. Sobald das fertig ist, kannst du die Benutzeroberfläche von Git selbst übersetzen.

Diese Aufgabe erfordert ein besseres technisches Wissen über das Tool als das Buch. Hoffentlich können Sie nach der Übersetzung des gesamten Buchinhalts die in der Anwendung verwendeten Begriffe verstehen. Wenn Sie sich der Aufgabe technisch gewachsen fühlen, ist das Repo [hier](https://github.com/git-l10n/git-po) und Sie müssen nur dieser [Anleitung](https://github.com/git-l10n/git-po/blob/master/po/README.md) folgen.
Diese Aufgabe erfordert ein besseres technisches Wissen über das Tool als das Buch. Hoffentlich kannst du nach der Übersetzung des gesamten Buchinhalts die in der Anwendung verwendeten Begriffe verstehen. Wenn du dich der Aufgabe technisch gewachsen fühlst, ist das Repo [hier](https://github.com/git-l10n/git-po) und du musst nur dieser [Anleitung](https://github.com/git-l10n/git-po/blob/master/po/README.md) folgen.

Beachten Sie jedoch, dass
Beachte jedoch, dass

* Sie speziellere Tools verwenden müssen, um die Lokalisierungs-Po-Dateien zu handhaben (z.B. um sie mit [poedit](https://poedit.net/) zu bearbeiten) und sie zusammenzuführen. Möglicherweise müssen Sie git kompilieren, um Ihre Arbeit zu überprüfen.
* du speziellere Tools verwenden musst, um die Lokalisierungs-Po-Dateien zu handhaben (z.B. um sie mit [poedit](https://poedit.net/) zu bearbeiten) und sie zusammenzuführen. Möglicherweise musst du git kompilieren, um deine Arbeit zu überprüfen.
* ein grundlegendes Verständnis über die Übersetzung von Anwendungen erforderlich ist, die sich deutlich von der Übersetzung von Büchern unterscheidet.
* das Core-Projekt Git strengere [Vorschriften](https://github.com/git-l10n/git-po/blob/master/Documentation/SubmittingPatches) für die Annahme von Beiträgen anwendet. Achten Sie darauf, diese einzuhalten.
* das Core-Projekt Git strengere [Vorschriften](https://github.com/git-l10n/git-po/blob/master/Documentation/SubmittingPatches) für die Annahme von Beiträgen anwendet. Achte darauf, diese einzuhalten.

Loading

0 comments on commit 1c5c772

Please sign in to comment.