diff --git a/docs/translations/README.de.md b/docs/translations/README.de.md index 5f85f613..93e10e53 100644 --- a/docs/translations/README.de.md +++ b/docs/translations/README.de.md @@ -1,120 +1,166 @@ -[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) +[![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) -# Erste Beiträge -Repository forken +# First Contributions -Aller Anfang ist schwer. Gerade dann, wenn wir gemeinsam an etwas arbeiten, möchte niemand etwas falsch machen. Aber Open Source dreht sich um Kooperation und lebt durch die Beiträge vieler Freiwilliger. Deshalb haben wir es uns zur Aufgabe gemacht, neuen Mitgliedern in der Open-Source-Gemeinde ihre ersten Schritte so einfach wie möglich zu machen. +Dieses Projekt zielt darauf ab, Anfängern den Einstieg zu erleichtern und sie bei ihrem ersten Beitrag zu unterstützen. Wenn du deinen ersten Beitrag leisten möchten, befolge die folgenden Schritte. -Natürlich helfen die vorhandenen Artikel und Videoanleitungen. Aber was kann besser sein, als es einfach einmal auszuprobieren – mit dem Wissen, dass man nichts kaputt machen kann? Dieses Projekt will Anfängern zeigen, wie sie möglichst einfach ihren ersten Beitrag leisten. Bedenke: Je entspannter du bist, desto besser lernst du. Wenn du deinen ersten Beitrag leisten möchtest, folge diesen einfachen Schritten. Wir versprechen dir, es wird Spaß machen. +_Wenn du nicht weißt wie man das Terminal/CMD bedient, [hier findest du Anleitungen für GUI Tools.](#Anleitungen-für-andere-Tools)_ -Wenn du Git noch nicht installiert hast, [installiere es](https://help.github.com/articles/set-up-git/) +Forke dieses Repository -## Repository forken +#### Wenn du Git nicht auf deinem System installiert hast, [installiere es](https://...github.com/en/get-started/quickstart/set-up-git). -Forke das Repository durch das Anklicken der Schaltfläche "Fork". Dadurch erhältst du deine eigene Version des Projektes in deinem Profil. +## Forke dieses Repository -## Repository klonen +Forke dieses Repository indem du auf den Fork Button oben auf dieser Seite klickst. +Dies wird eine Kopie dieses Repository's in deinem Account erstellen. -Repository klonen +## Klone das Repository -Klone das Repository auf deinen Computer. Klicke auf die Schaltfläche "Clone or download" und anschließend auf das "copy to clipboard"-Symbol. +Klone dieses Repository -Öffne eine Kommandozeile und gib den folgenden git-Befehl ein: +Klone jetzt das geforkte Repository auf deinen Computer. Gehe zu deinem Github Account, öffne das geforkte Repository, drücke auf den Code Button, dann auf den SSH Tab und dann drücke auf das _copy url to clipboard_ icon. -``` -git clone "Deine kopierte URL" +Öffne ein Terminal Fenster und führe den folgenden Git Befehl aus: + +```bash +git clone "kopierte url" ``` -Statt 'Deine kopierte URL' (ohne Anführungszeichen) füge die Repository-URL aus dem vorherigen Schritt ein. +wobei "kopierte url" (ohne die Anführungszeichen) die url zu diesem Repository ist (deine Fork von diesem Projekt). Im vorherigen Schritt siehst du wie du diese erhälst . -URL kopieren +URL in die Zwischenablage kopieren -Beispiel: +Zum Beispiel: -``` -git clone https://github.com/dein-Name/first-contributions.git +```bash +git clone git@github.com:das-bist-du/erster-Beitrag.git ``` -An der Stelle 'dein-Name' muss dein GitHub-Nutzername stehen. Mit diesem Befehl kopierst du den Inhalt deines first-contributions-Repository von GitHub auf deinen Computer. +wobei `das-bist-du` dein Github Nutzername ist. Hier kopierst du den Inhalt des first-contributions Repository's auf Github auf deinen Computer. -## Erstelle einen Branch +## Erstelle einen Zweig -Wechsle zum Repository-Verzeichnis auf deinem Computer (falls du es nicht schon getan hast). +Wechsle zum Repository Ordner (wenn du nicht bereits dort bist): -``` +```bash cd first-contributions ``` -Erstelle nun einen Branch mit dem Befehl `git checkout`: +Erstelle nun einen Zweig, indem du den `git switch` Befehl benutzst: -``` -git checkout -b +```bash +git switch -c dein-neuer-zweig-name ``` -Beispiel: +Zum Beispiel: -``` -git checkout -b add-max-mustermann +```bash +git switch -c add-alonzo-church ``` -(Der Name des Branches muss nicht unbedingt das Wort _add_ beinhalten, aber hier ist es sinnvoll, denn der Zweck deines Branches ist es ja, deinen Namen zur Liste hinzuzufügen.) +
+ Wenn du auf irgendeinen Fehler bei der Nutzung von git switch stößt, drücke hier: -## Mache die nötigen Änderungen und committe sie +Wenn die Fehlermeldung "Git: `switch` is not a git command. See `git –help`" erscheint, liegt dies wahrscheinlich daran das du eine veraltete Version von Git nutzt. -Öffne `Contributors.md` in einem Text-Editor und füge deine Namen hinzu. Beachte, dass du den Namen nicht am Anfang oder am Ende der Datei hinzufügst. Speichere die Datei anschließend. - -Gibst du in der Kommandozeile nun `git status` ein, siehst du die Änderungen. - -Füge die Änderungen mit dem Befehl `git add` zu deinem eben erstellten Branch hinzu: +In diesem Fall versuche stattdessen `git checkout` zu nutzen: +```bash +git checkout -b dein-neuer-zweig-name ``` + +
+ +## Make necessary changes and commit those changes + +Öffne nun die Datei `Contributors.md` in einem Texteditor und füge deinen Namen hinzu. Füge ihn nicht ganz am Anfang oder am Ende hinzu, sondern irgendwo dazwischen, mittendrin. Speichere jetzt die Datei. + +git status + +Wenn du in den Projektordner gehst und den Befehl `git status`, ausführst werden dir die Änderungen angezeigt. + +Füge diese Änderungen nun zu dem Zweig hinzu den du gerade erstellt hast, indem du den Befehl `git add` ausführst. + +```bash git add Contributors.md ``` -Nun committest du deine Änderungen mit `git commit`: +Jetzt commite diese Änderungen mit dem `git commit` Befehl: -``` -git commit -m "Add to Contributors list" +```bash +git commit -m "Add your-name to Contributors list" ``` -Ersetze `` mit deinem Namen. +ersetze `your-name` mit deinem Namen. -## Pushe die Änderung zu GitHub +## Änderungen auf Github pushen -Pushe die Änderungen mit `git push`: +Übertrage deine Änderungen mit `git push`: -``` -git push origin +```bash +git push -u origin dein-zweig-name ``` -Ersetze `` mit dem Namen des Branches, den du zuvor erstellt hast. +ersetze `dein-zweig-name` mit dem Namen des Zweiges den du vorhin erstellt hast. -## Sende deine Änderungen zum Review +
+ Solltest du auf irgendwelche Fehler beim Pushen stoßen, drücke hier: -Wenn du jetzt zu deinem Repository auf GitHub gehst, siehst du einen Knopf `Compare & pull request`. Klicke darauf. +- ### Authentifizierungs Fehler + 
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
+  remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
+  fatal: Authentication failed for 'https://github.com//first-contributions.git/'
+ Gehe zu [GitHub's tutorial](https://...github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) wie du einen ssh Key zu deinem Account hinzufügst und konfigurierst. + Außerdem, kannst du 'git remote -v' ausführen um deine Remote Addresse anzuzeigen. + + Wenn es so aussieht: + 
origin	https://github.com/your-username/your_repo.git (fetch)
+  origin	https://github.com/your-username/your_repo.git (push)
+ + ändere es mit diesem Befehl: + ```bash + git remote set-url origin git@github.com:dein-nutzername/dein_repo.git + ``` + Ansonsten wirst du noch immer aufgefordert Passwort und Benutzername einzugeben und bekommst einen Authentifizierungs Fehler. +
-Erstelle einen pull request +## Reiche deine Änderungen für ein Review ein -Erstelle einen Pull Request indem du auf die Schaltfläche `Create pull request` klickst. +Wenn du jetzt zu deinem Repository auf Github gehts, wirst du einen `Compare & pull request` Knopf sehen. Drücke diesen Knopf. -Pull Request senden +erstelle eine Pull-Request -Roshan Jossey wird nun deine Änderungen in den Master-Branch dieses Projekts mergen. Du erhältst eine E-Mail, sobald dies geschehen ist. +Jetzt, reiche deine Pull-Request ein. -## Wie geht es weiter? +Reiche deine Pull-Request ein -Glückwunsch! Du hast soeben den Standard-Workflow _Fork -> Clone -> Edit -> Pull Request_ beendet, der dir als Mitwirkender häufig begegnen wird. +Bald werde ich alle deine Änderungen in den Haupt-Zweig dieses Projektes mergen. Du wirst eine Benachrichtigungs Email bekommen sobald die Änderungen gemerged wurden. -Feiere deinen Beitrag zum Projekt und teile ihn mit deinen Freunden und Followern über unsere [Web-App](https://firstcontributions.github.io/#social-share). +## Was nun? -Wenn Du noch mehr üben möchtest, schau Dir das [Code-Contributions Repository](https://github.com/roshanjossey/code-contributions) an. -Falls du jetzt zu anderen Projekten beitragen möchtest, dann haben wir für dich eine Liste von einfachen, ersten Issues zusammengestellt, an denen du arbeiten kannst. Diese Projekt-Liste findest du [in unserer Web-App](https://firstcontributions.github.io/#project-list). +Gratulation! Du hast gerade den Standard _Forken -> Klonen -> Bearbeiten -> Pull-Request_ Workflow durchgeführt, dem du als Beitragender oft begegnen wirst! -## Tutorials mit anderen Tools +Feier deinen Beitrag und teile in mit deinen Freunden und Followern indem du hier drückst [web app](https://firstcontributions.github.io/#social-share). + +Wenn du gerne mehr Übung hättest, schau dir [code contributions](https://github.com/roshanjossey/code-contributions) an. + +Jetzt los gehts, mit Beiträgen zu anderen Projekten. Wir haben eine Liste von Projekten mit leichten Fehlern für Einsteiger bereitgestellt. Schau dir [die Liste der Projekte in der Web-App an](https://firstcontributions.github.io/#project-list) an. + +### [Zusätzliches Material](../additional-material) + +## Anleitungen für andere Tools | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | -| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | +| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | + +

Dieses Projekt wird unterstützt von:

+

+ + + +