mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-14 09:06:41 +00:00
105 lines
8.4 KiB
Markdown
105 lines
8.4 KiB
Markdown
[](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)
|
|
[](https://opensource.org/licenses/MIT)
|
|
[](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` και θα δείτε τις αλλαγές.
|
|

|
|
|
|
Προσθέστε αυτές τις αλλαγές στο κλαδί που μόλις δημιουργήσατε χρησιμοποιώντας την εντολή `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)
|