reset repo

This commit is contained in:
Roshanjossey
2025-01-03 22:30:04 +01:00
commit b166a1d130
314 changed files with 31890 additions and 0 deletions
@@ -0,0 +1,132 @@
[![Αγάπη Ανοιχτού Κώδικα](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-old-version-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
[![Άδεια: MIT](https://img.shields.io/badge/Άδεια-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Βοηθοί Ανοιχτού Κώδικα](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions)
# Πρώτες Συνεισφορές
| <img alt="Git Bash" src="https://cdn.icon-icons.com/icons2/2699/PNG/512/git_scm_logo_icon_170096.png" width="200"> | Έκδοση Git Bash |
| ------------------------------------------------------------------------------------------------------------------ | ---------------- |
Είναι δύσκολο. Είναι πάντα δύσκολο την πρώτη φορά που κάνεις κάτι. Ειδικά όταν συνεργάζεσαι, το να κάνεις λάθη δεν είναι κάτι άνετο. Αλλά ο ανοιχτός κώδικας αφορά όλο το θέμα της συνεργασίας και της εργασίας από κοινού. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο οι νέοι συνεισφέροντες ανοιχτού κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά.
Η ανάγνωση άρθρων και η παρακολούθηση εκπαιδευτικών βίντεο μπορεί να βοηθήσει, αλλά τι μπορεί να είναι καλύτερο από το να κάνεις τα πράγματα χωρίς να κάνεις κανένα λάθος. Αυτό το έργο στοχεύει στην παροχή καθοδήγησης και στον απλοποιημένο τρόπο με τον οποίο οι αρχάριοι μπορούν να κάνουν την πρώτη τους συνεισφορά. Θυμηθείτε, όσο πιο χαλαροί είστε, τόσο καλύτερα μαθαίνετε. Αν ψάχνετε για να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε απλά τα ακόλουθα απλά βήματα. Σας υποσχόμαστε, θα είναι διασκεδαστικό.
Εάν δεν έχετε το Git Bash στον υπολογιστή σας με Windows, [εγκαταστήστε το](https://git-scm.com/download/win).
<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt="fork this repository" />
## Κλωνοποίηση αυτού του αποθετηρίου
Κλωνοποιήστε αυτό το αποθετήριο πατώντας το κουμπί "Fork" στην επάνω δεξιά γωνία αυτής της σελίδας.
Αυτό θα δημιουργήσει ένα αντίγραφο αυτού του αποθετηρίου στον λογαριασμό σας.
## Κλωνοποίηση του αποθετηρίου
Τώρα κλωνοποιήστε αυτό το αποθετήριο στη μηχανή σας.
ΣΗΜΑΝΤΙΚΟ: ΜΗΝ ΚΛΩΝΟΠΟΙΗΣΕΤΕ ΤΟ ΠΡΩΤΟΤΥΠΟ ΑΠΟΘΕΤΗΡΙΟ.
Πηγαίνετε στο fork σας και κλωνοποιήστε το.
Για να κλωνοποιήσετε το αποθετήριο, κάντε κλικ στο "Code" και στη συνέχεια αντιγράψτε το κείμενο παρακάτω.
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-1.png" alt="copy string" />
Ανοίξτε την εφαρμογή git bash που μόλις κατεβάσατε. Θα πρέπει να μοιάζει με την παρακάτω εικόνα αν βρίσκεται σε μηχανή με Windows.
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="open git bash terminal" />
Πηγαίνετε στον φάκελο όπου θέλετε να αποθηκεύσετε αυτό το έργο χρησιμοποιώντας αυτήν την εντολή
`cd <φάκελος>`
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-2.png" alt="cd into a folder" />
Χρησιμοποιήστε το κείμενο που αντιγράψατε στο προηγούμενο βήμα για να κλωνοποιήσετε το αποθετήριο χρησιμοποιώντας αυτήν την εντολή
`git clone <url-αποθετηρίου>`
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-2.png" alt="clone the repository" />
Πηγαίνετε στον κατάλογο όπου βρίσκεται το αποθετήριο και ανοίξτε το στο vs code για να κάνετε τις αλλαγές σας.
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-3.png" alt="cd into the newly cloned repo" />
## Δημιουργία κλαδιού
Τώρα δημιουργήστε ένα κλαδί χρησιμοποιώντας αυτήν την απλή εντολή. Αυτή η εντολή δεν δημιουργεί μόνο ένα κλαδί για εσάς, αλλά σας επιτρέπει επίσης να αλλάξετε σε αυτό το κλαδί.
```
git checkout -b <όνομα-κλαδιού>
```
Ονομάστε το κλαδί σας `<προσθέστε-το-όνομά-σας>`. Για παράδειγμα, "add-james-smith"
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-branch.png" alt="create a branch" />
## Κάντε τις απαραίτητες αλλαγές και κάντε εκείνες τις αλλαγές
Τώρα ανοίξτε το αρχείο `Contributors.md` σε έναν επεξεργαστή κειμένου, μεταβείτε στο τέλος της σελίδας και προσθέστε το όνομά σας σε αυτό, στη συνέχεια αποθηκεύστε το αρχείο.
Παράδειγμα: Εάν το όνομά σας είναι James Smith, Θα πρέπει να μοιάζει με αυτό.
\[James Smith](https://github.com/jamessmith)
Μπορείτε να δείτε ότι υπάρχουν αλλαγές στο Contributors.md απλά εκτελώντας αυτήν την εντολή
`git status`
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-status.png" alt="check the status" />
Τώρα κάντε commit αυτές τις αλλαγές:
Πρώτα προσθέστε την αλλαγή που κάνατε στην περιοχή σταγόνων χρησιμοποιώντας
`git add file-name`
Στη συνέχεια, γράψτε ένα μήνυμα
commit χρησιμοποιώντας αυτήν την εντολή
`git commit -m "Προσθήκη του-ονόματός-σας στη λίστα συντελεστών"`
Αντικαταστήστε το `<το-όνομα-σας>` με το όνομά σας.
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-commit.png" alt="commit changes" />
Για να δείτε αν έχει γίνει το commit σας μπορείτε να τρέξετε μια απλή εντολή `git log --oneline`.
## Αποστολή των αλλαγών στο GitHub
Αφού τελειώσετε με τα παραπάνω βήματα, μπορείτε να στείλετε τις αλλαγές σας χρησιμοποιώντας αυτήν την εντολή
`git push origin <όνομα-κλαδιού>`
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-push.png" alt="push changes" />
## Υποβολή των αλλαγών σας για αναθεώρηση
Εάν πάτε στο αποθετήριο σας στο GitHub, θα δείτε το κουμπί "Σύγκριση και αίτημα ενσωμάτωσης". πατήστε εκεί.
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="create a pull request" />
Τώρα υποβάλλετε το αίτημα ενσωμάτωσης.
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="submit pull request" />
Σύντομα θα ενσωματώσω όλες τις αλλαγές σας στον κύριο κλάδο αυτού του έργου. Θα λάβετε ένα email ειδοποίησης μόλις οι αλλαγές ενσωματωθούν.
## Πού να πάτε από εδώ;
Συγχαρητήρια! Μόλις ολοκληρώσατε την κανονική ροή εργασίας _fork -> clone -> edit -> PR_ που θα συναντήσετε συχνά ως συνεισφέροντες!
Γιορτάστε τη συνεισφορά σας και μοιραστείτε τη με τους φίλους και τους ακόλουθούς σας, πηγαίνοντας στην [ιστοσελίδα εφαρμογής](https://firstcontributions.github.io#social-share).
Μπορείτε να εγγραφείτε στην ομάδα μας στο slack σε περίπτωση που χρειάζεστε βοήθεια ή έχετε ερωτήσεις. [Εγγραφείτε στην ομάδα slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
### [Πρόσθετο υλικό](../additional-material/git_workflow_scenarios/additional-material.md)
## Οδηγοί χρήσης άλλων εργαλείων
[Πίσω στην κύρια σελίδα](https://github.com/firstcontributions/first-contributions/blob/main/translations/README.gr.md#%CE%B5%CE%BA%CF%80%CE%B1%CE%B9%CE%B4%CE%B5%CF%85%CF%84%CE%B9%CE%BA%CF%8C-%CF%85%CE%BB%CE%B9%CE%BA%CF%8C-%CF%87%CF%81%CE%AE%CF%83%CE%B7%CF%82-%CE%AC%CE%BB%CE%BB%CF%89%CE%BD-%CE%B5%CF%81%CE%B3%CE%B1%CE%BB%CE%B5%CE%AF%CF%89%CE%BD)
@@ -0,0 +1,104 @@
[![Αγάπη για το Open Source](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
[![Άδεια: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Βοηθοί Open Source](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions)
# Πρώτες Συνεισφορές
| <img alt="GitHub Desktop" src="https://cdn.icon-icons.com/icons2/2157/PNG/512/github_git_hub_logo_icon_132878.png" width="200"> | Επιφάνεια Εργασίας GitHub (GitHub Desktop) |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------|
Αυτός είναι ο οδηγός μας για εμάς, τους "νερντς" του τερματικού, που θέλουμε να κάνουμε τα πάντα στο τερματικό και, χάρη στο [Github-CLI](https://cli.github.com/), μπορούμε να το επιτύχουμε. Να θυμάστε ότι η πρώτη σας συνεισφορά πρέπει να είναι διασκεδαστική, επαναφέρουσα και κινητήριο για να συνεχίσετε!
Αυτός ο οδηγός είναι λίγο πιο προκλητικός, καθώς δεν χρησιμοποιούμε καθόλου γραφική διεπαφή, αλλά είναι πολύ διασκεδαστικός και σίγουρα μπορείτε να τον ακολουθήσετε!
Το πρώτο προαπαιτούμενο είναι να έχετε:
- Εγκατεστημένο το Git (πώς να εγκαταστήσετε το [git](https://git-scm.com/downloads))
- Λογαριασμό GitHub
Τώρα χρειάζεται να εγκαταστήσουμε το εργαλείο `github-cli` στο σύστημά μας ακολουθώντας την [επίσημη τεκμηρίωση](https://github.com/cli/cli#installation)
Μετά από αυτό, πρέπει να συνδεθούμε στο CLI, οπότε εκτελέστε αυτήν την εντολή:
```bash
gh auth login
```
Ακολουθήστε τις οδηγίες και είμαστε έτοιμοι!
# Fork αυτό το αποθετήριο
Είναι τόσο εύκολο όσο το να εκτελέσετε αυτήν την εντολή:
```bash
gh repo fork firstcontributions/first-contributions
```
**Σημαντικό: Θα σας εμφανίσει εάν θέλετε να το κλωνοποιήσετε επίσης, επιλέξτε την επιλογή "ναι"**
# Δημιουργία του κλαδιού σας
Θα κάνουμε αυτό το βήμα με το git, οπότε εκτελέστε αυτήν την εντολή αντικαθιστώντας το όνομα με το όνομά σας, για παράδειγμα:
```bash
git switch -c add-john-doe
```
# Κάντε τις απαραίτητες αλλαγές και κάντε commit τις αλλαγές σας
Τώρα μπορείτε να ανοίξετε το αρχείο `Contributors.md` σε έναν επεξεργαστή κειμένου και να προσθέσετε το όνομά σας. Β
άλτε το όνομά σας οπουδήποτε μεταξύ αρχής και τέλους, και στη συνέχεια αποθηκεύστε το αρχείο.
Στον φάκελο του έργου, εκτελέστε `git status` και θα δείτε τις αλλαγές.
![image-git](https://camo.githubusercontent.com/a35c4722d7aab337eefc655d1488f7b4dc038508e6adaf5e88e2e052a976f010/68747470733a2f2f6669727374636f6e747269627574696f6e732e6769746875622e696f2f6173736574732f526561646d652f6769742d7374617475732e706e67)
Προσθέστε αυτές τις αλλαγές στο κλαδί που μόλις δημιουργήσατε χρησιμοποιώντας την εντολή `git add`:
`git add Contributors.md`
Τώρα κάντε commit αυτές τις αλλαγές χρησιμοποιώντας την εντολή `git commit`:
`git commit -m "Προσθήκη του-ονόματός-σας στη λίστα συντελεστών"`
αντικαθιστώντας το `το-όνομα-σας` με το όνομά σας.
# Ανέβασμα των αλλαγών στο GitHub
Ανεβάστε τις αλλαγές σας χρησιμοποιώντας την εντολή `git push`:
```
git push origin -u το-όνομα-του-κλαδιού-σας
```
αντικαθιστώντας το `το-όνομα-του-κλαδιού-σας` με το όνομα του κλαδιού που δημιουργήσατε προηγουμένως.
<details>
<summary> <strong>Εάν παρατηρήσετε οποιοδήποτε σφάλμα κατά την αποστολή, κάντε κλικ εδώ:</strong> </summary>
- ### Σφάλμα Πιστοποίησης
<pre>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/'</pre>
Πηγαίνετε στο [οδηγό του GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) για τη δημιουργία και διαμόρφωση ενός κλειδιού SSH στον λογαριασμό σας.
</details>
# Υποβολή των αλλαγών σας για αναθεώρηση
Τώρα εκτελώντας αυτήν την εντολή στον φάκελο του αποθετηρίου μας θα μας επιτρέψει να δημιουργήσουμε ένα αίτημα ενσωμάτωσης για αναθεώρηση:
```bash
gh pr create --repo firstcontributions/first-contributions
```
Μετά από αυτό υποβάλετε το αίτημα ενσωμάτωσης.
Μπορείτε να χρησιμοποιήσετε την εντολή `gh status` για να δείτε το αναφερόμενο αίτημα ενσωμάτωσης σε δράση.
## Πού να πάτε από εδώ;
Συγχαρητήρια! Μόλις ολοκληρώσατε την κανονική ροή εργασίας _fork -> clone -> edit -> pull request_ που θα συναντήσετε συχνά ως συνεισφέροντες!
Γιορτάστε τη συνεισφορά σας και μοιραστείτε τη με τους φίλους και τους ακόλουθούς σας πηγαίνοντας στην [ιστοσελίδα εφα
ρμογής](https://firstcontributions.github.io/#social-share).
Μπορείτε να εγγραφείτε στην ομάδα μας στο Slack αν χρειάζεστε βοήθεια ή έχετε οποιεσδήποτε ερωτήσεις. [Εγγραφή στην ομάδα Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA).
Τώρα ας ξεκινήσουμε με τη συνεισφορά σας σε άλλα έργα. Έχουμε συγκεντρώσει μια λίστα με έργα με εύκολα ζητήματα με τα οποία μπορείτε να ξεκινήσετε. Ρίξτε μια ματιά στη [λίστα των έργων στην ιστοσελίδα εφαρμογής](https://firstcontributions.github.io/#project-list).
### [Πρόσθετο υλικό](additional-material/git_workflow_scenarios/additional-material.md)
## Οδηγοί με Άλλα Εργαλεία
[Πίσω στην κύρια σελίδα](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
@@ -0,0 +1,101 @@
[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
[![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)
# Перші внески
| <img alt="GitHub Desktop" src="https://cdn.icon-icons.com/icons2/2157/PNG/512/github_git_hub_logo_icon_132878.png" width="200"> | Інтерфейс командного рядка GitHub (CLI) |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------|
Це керівництво для нас, нердів, які хочуть робити все у терміналі, і завдяки [Github-CLI](https://cli.github.com/), ми можемо досягти цього, пам'ятаючи, що ваш перший внесок повинен бути цікавим, корисним та мотивувати до подальшої роботи!
Це керівництво трохи складніше, оскільки ми зовсім не використовуємо графічний інтерфейс, але це все ще дуже цікаво і ви точно зможете його виконати крок за кроком!
Перша умова - мати:
- Встановлений Git ([як встановити git](https://git-scm.com/downloads))
- Обліковий запис на Github
Тепер нам потрібно встановити інструмент `github-cli` у нашу систему, виконавши кроки з [офіційної документації](https://github.com/cli/cli#installation)
Після цього нам потрібно увійти до CLI, застосовуючи цю команду:
```bash
gh auth login
```
Дотримуйтесь інструкцій, і ми готові починати!
# Відгалужуємо репозиторій
Це робиться, всього навсього, за допомогою однієї команди:
```bash
gh repo fork firstcontributions/first-contributions
```
**Важливо: Якщо ви хочете одразу клонувати репозиторій, виберіть варіант "yes" **
# Створюємо свою гілку
Ми зробимо цей крок за допомогою git, тому введіть цю команду, замінивши `taras-shevchenko` на ваше ім'я:
```bash
git switch -c add-taras-shevchenko
```
# Вносимо необхідні зміни та записуємо їх
Тепер ви можете відкрити файл `Contributors.md` в текстовому редакторі і додати до нього своє ім'я. Впишіть своє ім'я десь між початком і кінцем, а потім збережіть файл.
У директорії проекту виконайте команду `git status`, і ви побачите виконані зміни.
![image-git](https://camo.githubusercontent.com/a35c4722d7aab337eefc655d1488f7b4dc038508e6adaf5e88e2e052a976f010/68747470733a2f2f6669727374636f6e747269627574696f6e732e6769746875622e696f2f6173736574732f526561646d652f6769742d7374617475732e706e67)
Додайте ці зміни до гілки, яку ви щойно створили, використовуючи команду `git add`:
`git add Contributors.md`
Тепер запишіть ці зміни за допомогою команди `git commit`:
`git commit -m "Add taras-shevchenko to Contributors list`
замінюючи `taras-shevchenko` на ваше ім'я.
# Відправляємо зміни в GitHub
Відправте свої зміни за допомогою команди `git push`:
```bash
git push origin -u your-branch-name
```
замініть `your-branch-name` ім'ям гілки, яку ви створили раніше.
<details>
<summary><strong>Якщо ви отримаєте помилки під час відправки, натисніть тут:</strong></summary>
- ### Помилка автентифікації
<pre>remote: Підтримка автентифікації за допомогою пароля була припинена 13 серпня 2021 року. Замість цього використовуйте особистий токен доступу.
remote: Будь ласка, перегляньте https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ для отримання більш докладної інформації.
fatal: Автентифікація завершилася помилкою для 'https://github.com/<your-username>/first-contributions.git/'</pre>
Перейдіть до [посібника GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) щодо створення та налаштування SSH-ключа для вашого облікового запису.
</details>
# Створюємо запит на рецензування своїх змін
Тепер, запускаючи цю команду у директорії нашого репозиторію, ми зможемо створити запит на витяг (pull request) для рецензування.
```bash
gh pr create --repo firstcontributions/first-contributions
```
Після цього подайте запит на витяг.
Ви можете використати команду `gh status`, щоб побачити ваш вищезгаданий запит на витяг у дії.
## Що далі?
Вітаємо! Ви щойно завершили стандартний робочий процес _fork -> clone -> edit -> pull request_, який часто зустрічається серед співавторів open source проектів!
Відзначте свій внесок та поділіться ним з друзями та підписниками, перейшовши до [веб-додатку](https://firstcontributions.github.io/#social-share).
Ви можете приєднатися до нашої [команди у Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA), якщо вам потрібна допомога чи у вас є які-небудь питання.
Тепер ви можете розпочати робити ваш внесок до інших проектів. Ми склали список проектів з легкими проблемами, з яких ви можете почати. [Посилання до списку проектів](https://firstcontributions.github.io/#project-list).
### [Додатковий матеріал](https://github.com/firstcontributions/first-contributions/blob/main/additional-material/git_workflow_scenarios/additional-material.md)
## Навчальні посібники з використанням інших інструментів
[Повернутися на головну сторінку](https://github.com/firstcontributions/first-contributions/blob/main/translations/README.ua.md#%D1%96%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D1%96%D1%97-%D0%B4%D0%BB%D1%8F-%D1%96%D0%BD%D1%88%D0%B8%D1%85-%D1%96%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D1%96%D0%B2)
@@ -0,0 +1,97 @@
[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
[![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)
# ആദ്യ സംഭാവനകൾ (First Contributions)
| <img alt="GitHub Desktop" src="https://cdn.icon-icons.com/icons2/2157/PNG/512/github_git_hub_logo_icon_132878.png" width="100"> | GitHub കമാൻഡ് ലൈൻ ഇൻ്റർഫേസ് (CLI) |
| ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
ടെർമിനൽ ഉപയോഗിച്ച് എല്ലാം ചെയ്യാൻ ആഗ്രഹിക്കുന്ന നമുക്ക് വേണ്ടി ഉള്ളതാണ് ഈ വഴികാട്ടി (ഗൈഡ് ). [Github-CLI](https://cli.github.com/)ക്ക് നന്ദി , നമുക്ക് ഇപ്പോൾ അത് സാധ്യമാണ് . നിങ്ങളുടെ ആദ്യ സംഭാവന (first contribution) ഓർമ്മിക്കുന്നത് രസകരവും പ്രതിഫലദായകവും മുന്നോട്ട് പോകുവാൻ പ്രചോദനം നല്കുന്നതുമായിരിക്കണം !
ഒരു ഗ്രാഫിക്കൽ ഇൻ്റർഫേസും ഉപയോഗിക്കാത്തതിനാൽ ഈ ഗൈഡ് അൽപ്പം വെല്ലുവിളി നിറഞ്ഞതാണെങ്കിലും, ഇത് ഇപ്പോഴും വളരെ രസകരവും , തീർച്ചയായും നിങ്ങൾക്ക് പിന്തുടരാനാകുന്നതുമാണ് !
തുടങ്ങുന്നതിന് ആവശ്യമായ കാര്യങ്ങൾ:
- Git ഇൻസ്റ്റാൾ ചെയ്യുക ( എങ്ങിനെ [git](https://git-scm.com/downloads) ഇൻസ്റ്റാൾ ചെയ്യണം )
- Git അക്കൗണ്ട്
ഇനി നിങ്ങളുടെ കമ്പ്യൂട്ടറിലേക്ക് `github-cli` ടൂൾ ഇൻസ്റ്റാൾ ചെയ്യുന്നതിനായി [ഔദ്യോഗിക ഡോക്യൂമെന്റേഷൻ ](https://github.com/cli/cli#installation)'ൽ പറഞ്ഞിരിക്കുന്ന നിർദ്ദേശങ്ങൾ പിന്തുടരുക.
അതിനു ശേഷം CLI'ലേക്ക് ലോഗിൻ ചെയ്യുന്നതിനായി താഴെ പറയുന്ന കമാൻഡ് ഉപയോഗിക്കുക
```bash
gh auth login
```
താഴെ പറയുന്ന നിർദ്ദേശങ്ങൾ പാലിക്കുന്നതോടു കൂടി നിങ്ങൾ തയ്യാറായി കഴിഞ്ഞു
# ഈ റെപ്പോസിറ്ററി ഫോർക് ചെയ്യുക
ഇതിനായി താഴെ പറയുന്ന കമാൻഡ് റൺ ചെയ്‌താൽ മാത്രം മതി
```bash
git switch -c add-john-doe
```
# ആവശ്യമായ മാറ്റങ്ങൾ വരുത്തിയതിനു ശേഷം അത് കമ്മിറ്റ് ചെയ്യുക
ഇനി നിങ്ങൾക് `Contributors.md` ഫയൽ ഒരു ടെക്സ്റ്റ് എഡിറ്റർ ഉപയോഗിച്ച് തുറന്ന് നിങ്ങളുടെ പേര് അതിൽ ചേർക്കാവുന്നതാണ് . തുടക്കത്തിന്റെയും അവസാനത്ത്തിന്റെയും ഇടയിൽ എവിടെയെങ്കിലും ഒരു സ്ഥാനത്ത് നിങ്ങളുടെ പേര് ചേർത്തതിന് ശേഷം ഫയൽ സേവ് ചെയ്യുക.
പ്രൊജക്റ്റ് ഡിറക്ടറിയിൽ `git status` എന്ന കമാൻഡ് ഉപയോഗിച്ച് നിങ്ങൾക് നിങ്ങൾ വരുത്തിയ മാറ്റങ്ങൾ കാണാനാകുന്നതാണ്.
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
ആ മാറ്റങ്ങൾ `git add` കമാൻഡ് ഉപയോഗിച്ച് നിങ്ങളുടെ ബ്രാഞ്ചിലേക്ക് ചേർക്കുക:
`git add Contributors.md`
ഇനി ഈ മാറ്റങ്ങൾ `git commit`കമാൻഡ് ഉപയോഗിച്ച് കമ്മിറ്റ് ചെയ്യുക:
`git commit -m "Add your-name to Contributors list`
`your-name`നു പകരം നിങ്ങളുടെ പേര് ആണ് ഉപയോഗിക്കേണ്ടത് .
# മാറ്റങ്ങൾ github'ലേക്ക് പുഷ് ചെയ്യുക
നിങ്ങൾ വരുത്തിയ മാറ്റങ്ങൾ `git push` കമാൻഡ് ഉപയോഗിച്ച് പുഷ് ചെയ്യുക:
```
git push origin -u your-branch-name
```
`your-branch-name`നു പകരം നിങ്ങൾ നേരത്തെ ഉണ്ടാക്കിയ ബ്രാഞ്ചിന്റെ പേര് വേണം ഉപയോഗിക്കാൻ.
<details>
<summary> <strong>പുഷ് ചെയ്യുന്നതിനിടക്ക് പ്രശനങ്ങൾ(errors) സംഭവിക്കുകയാണെങ്കിൽ ഇവിടെ ക്ലിക്ക് ചെയ്യുക :</strong> </summary>
- ### പ്രാമാണീകരണപിശക് (Authentication Error)
<pre>റിമോട്ട്: പാസ്‌വേഡ് പ്രാമാണീകരണത്തിനുള്ള പിന്തുണ 2021 ഓഗസ്റ്റ് 13-ന് നീക്കം ചെയ്‌തു. പകരം ഒരു വ്യക്തിഗത ആക്‌സസ് ടോക്കൺ ഉപയോഗിക്കുക.
റിമോട്ട്: കൂടുതൽ വിവരങ്ങൾക്ക് https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ കാണുക.
fatal:'https://github.com/<your-username>/first-contributions.git/'ലേക്കുള്ള authentication പരാജയപ്പെട്ടു .</pre>
നിങ്ങളുടെ അക്കൗണ്ടിലേക്ക് ഒരു SSH കീ നിർമ്മിക്കുവാനും ക്രമീകരിക്കുവാനുമായി ഈ ലിങ്കിലേക്ക് പോകുക [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) .
</details>
## നിങ്ങളുടെ വ്യത്യാസങ്ങൾ പരിശോധനക്കായി (review) സമർപ്പിക്കുക
നിങ്ങളുടെ റെപ്പോസിറ്റോറിയിൽ താഴെ പറയുന്ന കമാൻഡ് റൺ ചെയ്യുന്നതോടെ പരിശോധനക്കായി ഒരു pull request ഉണ്ടാക്കുവാൻ നിങ്ങൾക് സാധിക്കും.
```bash
gh pr create --repo firstcontributions/first-contributions
```
അതിനു ശേഷം pull request സമർപ്പിക്കുക.
നിങ്ങളുടെ സൂചിപ്പിച്ച pull request പ്രവർത്തനക്ഷമമായി കാണുന്നതിന് നിങ്ങൾക്ക് `gh status`കമാൻഡ് ഉപയോഗിക്കാം.
## ഇവിടെ നിന്ന് ഇനി എങ്ങോട്ട്?
അഭിനന്ദനങ്ങൾ! ഒരു സംഭാവകൻ എന്ന നിലയിൽ നിങ്ങൾ പലപ്പോഴും അഭിമുഖീകരിക്കുന്ന സ്റ്റാൻഡേർഡ് ഫോർക്ക് -> ക്ലോൺ -> എഡിറ്റ് -> പുൾ അഭ്യർത്ഥന വർക്ക്ഫ്ലോ നിങ്ങൾ ഇപ്പോൾ പൂർത്തിയാക്കി!
തങ്ങളുടെ സംഭാവന സുഹൃത്തുക്കളും പിൻഗാമികളും ആയി പങ്കിടുന്നതിനും ആഘോഷിക്കുന്നതിനും ആയി [വെബ് ആപ്പ് ](https://firstcontributions.github.io/#social-share)ലേക്ക് പോകുക.
താങ്കൾക് എന്ധെങ്കിലും സഹായം വേണമെങ്കിലോ എന്ധെങ്കിലും ചോദ്യങ്ങൾ ഉണ്ടെങ്കിലോ നമ്മുടെ Slack ടീമിൽ ചേരാവുന്നതാണ് . [Slack ടീമിൽ ചേരുക ](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA).
ഇനി താങ്കൾക് മറ്റു പ്രോജെക്ടസിലേക്കും സംഭാവന നടത്താൻ സാധിക്കും. താങ്കൾക് ചെയ്ത തുടങ്ങാവുന്ന എളുപ്പമുള്ള പിശകുകൾ ഉള്ള പ്രോജെക്ടസിന്റെ ഒരു ലിസ്റ്റ് ഞങ്ങൾ തയ്യാറാക്കിയിട്ടുണ്ട്. [പ്രോജക്ടുകളുടെ ലിസ്റ്റ് ](https://firstcontributions.github.io/#project-list) കാണുക .
### [കൂടുതൽ വായിക്കുക](../additional-material/git_workflow_scenarios/additional-material.md)
## മറ്റു ടൂൾസ് ഉപയോഗിച്ച് ചെയ്യുന്നതിനുള്ള നിർദ്ദേശങ്ങൾ
[പ്രധാന പേജിലേക്ക് പോകുക ](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
@@ -0,0 +1,102 @@
# first
[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
[![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)
# पहला योगदान
| <img alt="GitHub Desktop" src="https://cdn.icon-icons.com/icons2/2157/PNG/512/github_git_hub_logo_icon_132878.png" width="200"> | GitHub Command Line Interface (CLI) |
| ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
यह हमारे लिए एक गाइड है, टर्मिनल नर्ड, जो टर्मिनल में सब कुछ करना चाहते हैं, और इसके लिए धन्यवाद [Github-CLI](https://cli.github.com/) उनके कारण इसे प्राप्त कर सकते हैं, आपका पहला योगदान याद रखना मजेदार, पुरस्कृत और आगे बढ़ने के लिए प्रेरक होना चाहिए!
यह मार्गदर्शिका थोड़ी अधिक चुनौतीपूर्ण है क्योंकि हम किसी भी चित्रात्मक इंटरफ़ेस का उपयोग नहीं कर रहे हैं, लेकिन यह अभी भी सचमुच में मज़ेदार है और आप निश्चित रूप से इसका अनुसरण कर सकते हैं!
पहली आवश्यकता है:
- Git installed ([Git](https://git-scm.com/downloads) कैसे स्थापित करें)
- Github खाता
अब हमें आधिकारिक दस्तावेज़ीकरण का पालन करके अपने सिस्टम में `github-cli` टूल इंस्टॉल करना होगा
उसके बाद, हमें CLI में लॉगिन करने की आवश्यकता है, इसलिए यह आदेश दर्ज करें:
```bash
gh auth login
```
निर्देशों का पालन करें और हम तैयार हैं!
# Fork this repository
इस आदेश को चलाना उतना ही आसान है:
```bash
gh repo fork firstcontributions/first-contributions
```
**महत्वपूर्ण: यह आपको संकेत देगा कि यदि आप इसे भी क्लोन करना चाहते हैं, तो "yes" चुनें**
# अपनी शाखा बनाएँ
हम इस कदम को `git` के साथ करेंगे, इसलिए इस आदेश को अपने नाम के साथ नाम बदलकर दर्ज करें, उदाहरण के लिए:
```bash
git switch -c add-जॉन-डूई
```
# आवश्यक बदलना करें और उन बदलना को करें `commit`
अब आप टेक्स्ट एडिटर में `Contributors.md` फ़ाइल खोल सकते हैं और उसमें अपना नाम जोड़ सकते हैं। शुरुआत और अंत के बीच अपना नाम कहीं भी रखें, फिर फाइल को सेव करें।
प्रोजेक्ट डायरेक्टरी में `git status` निष्पादित करें और आप परिवर्तन देखेंगे।
![image-git](https://camo.githubusercontent.com/a35c4722d7aab337eefc655d1488f7b4dc038508e6adaf5e88e2e052a976f010/68747470733a2f2f6669727374636f6e747269627574696f6e732e6769746875622e696f2f6173736574732f526561646d652f6769742d7374617475732e706e67)
उन परिवर्तनों को उस शाखा में जोड़ें जिसे आपने अभी `git add` कमांड का उपयोग करके बनाया है:
`git add Contributors.md`
अब `git commit` कमांड का उपयोग करके उन परिवर्तनों को करें: `git commit -m "Add your-name to Contributors list` अपने नाम के साथ `your-name` बदलें।
# Github में परिवर्तन पुश करें
`git push` कमांड का उपयोग करके अपने परिवर्तन पुश करें:
git push origin -u your-branch-name
`your-branch-name` आपके द्वारा पहले बनाई गई शाखा के नाम से बदलकर।
<details><summary> <strong>यदि आपको पुश करते समय कोई त्रुटि मिलती है, तो यहां क्लिक करें:</strong></summary></details>
- ### प्रमाणीकरण त्रुटि
रिमोट: 13 अगस्त, 2021 को पासवर्ड प्रमाणीकरण के लिए समर्थन हटा दिया गया था। कृपया इसके बजाय एक व्यक्तिगत एक्सेस टोकन का उपयोग करें। दूरस्थ: अधिक जानकारी के लिए कृपया https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ देखें। घातक: 'https://github.com/' के लिए प्रमाणीकरण विफल /प्रथम-योगदान.गिट/'
अपने खाते में SSH कुंजी बनाने और कॉन्फ़िगर करने के लिए [GitHub के ट्यूटोरियल](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) पर जाएं।
# समीक्षा के लिए अपने परिवर्तन सबमिट करें
अब इस आदेश को हमारे रेपो की निर्देशिका में चलाने से हम समीक्षा के लिए एक पुल अनुरोध बना सकेंगे:
```bash
gh pr create --repo firstcontributions/first-contributions
```
इसके बाद पुल रिक्वेस्ट सबमिट करें।
अपने उल्लेखित पुल अनुरोध को क्रियाशील देखने के लिए आप `gh status` कमांड का उपयोग कर सकते हैं।
## यहाँ से कहाँ जाएं?
बधाई हो! आपने अभी-अभी मानक _कांटा पूरा किया है -> क्लोन -> संपादित करें -> पुल अनुरोध_ वर्कफ़्लो जिसे आप अक्सर एक योगदानकर्ता के रूप में सामना करेंगे!
अपने योगदान का जश्न मनाएं और इसे [वेब ऐप](https://firstcontributions.github.io/#social-share) पर जाकर अपने दोस्तों और फॉलोअर्स के साथ साझा करें।
अगर आपको कोई मदद चाहिए या कोई सवाल है तो आप हमारी सुस्त टीम में शामिल हो सकते हैं। [सुस्त टीम में शामिल हों](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA) ।
आइए अब आपको अन्य परियोजनाओं में योगदान के साथ आरंभ करते हैं। हमने उन आसान मुद्दों के साथ परियोजनाओं की एक सूची तैयार की है जिन पर आप शुरुआत कर सकते हैं। [वेब ऐप में परियोजनाओं की सूची](https://firstcontributions.github.io/#project-list) देखें।
### [अतिरिक्त सामग्री](additional-material/git_workflow_scenarios/additional-material.md)
## ट्यूटोरियल अन्य उपकरणों का उपयोग करना
[मुख्य पृष्ठ पर वापस](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)