Skip to content
This repository was archived by the owner on Sep 1, 2022. It is now read-only.

German translation #52

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,8 @@ preferences:
value: ja
- label: Français
value: fr
- label: Deutsch
value: de
before:
- type: updateBranchProtection
- type: createIssue
Expand Down
14 changes: 14 additions & 0 deletions responses/de/00_assign-yourself.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
## Schritt 1: Ordne dich zu

Unzugeordnete Issues haben keine Besitzer, die sich um sie kümmern.

Wenn man einem Issue oder Pull Request zugewiesen ist, zeigt das Repository-Besuchern und Mitwirkenden, dass man die Unterhaltung oder Aufgaben führen wird :muscle:.

### :keyboard: Aufgabe

1. Klicke auf der rechten Seite des Bildschirms im Bereich “Assignees” auf das Zahnradsymbol und wähle dich selbst aus

<hr>
<h3 align="center">Ich reagiere, wenn ich feststelle, dass du dich diesem Issue zugewiesen hast. </h3>

> _Manchmal antworte ich zu schnell, bevor die Seite aktualisiert werden kann! Wenn du die Aufgabe wie erwartet löst und keine Antwort von mir siehst, bitte warte ein paar Sekunden und lade noch einmal die Seite für deine nächsten Schritte._
120 changes: 120 additions & 0 deletions responses/de/00_introduction.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,120 @@
# :wave: Willkommen bei GitHub Learning Labs “Einführung zu GitHub”!

Zuerst leite ich dich durch einige wichtige erste Schritte für das Codieren und die Zusammenarbeit mit GitHub.

:point_down: _Dieser Pfeil bedeutet, dass du das Fenster erweitern kannst! Klicke während des gesamten Kurses darauf, um weitere Information zu erhalten._
<details><summary>Was ist GitHub?</summary>
<hr>

## Was ist GitHub?

Das freut mich, dass du fragst! Viele Leute kommen zu GitHub, weil sie zu Open Source <sup>[:book:](https://help.github.com/articles/github-glossary/#open-source)</sup> Projekten beitragen wollen, oder weil sie von Teamkollegen oder Klassenkameraden eingeladen werden, die GitHub für ihre Projekte verwenden. Warum verwenden diese Leute GitHub für diese Projekte?

**GitHub ist das Herzstück einer Kollaborationsplattform.**

Von Software bis hin zu juristischen Dokumenten kannst du dich auf GitHub verlassen, um deine beste Arbeit mit den Tools für die Zusammenarbeit und Sicherheit zu leisten, die Ihr Team benötigt. Mit GitHub kannst du Projekte vollständig privat halten, die Welt zu mitwirken einladen und jeden Schritt deines Projekts optimieren.

**GitHub ist auch ein mächtige/leistungsstarkes Versionskontroll-Tool.**

GitHub verwendet Git, <sup>[:book:](https://help.github.com/articles/github-glossary/#git)</sup>, die beliebteste Open-Source-Versionskontrollsoftware, um jeden Beitrag und Beiträger zu deinem Projekt zu verfolgen. So weißt du genau, woher jede Codezeile stammt.

**GitHub hilft Leute, viel mehr zu erreichen.**

Mit GitHub werden einige der fortschrittlichsten Technologien der Welt erstellt. Egal, ob du Daten visualisieren oder ein neues Spiel erstellen, auf GitHub gibt es eine ganze Community und eine Reihe von Tools, mit denen du zum nächsten Schritt gelangen kann. Diese Kurse fangt mit die Grundlagen an, aber wir gehen richtig an die Sache später!

:tv: [Video: (Auf English) What is GitHub?](https://www.youtube.com/watch?v=w3jLJU7DT5E)
<hr>
</details><br>

<details><summary>Erkunden eines GitHub-Repository</summary>
<hr>

## Erkunden eines GitHub-Repository

:tv: [Video: (Auf English) Exploring a repository](https://www.youtube.com/watch?v=R8OAwrcMlRw)

### Weitere Eigenschaften

Das Video hat einege der häufigsten verwendete Funktionen behandelt.
Es gibt einige andere Dinge, dass du in GitHub-Repositories finden kann:

- Project boards: Erstelle in GitHub ein Task-Tracking-Board im Kanban-Stil
- Wiki: Erstelle und lage relevante Projektdokumentation
- Insights: Zeige ein Dropdown-Menü an, das Links zu Analysetools für dein Repository enthält, darunter:
- Pulse: In diesem Projekt-Dashboard finde Informationen von die abgeschlossen und im Gange Aufgaben in diese
- Graphs: Graphs bereitstellen eine detaillierte Aussicht von die Repository-Aktivität, einschließlich die Personen, die zum Repository beigetragen haben, die es geforkt haben und wann die Arbeit abgeschlossen haben

### Spezielle Dateien

In dem Video hast du etwas über eine speziellen Datei, dass README.md heißt, gelernt.
Es gibt einige andere spezielle Datei, dass du deine Repositories hinzufügen kann:

- CONTRIBUTING.md: Die `CONTRIBUTING.md` Datei ist für die Prozess für den Beitrag zum Repository zu beschreiben. Ein Link zur `CONTRIUTING.md` Datei wird angezeigt, wenn jemand ein neues Issue oder eine Pull-Request erstellt.
- ISSUE_TEMPLATE.md: Die `ISSUE_TEMPLATE.md` ist eine andere Datei, dass du den Hauptteil eines Issue vorbevölkern verwenden kann. Zum Beispiel, wenn man immer die gleichen Arten von Informationen für Issues braucht, einschließe in der Issue-Vorlage, und jedes neue Issue wirt mit deinem empfohlenen Startertext ausgefüllt.
<hr>
</details>

### Issues verwenden

Das ist ein Issue <sup>[:book:](https://help.github.com/articles/github-glossary/#issue)</sup>: ein Platz wo du über Fehler in der Code, Codeüberprüfung und ziemlich alles andere sprechen kann.

Issue-Titel sind wie Email-Betreffzeilen. Issue-Titel teilen deine Mitarbeitern auf einem Blick mit, worum es bei den Issue geht. Der Titel dieser Issue ist, zum Beispiel, “Erste Schritte mit GitHub”.

<details><summary>Verwenden von GitHub-Issues</summary>

## Verwenden von GitHub-Issues

Issues sind für Ideen, Verbesserungen, Aufgaben, und Fehler zum übersprechen. Sie erleichtern die Zusammenarbeit durch:

- Bereitstellung der vollständigen Geschichte für alle (auch für zukünftige Teammitglieder) an einem Ort
- Verlinken andere Issues an Pull Request
<sup>[:book:](https://help.github.com/articles/github-glossary/#pull-request)</sup>
- Erstellen einer einzigen umfassenden Aufzeichnung darüber, wie und warum bestimmte Entscheidungen getroffen wurde
- Ganz einfach Beziehen die richtigen Personen und Teams in ein Gespräch mit `@-Erwähnungen`

:tv: [Video: (Auf English) Issues verwenden](https://www.youtube.com/watch?v=Zhj46r5D0nQ)

<hr>
</details>

<details><summary>Benachrichtigungen verwalten</summary>
<hr>

## Benachrichtigungen verwalten

:tv: [Video: Watching, Benachrichtigungen, Stars, und Explore](https://www.youtube.com/watch?v=ocQldxF7fMY)

Wenn du in eine Issue oder Pull Request kommentiert hast, erhältst du E-Mail Benachrichtigungen, wenn es Aktivität in der Faden ist.

### Bestimmte Issues und Pull requests ausschalten oder stummen

1. Gehe zum Issue oder Pull Request
2. Klicke unter _”Notifications”_ rechts auf die Schaltfläche **Unsubscribe**, um Benachrichtigungen auszuschalten, oder **Subscribe** um die Stummschaltung aufzuheben

Du siehst eine kurze Beschreibung über deine zeitliche Benachrichtigungen-Status.

### Anpasse Benachrichtigungen in den Einstellungen

1. Klicke auf dein Profil-Icon
2. Klicke **Settings**
3. Klicke **Notifications** von dem Menü an der linken Seite und [stelle deine Benachrichtigungenpräferenz ein](https://help.github.com/articles/managing-notification-delivery-methods/)

### Repository Benachrichtigung Optionen

* **Watch**: Du erhältst einen Benachrichtigung, wenn ein neues Issue, Pull Request oder Kommentar gebucht ist und wenn ein Issue geschlossen oder ein Pull Request zusammengeführt ist.
* **Not watching**: Du bekommst kein Benachrichtigung mehr, statt du `@-Erwähnungen` wirst * **Ignore**: Du bekommst kein Benachrichtigung mehr von dieses Repository

### Überprüfe die Benachrichtigungen für die Repositories, die du gerade ansiehst

1. Klicke dein Profil-Symbol
2. Klicke **Settings**
3. Klicke **Notification** von der linken Menü
4. Klicke an die [Dinge, dass du anschaust](https://github.com/watching) Link
5. Wähle die **Watching** Karte
6. Klicke die Schaltfläche **Unwatch**, um Benachrichtigungen zu deaktivieren, oder auf **Watch**, um sie zu aktivieren

<hr>
</details>

<hr>
<h3 align="center">Lese weiter unten, deine nächste Aufgabe zu finden</h3>
20 changes: 20 additions & 0 deletions responses/de/01_turn-on-gh-pages.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
## Schritt 2: Aktiviere GitHub Pages

:tada: Herzlichen Glückwunsch! Du bist jetzt für dieses Issue verantwortlich. Nachdem man sich selbst zugewiesen hat, wissen die Leute, die vorbeikommen, dass sie gerne teilnehmen können. Aber du wirst am Ende dieses Issue über die Ziellinie tragen. :sunglasses:

### Verwenden von GitHub Pages

Jetzt, zur Sache! GitHub Pages erlaubt einem eine statische Seite von einem Repository zu bedienen. Wir haben dieses Repository mit einigen Inhalten gefüllt, aber die gerenderte Seite ist noch nicht sichtbar. Lass uns das ändern.

### :keyboard: Aufgabe: Aktivere GitHub Pages

1. Klicke auf die [**Settings**]({{ repoUrl }}/settings) Kategorie in diesem Repository
1. Scrolle bis zu der "GitHub Pages" Sektion
2. Wähle **main branch** von dem “Source” Menü

> Achtung: Auch wenn du eine Option zum Auswählen eines Themas siehst, wende an dieser Stelle kein Thema an. Wir haben den Code geschützt, damit du keine unbeabsichtigten Änderungen vornehmen kannst. Wenn du diesen Kurse komplett beendet hast, wirst du die Gelegenheit haben, ein Thema anzuwenden.

<hr>
<h3 align="center">Ich antworte in diesem Issue, wenn ich erkenne, dass GitHub Pages deine Seite bereitgestellt hat.</h3>

> Durch Aktivieren von GitHub Pages wird dein Repository bereitgestellt. Es kann bis zu einer Minute dauern, während ich auf die Bereitstellung warte.
14 changes: 14 additions & 0 deletions responses/de/02_close-issue.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
## Schritt 3: Schließen eines Issues

Du hast GitHub Pages aktiviert.

Deine Seite ist jetzt öffentlich sichtbar. Schau es dir auf {{ store.pagesUrl }} an.

Nachdem du die Aufgaben in diesem Issue abgeschlossen hast, ist es Zeit, es zu schließen. Das Schließen eines Issues teilt anderen Mitwirkenden mit, dass diese bestimmte Konversation oder Aufgabe beendet wurde.

### :keyboard: Aufgabe

1. Klicke unten auf **Close issue**

<hr>
<h3 align="center">Ich antworte, wenn du dieses Issue geschlossen hast.</h3>
73 changes: 73 additions & 0 deletions responses/de/03_create-a-branch.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
Translation
## Schritt 4: Erstellung eines Branches

Schließen wir den ersten Schritt des GitHub-Flow ab: die Erstellung eines Branches.<sup>[:book:](https://docs.github.com/de/free-pro-team@latest/github/getting-started-with-github/github-glossary#branch)</sup>.

<details><summary>Die Erstellung eines Branches</summary>

## Die Erstellung eines Branches

:tv: [Video: Branches](https://www.youtube.com/watch?v=xgQmu81G1yY)

Du hast gerade gelernt, wie man einen Branch erstellt -- der erste Schritt in dem GitHub-Flow.

Branches sind ein wichtiger Aspekt des GitHub-Flow, weil sie uns die Möglichkeit geben, unsere Arbeit von dem Basis-Branch zu trennen. Quasi bleiben die Arbeitsergebnisse von allen sicher während du einen Beitrag leistest.

### Hinweise für die Branch-Benutzung

Jedes Projekt könnte hunderte von Branches haben, von denen jeder eine neue Änderung zum Basis-Branch vorschlägt.

Die beste Art und Weise um die Ordnung der Branches mit einem Team zu wahren, ist die Branches prägnant und kurzlebig zu halten. Quasi sollte jeder Branch ein einzelnes neues Feature oder Bug-Fix repräsentieren. Branches, die nur für ein paar Tage aktiv sind, bevor sie mit dem Basis-Branch verbunden werden, reduzieren Verwirrung zwischen anderen Mitwirkenden. <sup>[:book:](https://help.github.com/articles/github-glossary/#merge)</sup>.

<hr>
</details>

### :keyboard: Aufgabe: Dein erster Branch

{% if preferences.gitTool == 'cli' %}
1. Öffne deine bevorzugte Befehlszeile, die wir ab sofort deinen Shell nennen.
1. Klone dieses Repository:
```shell
git clone {{ thePayload.repository.clone_url }}
```
1. Steure zum Repository in deinem Shell:
```shell
cd {{ thePayload.repository.name }}
```
1. Erstelle einen Branch mit einem beliebigen Namen. Du könntest die unten vorgeschlagenen Namen verwenden.
```shell
git branch my-slide
```
1. Pushe den Branch zu GitHub:
```
git push --set-upstream origin <BRANCH-NAME>
```

{% elsif preferences.gitTool == 'vscode' %}
1. Wenn du Visual Studio Code (VS Code) noch nicht hast, [lade es herunter](https://code.visualstudio.com/Download) und öffne es.
1. Öffne die Command Palette in VS Code mit <kbd>Ctrl+Shift+P</kbd> für Windows, oder <kbd>Command ⌘+Shift+P</kbd> für macOS. Du kannst auch [VS Codes offizieller Dokumentation](https://code.visualstudio.com/docs/editor/versioncontrol#_cloning-a-repository) über das Klonen folgen.
1. Tippe: `git clone` und drücke <kbd>Enter</kbd>
![a screenshot of vs code with the command palette open](https://user-images.githubusercontent.com/16547949/53639288-bcf9ec80-3bf6-11e9-9d18-d97167168248.png)
1. Füge die Repository-URL in das neue Fenster ein und drücke <kbd>Enter</kbd>:
```shell
{{ thePayload.repository.clone_url }}
```
1. Wähle den Ort, in dem das Repository gespeichert werden soll, und klicke **Choose folder**. Dann öffne den ausgewählten Ort.
2. Der Repository-Ordner sollte jetzt in deinem VS Code Projekt geöffnet sein. Klicke auf `main` unten im VS Code Fenster. Das wird die Command Palette mit den relevanten Befehlen für Git-Branches laden.
![a screenshot of the Git branches in VS Code](https://user-images.githubusercontent.com/16547949/53639606-adc76e80-3bf7-11e9-98ac-bd41ae2b40db.png)
3. Klicke **Create new branch** und gebe einen beliebigen Branch-Namen ein, zum Beispiel `meine-folie`. Dann drücke <kbd>Enter</kbd>.
4. Wenn du dann aufgefordert wirst, einen Ref auszuwählen von dem der Branch erstellt wird, wähle `main`.
5. Gehe zu der “Source Control” Ansicht, klicke auf die Ellipsis (...) und wähle **Push**. Bestätige die Dialog-Box, die nachfragt, ob du den Branch veröffentlichen möchtest.
![a screenshot of the source control view in VS Code](https://user-images.githubusercontent.com/16547949/53640015-ee73b780-3bf8-11e9-8c90-be9022b9555a.png)

{% else %}

1. Steure zum [Code seite]({{ thePayload.repository.html_url }})
2. Klicke auf **Branch: main** in dem Menü
3. Fülle in der Lücke einen Namen für deinen Branch aus, wie z.B. `meine-folie`.
4. Klicke auf **Create branch: <name>** oder drücke die <kbd>Enter</kbd> Taste, um deinen Branch zu erstellen.

{% endif %}
<hr>
<h3 align="center">Ich antworte, wenn ich erkenne, dass ein neuer Branch in diesem Repository erstellt wurde.</h3>

4 changes: 4 additions & 0 deletions responses/de/03_head-to-branch.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
## Dieses Issue ist erledigt! :white_check_mark:

<hr>
<h3 align="center">Gehe jetzt zu <a href="{{ issueURL }}">dem nächsten Issue</a>!</h3>
10 changes: 10 additions & 0 deletions responses/de/03_your-first-contribution.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
### Einführung in GitHub-Flow

Jetzt, wo du dich mit Issues auskennst, nutzen wir dieses Issue, um deinen Pfad zu deinem ersten Beitrag zu verfolgen.

Man verwendet verschiedene Workflows um Software-Beiträge zu machen, aber die einfachste Weise um auf GitHub beizutragen, ist das GitHub-Flow.

:tv: [Video: Understanding the GitHub flow (English)](https://www.youtube.com/watch?v=PBI2Rz-ZOxU)

<hr>
<h3 align="center">Lese unten weiter für weitere Schritte.</h3>
95 changes: 95 additions & 0 deletions responses/de/04_commit-something.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
## Schritt 5: Commit eine Datei

:tada: Du hast eine Branche erstellt!

Beim Branche Erstellungen kann man Änderungen machen zum Projekt, ohne Änderung zur `main` Branche. Nachdem du eine Branch hast, ist es zeit eine neue Datei zu erstellen, und auch deine erste Commit durchzuführen.

<details><summary>Commits 101</summary>

## Commits 101

Wenn man fertig ist, mit Dateischaffungen oder Änderungen, scrolle bis zum Ende des Seite. Dann, finde die "Commit new file" teil.

In der erste Sektor, schreiben eine Commit-Mitteilung. Die Commit-Mitteilung ist ein kurzer, beschreibender Text zu einem Commit, in dem die Änderung kommuniziert wird, die der Commit nach sich zieht.

### Regeln für Commit-Mitteilungen:

- Ende Commit-Mitteilungen ohne punkt.
- Halten Commit-Mitteilungen weniger als 50 Charakter. Zusätzliche Details wird hinzugefügt in dem “extended description” schaufenster wenn es nötig ist. Dass findet man direkt unter die Subjekt-Linie.
- Aktive schreiben. Zum Beispiel, “schreiben”, statt “geschrieben”, oder "merge" instead of "merged".
- Erwägen deinen Commit wie ein Ausdrück deine Absicht, eine Änderung vorzustellen.

<hr>
</details>

### :keyboard: Activität: Deine erste Commit

Die folgenden Schritte führen du durch die Prozess, eine Änderung an GitHub zu Commiten.

{% if preferences.gitTool == 'cli' %}
1. Auschecken zu dein Branch:
```shell
git checkout {{ thePayload.ref }}
```
1. Erstelle eine neue Datei mit dem Namen `_posts/0000-01-02-{{ user.username }}.md`.
1. Füge deiner Datei den folgenden Inhalt hinzu:
```yaml
---
layout: slide
title: "Willkommen zu unserer zweiten Folie!"
---
Dein text
Verwenden Sie den Pfeil nach links, um zurückzukehren!
```
1. Stelle deine neue Datei bereit:
```shell
git add _posts/0000-01-02-{{ user.username }}.md
```
1. Nachdem du deine Text hinzugefügt hat, Commit die Änderung und gebe eine Commit-Mitteilung ein. Richtlinien zum Commit-Mitteilungen finde auf der **Commits 101** Menu, direkt über diesen Anweisungen:
```shell
git commit -m "<YOUR-MESSAGE>"
```
1. Pushe deine neue Commit zu GitHub:
```shell
git push
```

{% elsif preferences.gitTool == 'vscode' %}
1. In dem `_posts` Folie, erstelle eine neue Datei mit dem Namen `0000-01-02-{{ user.username }}.md`. Der vollständige Pfad zu Ihrer Datei lautet: `_posts/0000-01-02-{{ user.username }}.md`.
1. Stelle und speichere deine neue Datei bereit:
```yaml
---
layout: slide
title: "Willkommen zu unserer zweiten Folie!"
---
Dein text
Verwenden Sie den Pfeil nach links, um zurückzukehren!
```
1. Um deine neue Folie zu vorbereiten: gehe zur Quellcodeverwaltungsansicht und klicke auf die Schaltfläche **+** neben der Datei. Du kannst auch mit [VS Code's offizielle Dokumentation (auf Englisch)](https://code.visualstudio.com/docs/editor/versioncontrol#_commit) folgen.
![a screenshot of the staging button in the source control view](https://user-images.githubusercontent.com/16547949/53641057-d5b8d100-3bfb-11e9-9b69-53b0661cd5cd.png)
1. Commit die Änderung, indem du eine Commit-Mitteilung in das Textfeld eingeben und drücken <kbd>Ctrl+Enter</kbd> auf Windows or <kbd>Command ⌘+Enter</kbd> auf macOS.
![a screenshot of the commit message on VS Code](https://user-images.githubusercontent.com/16547949/53641276-698a9d00-3bfc-11e9-9b3d-01680fd01d7c.png)
1. Klicke auf die Auslassungspunkte (...) and wähle **Push** aus.

{% else %}
1. Erstelle eine neue Datei in dem `_posts` Folie, mit dem Namen `0000-01-02-{{ user.username }}.md`. Du kannst das mit [diese Abkürzung]({{ thePayload.repository.html_url }}/new/{{ thePayload.ref }}?filename=_posts/0000-01-02-{{ user.username }}.md) oder manuell wie folgt:
- Kehre zur Registerkarte “Code” zurück
- In der Dropdown-Liste, wähle "{{ thePayload.ref }}" aus
- Klicke **Create new file**
- In dem "file name" Sektor, schreibe `_posts/0000-01-02-{{ user.username }}.md`. Wenn man das `/` in den Dateinamen eingebe, wird die Datei automatisch im Verzeichnis `_posts` abgelegt.
1. When you’re done naming the file, add the following content to your file:
```yaml
---
layout: slide
title: "Willkommen zu unserer zweiten Folie!"
---
Dein text
Verwenden Sie den Pfeil nach links, um zurückzukehren!
```
1. Nach dem Hinzufügen des Textes kann man die Änderung festschreiben, indem man eine Commit-Mitteilung in das Texteingabefeld unterhalb der Datei Bearbeitungsansicht eingeben. Richtlinien zum Commit-Mitteilungen finde auf der **Commits 101** Menu, direkt über diesen Anweisungen.
1. Wenn du ein Commit-Mitteilung eingegeben habe, klicke **Commit new file**.
{% endif %}
<hr>
<h3 align="center">Ich antworte, wenn ich erkenne, dass ein neuer Commit in diesem Branch erstellt wurde.</h3>


Loading