mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-14 01:31:50 +00:00
108 lines
11 KiB
Markdown
108 lines
11 KiB
Markdown
[](https://github.com/ellerbrock/open-source-badges/)
|
|
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-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="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="200">|Έκδοση GitKraken|
|
|
|---|---|
|
|
|
|
Είναι δύσκολο. Είναι πάντα δύσκολο, όταν κάνετε κάτι για πρώτη φορά. Ειδικά όταν συνεργάζεστε, το να κάνεις κάποιο λάθος δεν είναι κάτι άνετο. Αλλά ο ανοιχτός κώδικας αφορά τη συνεργασία και τη συνεργασία. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο νέοι συνεισφέροντες ανοιχτού κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά.
|
|
|
|
Η ανάγνωση άρθρων και η παρακολούθηση εκπαιδευτικού υλικού μπορεί να βοηθήσει, αλλά τι είναι καλύτερο από το να κάνετε όντως κάτι χωρίς να χαλάσετε τίποτα. Αυτό το έργο έχει σκοπό να παρέχει καθοδήγηση και να απλοποίησει τον τρόπο με τον οποίο οι νέοι συνεισφέροντες μπορούν να κάνουν την πρώτη τους συνεισφορά. Θυμηθείτε, όσο πιο χαλαροί είστε, τόσο καλύτερα μαθαίνετε. Εάν θέλετε να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε απλά τα απλά βήματα παρακάτω. Σας υποσχόμαστε, θα είναι διασκεδαστικό.
|
|
|
|
## GitKraken
|
|
|
|
Κατεβάστε το [GitKraken](https://www.gitkraken.com), εγκαταστήστε το και ανοίξτε το.
|
|
|
|
Θα δείτε το παράθυρο "Καλώς ήρθατε στο GitKraken" - Συνδεθείτε με το GitHub και επιτρέψτε στο GitKraken να αποκτήσει πρόσβαση στον λογαριασμό σας στο GitHub.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-login.png" alt="login to GitHub" />
|
|
|
|
(προαιρετικά) Πηγαίνετε στο Αρχείο -> Προτιμήσεις και ορίστε τον κατάλογο του έργου σας στη ρίζα των τοπικών αποθετηρίων σας.
|
|
|
|
## Κάντε Fork αυτού του αποθετηρίου
|
|
|
|
Κάντε fork αυτό το αποθετήριο κάνοντας κλικ στο κουμπί fork στην κορυφή αυτής της σελίδας.
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/fork.png" alt="fork this repository" />
|
|
Αυτό θα δημιουργήσει ένα αντίγραφο αυτού του αποθετηρίου στο λογαριασμό σας.
|
|
|
|
## Κλωνοποίηση του αποθετηρίου
|
|
|
|
Στο GitKraken, πηγαίνετε στο Αρχείο -> Κλωνοποίηση Αποθετηρίου.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-clone.png" alt="clone this repository" />
|
|
|
|
Επιλέξτε το GitHub.com στο δεξί πλαίσιο. Κάτω από το όνομα χρήστη σας, θα πρέπει να δείτε το first-contributions. Κάντε κλικ σε αυτό το αποθετήριο και ελέγξτε την πλήρη διαδρομή που εμφανίζεται στο κάτω μέρος αυτού του παραθύρου.
|
|
|
|
Μόλις είστε ικανοποιημένοι με τη διαδρομή, κάντε κλικ στο "Κλωνοποίηση του αποθετηρίου!".
|
|
|
|
## Δημιουργία παρακλαδιού
|
|
|
|
Κάντε κλικ στο κουμπί παρακλαδιού στη γραμμή εργαλείων.
|
|
|
|
Ονομάστε το παρακλάδι σας "προσθήκη-του-ονόματός-σας", για παράδειγμα: "προσθήκη-ονόματος-William-Sutton"
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-branch.png" alt="name your branch" />
|
|
|
|
## Κάντε τις απαραίτητες αλλαγές και δεσμεύστε αυτές τις αλλαγές
|
|
|
|
Ανοίξτε τώρα το αρχείο `Contributors.md` σε έναν επεξεργαστή κειμένου και προσθέστε το όνομά σας σε αυτό, και στη συνέχεια αποθηκεύστε το αρχείο.
|
|
|
|
Εάν έχετε το αποθετήριο ανοικτό στο GitKraken, θα δείτε ότι υπάρχουν αλλαγές. Ελέγξτε και κάντε stage αυτές τις αλλαγές επιλέγοντας την νεότερη δέσμευση που είναι σημειωμένη με "// WIP" και τον αριθμό των αρχείων που έχουν αλλάξει και τον τύπο της αλλαγής.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-edit.png" alt="edit some file(s)" />
|
|
|
|
|
|
Επανεξετάστε τα αρχεία που έχουν αλλάξει και αποφασίστε τι θέλετε να τα κάνετε stage. Το staging είναι σημαντικό για να πείτε στο Git ακριβώς ποιες αλλαγές αρχείων θέλετε να συσχετίσετε με αυτήν τη δέσμευση.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-stage.png" alt="stage your changes" />
|
|
|
|
Αφού έχετε ένα καλό μήνυμα δεσμεύσεως ("Προσθήκη <του-ονόματός-σας> στη λίστα συνεισφερόντων" ακούγεται ωραίο και περιγραφικό) και είστε ικανοποιημένοι με τις αλλαγές σας, μπορείτε να πατήσετε "Stage όλων των αλλαγών" για να κάνετε stage όλα όσα έχουν τροποποιηθεί ή "Stage αρχείου" για να κάνετε stage ένα μεμονωμένο αρχείο.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-commit.png" alt="clone this repository" />
|
|
|
|
Εάν αλλάξετε γνώμη, μπορείτε να ακυρώσετε το staging αυτών των αλλαγών ή να τις απορρίψετε εντελώς.
|
|
ΠΡΟΕΙΔΟΠΟΙΗΣΗ: Όπως υποδηλώνει η λέξη απόρριψη, αυτή είναι μια καταστροφική λειτουργία. Κάντε αυτό μόνο εάν δεν θέλετε καμία αλλαγή από το αποθετήριο στο οποίο βρίσκεστε.
|
|
|
|
Πατήστε δέσμευση.
|
|
|
|
Συγχαρητήρια, έχετε δεσμεύσει όλες τις αλλαγές στο τοπικό αντίγραφο του κλαδιού σας του δικού σας fork του first-contributions. Συνεχίζουμε!
|
|
|
|
## Ανέβασμα αλλαγών στο GitHub
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-push.png" alt="push your changes" />
|
|
|
|
Πατήστε το κουμπί Ανέβασμα στη γραμμή εργαλείων.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-origin.png" alt="origin or branch" />
|
|
|
|
Υποβάλετε αλλαγές στο παρακλάδι origin εάν θέλετε οι αλλαγές να αντανακλούν απευθείας στον παρακλάδι master, διαφορετικά επιλέξτε το κατάλληλο παρακλάδι που θέλετε να ανεβάσετε.
|
|
|
|
## Υποβολή των αλλαγών σας για αξιολόγηση
|
|
|
|
Εάν πάτε στο αποθετήριο σας στο github, θα δείτε το κουμπί "Σύγκριση & αίτηση εξαγωγής". Κάντε κλικ σε αυτό το κουμπί.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/compare-and-pull.png" alt="create a pull request" />
|
|
|
|
Τώρα υποβάλετε το αίτημα εξαγωγής.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/submit-pull-request.png" alt="submit pull request" />
|
|
|
|
Σύντομα θα ενσωματώσω όλες τις αλλαγές σας στον κύριο παρακλάδι αυτού του έργου. Θα λάβετε μια ειδοποίηση με ηλεκτρονικό ταχυδρομείο αφού οι αλλαγές έχουν ενσωματωθεί.
|
|
|
|
## Πού να πάτε από εδώ;
|
|
|
|
Συγχαρητήρια! Μόλις ολοκληρώσατε την τυπική ροή _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#tutorials-using-other-tools)
|