diff --git a/docs/translations/README.de.md b/docs/translations/README.de.md index 5f85f613..97388285 100644 --- a/docs/translations/README.de.md +++ b/docs/translations/README.de.md @@ -1,120 +1,250 @@ -[![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 +#### _Read this in [other languages](docs/translations/Translations.md)._ +[Shqip](docs/translations/README.al.md) +[Armenian](docs/translations/README.arm.md) +[Uzbek language](docs/translations/README.uz.md) +[Azərbaycan dili](docs/translations/README.aze.md) +[বাংলা](docs/translations/README.bn.md) +[Bulgarian](docs/translations/README.bg.md) +[Português (Brasil)](docs/translations/README.pt_br.md) +[Català](docs/translations/README.ca.md) +[中文 (Simplified)](docs/translations/README.zh-cn.md) +[Czech](docs/translations/README.cs.md) +[Deutsch](docs/translations/README.de.md) +[Dansk](docs/translations/README.da.md) +[المصرية](docs/translations/README.eg.md) +[Dezéiriya](docs/translations/README.dz.md) +[Español de España](docs/translations/README.es.md) +[Française](docs/translations/README.fr.md) +[Gaeilge](docs/translations/README.ga.md) +[Galego](docs/translations/README.gl.md) +[Ελληνικά](docs/translations/README.gr.md) +[ქართული](docs/translations/README.ge.md) +[Magyar](docs/translations/README.hu.md) +[Bahasa Indonesia](docs/translations/README.id.md) +[עִברִית](docs/translations/README.hb.md) +[हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்](docs/translations/Translations.md) +[தமிழ்](docs/translations/README.ta.md) +[فارسی](docs/translations/README.fa.md) +[Italiano](docs/translations/README.it.md) +[日本語](docs/translations/README.ja.md) +[සිංහල](docs/translations/README.si.md) +[Kiswahili (Kenya)](docs/translations/README.kws.md) +[한국어](docs/translations/README.ko.md) +[Lietuvių kalba](docs/translations/README.lt.md) +[Limba Română Limba Română](docs/translations/README.ro.md) +[မြန်မာ](docs/translations/README.mm_unicode.md) +[Македонски](docs/translations/README.mk.md) +[Español de México](docs/translations/README.mx.md) +[Bahasa Melayu / بهاس ملايو‎ / Malay](docs/translations/README.my.md) +[Dutch](docs/translations/README.nl.md) +[Norsk](docs/translations/README.no.md) +[नेपाली](docs/translations/README.np.md) +[Wikang Filipino](docs/translations/README.fil.md) +[English (Pirate)](docs/translations/README.en-pirate.md) +[اردو](docs/translations/README.ur.md) +[Twi (Ghana)](docs/translations/README.gh.md) +[Polski](docs/translations/README.pl.md) +[Português (Portugal)](docs/translations/README.pt-pt.md) +[Русский язык](docs/translations/README.ru.md) +[العربية](docs/translations/README.ar.md) +[Svenska](docs/translations/README.se.md) +[Slovenčina](docs/translations/README.slk.md) +[Slovenščina](docs/translations/README.sl.md) +[ภาษาไทย](docs/translations/README.th.md) +[Türkçe](docs/translations/README.tr.md) +[中文(Traditional)](docs/translations/README.zh-tw.md) +[Українська](docs/translations/README.ua.md) +[Tiếng Việt](docs/translations/README.vn.md) +[Swahili language](docs/translations/README.sw.md) +[Zulu (South Africa)](docs/translations/README.zul.md) +[Afrikaans (South Africa)](docs/translations/README.afk.md) +[Igbo (Nigeria)](docs/translations/README.igb.md) +[Bambara (Mali)](docs/translations/README.mli.md) +[Hausa (Nigeria)](docs/translations/README.hau.md) +[Yoruba (Nigeria)](docs/translations/README.yor.md) +[Latvia](docs/translations/README.lv.md) +[Suomeksi](docs/translations/README.fi.md) +[Беларуская мова](docs/translations/README.by.md) +[Српски](docs/translations/README.sr.md) +[Қазақша](docs/translations/README.kz.md) +[Bosanski](docs/translations/README.bih.md) +[Bosanski](docs/translations/README.bih.md) +[Hrvatski](docs/translations/README.hr.md) +[پښتو](docs/translations/README.ps.md) +[Somalia](docs/translations/README.so.md) +[Ecuador](docs/translations/README.ec.md) +[Luganda (Uganda)](docs/translations/README.lug.md) +[Turkmen language](docs/translations/README.tm.md) +[Ewe (TOGO)](docs/translations/README.ewe.md) +[አማርኛ](docs/translations/README.et.md) +[Kurdî](docs/translations/README.kr.md) +[Malagasy](docs/translations/README.mg.md) +[ភាសាខ្មែរ](docs/translations/README.kh.md) +[Moroccan Darija](docs/translations/README.ma.md) -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 sind tutorials für GUI Tools.](#tutorials-using-other-tools)_ -Wenn du Git noch nicht installiert hast, [installiere es](https://help.github.com/articles/set-up-git/) +fork this repository -## Repository forken +#### Wenn du Git nicht auf deinem System installiert hast, [installiere es](https://docs.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. +clone this repository -Öffne eine Kommandozeile und gib den folgenden git-Befehl ein: +Klone jetzt das geforkte Repository auf deinen Computer. Gehe zu dienem Github Account, öffne das geforkte Repository, klicke auf den Code Button, dann auf den HTTPS Tab und dann klicke das _copy url to clipboard_ icon. -``` -git clone "Deine kopierte URL" +Open a terminal and run the following git command: + +```bash +git clone "url you just copied" ``` -Statt 'Deine kopierte URL' (ohne Anführungszeichen) füge die Repository-URL aus dem vorherigen Schritt ein. +where "url you just copied" (without the quotation marks) is the url to this repository (your fork of this project). See the previous steps to obtain the url. -URL kopieren +copy URL to clipboard -Beispiel: +For example: -``` -git clone https://github.com/dein-Name/first-contributions.git +```bash +git clone git@github.com:this-is-you/first-contributions.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. +where `this-is-you` is your GitHub username. Here you're copying the contents of the first-contributions repository on GitHub to your computer. -## Erstelle einen Branch +## Create a branch -Wechsle zum Repository-Verzeichnis auf deinem Computer (falls du es nicht schon getan hast). +Change to the repository directory on your computer (if you are not already there): -``` +```bash cd first-contributions ``` -Erstelle nun einen Branch mit dem Befehl `git checkout`: +Now create a branch using the `git switch` command: -``` -git checkout -b +```bash +git switch -c your-new-branch-name ``` -Beispiel: +For example: -``` -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.) +
+ If you get any errors using git switch, click here: -## Mache die nötigen Änderungen und committe sie +If the error message "Git: `switch` is not a git command. See `git –help`" appears, it's likely because you're using an older version of git. -Ö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 this case, try to use `git checkout` instead: +```bash +git checkout -b your-new-branch-name ``` + +
+ +## Make necessary changes and commit those changes + +Now open `Contributors.md` file in a text editor, add your name to it. Don't add it at the beginning or end of the file. Put it anywhere in between. Now, save the file. + +git status + +If you go to the project directory and execute the command `git status`, you'll see there are changes. + +Add those changes to the branch you just created using the `git add` command: + +```bash git add Contributors.md ``` -Nun committest du deine Änderungen mit `git commit`: +Now commit those changes using the `git commit` command: -``` -git commit -m "Add to Contributors list" +```bash +git commit -m "Add your-name to Contributors list" ``` -Ersetze `` mit deinem Namen. +replacing `your-name` with your name. -## Pushe die Änderung zu GitHub +## Push changes to GitHub -Pushe die Änderungen mit `git push`: +Push your changes using the command `git push`: -``` -git push origin +```bash +git push -u origin your-branch-name ``` -Ersetze `` mit dem Namen des Branches, den du zuvor erstellt hast. +replacing `your-branch-name` with the name of the branch you created earlier. -## Sende deine Änderungen zum Review +
+ If you get any errors while pushing, click here: -Wenn du jetzt zu deinem Repository auf GitHub gehst, siehst du einen Knopf `Compare & pull request`. Klicke darauf. +- ### Authentication Error + 
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/'
+ Go to [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) on generating and configuring an SSH key to your account. -Erstelle einen pull request + Also, you might want to run 'git remote -v' to check your remote address. + + If it looks anything like this: + 
origin	https://github.com/your-username/your_repo.git (fetch)
+  origin	https://github.com/your-username/your_repo.git (push)
+ + change it using this command: + ```bash + git remote set-url origin git@github.com:your-username/your_repo.git + ``` + Otherwise you'll still get prompted for username and password and get authentication error. +
-Erstelle einen Pull Request indem du auf die Schaltfläche `Create pull request` klickst. +## Submit your changes for review -Pull Request senden +If you go to your repository on GitHub, you'll see a `Compare & pull request` button. Click on that button. -Roshan Jossey wird nun deine Änderungen in den Master-Branch dieses Projekts mergen. Du erhältst eine E-Mail, sobald dies geschehen ist. +create a pull request -## Wie geht es weiter? +Now submit the pull request. -Glückwunsch! Du hast soeben den Standard-Workflow _Fork -> Clone -> Edit -> Pull Request_ beendet, der dir als Mitwirkender häufig begegnen wird. +submit pull request -Feiere deinen Beitrag zum Projekt und teile ihn mit deinen Freunden und Followern über unsere [Web-App](https://firstcontributions.github.io/#social-share). +Soon I'll be merging all your changes into the main branch of this project. You will get a notification email once the changes have been merged. -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). +## Where to go from here? -## Tutorials mit anderen Tools +Congrats! You just completed the standard _fork -> clone -> edit -> pull request_ workflow that you'll often encounter as a contributor! -| 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) | +Celebrate your contribution and share it with your friends and followers by going to [web app](https://firstcontributions.github.io/#social-share). + +If you'd like more practice, checkout [code contributions](https://github.com/roshanjossey/code-contributions). + +Now let's get you started with contributing to other projects. We've compiled a list of projects with easy issues you can get started on. Check out [the list of projects in the web app](https://firstcontributions.github.io/#project-list). + +### [Additional material](docs/additional-material/git_workflow_scenarios/additional-material.md) + +## Tutorials Using Other Tools + +| GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | +| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [GitHub Desktop](docs/gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](docs/gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](docs/gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](docs/gui-tool-tutorials/github-windows-intellij-tutorial.md) | + +

This project is supported by:

+

+ + + +