mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-14 17:21:51 +00:00
133 lines
10 KiB
Markdown
133 lines
10 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-old-version-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
|
[](https://opensource.org/licenses/MIT)
|
|
[](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)
|