Roshanjossey
10 KiB
Πρώτες Συνεισφορές
 |
Έκδοση Git Bash |
|---|
Είναι δύσκολο. Είναι πάντα δύσκολο την πρώτη φορά που κάνεις κάτι. Ειδικά όταν συνεργάζεσαι, το να κάνεις λάθη δεν είναι κάτι άνετο. Αλλά ο ανοιχτός κώδικας αφορά όλο το θέμα της συνεργασίας και της εργασίας από κοινού. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο οι νέοι συνεισφέροντες ανοιχτού κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά.
Η ανάγνωση άρθρων και η παρακολούθηση εκπαιδευτικών βίντεο μπορεί να βοηθήσει, αλλά τι μπορεί να είναι καλύτερο από το να κάνεις τα πράγματα χωρίς να κάνεις κανένα λάθος. Αυτό το έργο στοχεύει στην παροχή καθοδήγησης και στον απλοποιημένο τρόπο με τον οποίο οι αρχάριοι μπορούν να κάνουν την πρώτη τους συνεισφορά. Θυμηθείτε, όσο πιο χαλαροί είστε, τόσο καλύτερα μαθαίνετε. Αν ψάχνετε για να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε απλά τα ακόλουθα απλά βήματα. Σας υποσχόμαστε, θα είναι διασκεδαστικό.
Εάν δεν έχετε το Git Bash στον υπολογιστή σας με Windows, εγκαταστήστε το.
Κλωνοποίηση αυτού του αποθετηρίου
Κλωνοποιήστε αυτό το αποθετήριο πατώντας το κουμπί "Fork" στην επάνω δεξιά γωνία αυτής της σελίδας. Αυτό θα δημιουργήσει ένα αντίγραφο αυτού του αποθετηρίου στον λογαριασμό σας.
Κλωνοποίηση του αποθετηρίου
Τώρα κλωνοποιήστε αυτό το αποθετήριο στη μηχανή σας.
ΣΗΜΑΝΤΙΚΟ: ΜΗΝ ΚΛΩΝΟΠΟΙΗΣΕΤΕ ΤΟ ΠΡΩΤΟΤΥΠΟ ΑΠΟΘΕΤΗΡΙΟ.
Πηγαίνετε στο fork σας και κλωνοποιήστε το.
Για να κλωνοποιήσετε το αποθετήριο, κάντε κλικ στο "Code" και στη συνέχεια αντιγράψτε το κείμενο παρακάτω.
Ανοίξτε την εφαρμογή git bash που μόλις κατεβάσατε. Θα πρέπει να μοιάζει με την παρακάτω εικόνα αν βρίσκεται σε μηχανή με Windows.
Πηγαίνετε στον φάκελο όπου θέλετε να αποθηκεύσετε αυτό το έργο χρησιμοποιώντας αυτήν την εντολή
cd <φάκελος>
Χρησιμοποιήστε το κείμενο που αντιγράψατε στο προηγούμενο βήμα για να κλωνοποιήσετε το αποθετήριο χρησιμοποιώντας αυτήν την εντολή
git clone <url-αποθετηρίου>
Πηγαίνετε στον κατάλογο όπου βρίσκεται το αποθετήριο και ανοίξτε το στο vs code για να κάνετε τις αλλαγές σας.
Δημιουργία κλαδιού
Τώρα δημιουργήστε ένα κλαδί χρησιμοποιώντας αυτήν την απλή εντολή. Αυτή η εντολή δεν δημιουργεί μόνο ένα κλαδί για εσάς, αλλά σας επιτρέπει επίσης να αλλάξετε σε αυτό το κλαδί.
git checkout -b <όνομα-κλαδιού>
Ονομάστε το κλαδί σας <προσθέστε-το-όνομά-σας>. Για παράδειγμα, "add-james-smith"
Κάντε τις απαραίτητες αλλαγές και κάντε εκείνες τις αλλαγές
Τώρα ανοίξτε το αρχείο Contributors.md σε έναν επεξεργαστή κειμένου, μεταβείτε στο τέλος της σελίδας και προσθέστε το όνομά σας σε αυτό, στη συνέχεια αποθηκεύστε το αρχείο.
Παράδειγμα: Εάν το όνομά σας είναι James Smith, Θα πρέπει να μοιάζει με αυτό.
[James Smith](https://github.com/jamessmith)
Μπορείτε να δείτε ότι υπάρχουν αλλαγές στο Contributors.md απλά εκτελώντας αυτήν την εντολή
git status
Τώρα κάντε commit αυτές τις αλλαγές:
Πρώτα προσθέστε την αλλαγή που κάνατε στην περιοχή σταγόνων χρησιμοποιώντας
git add file-name
Στη συνέχεια, γράψτε ένα μήνυμα
commit χρησιμοποιώντας αυτήν την εντολή
git commit -m "Προσθήκη του-ονόματός-σας στη λίστα συντελεστών"
Αντικαταστήστε το <το-όνομα-σας> με το όνομά σας.
Για να δείτε αν έχει γίνει το commit σας μπορείτε να τρέξετε μια απλή εντολή git log --oneline.
Αποστολή των αλλαγών στο GitHub
Αφού τελειώσετε με τα παραπάνω βήματα, μπορείτε να στείλετε τις αλλαγές σας χρησιμοποιώντας αυτήν την εντολή
git push origin <όνομα-κλαδιού>
Υποβολή των αλλαγών σας για αναθεώρηση
Εάν πάτε στο αποθετήριο σας στο GitHub, θα δείτε το κουμπί "Σύγκριση και αίτημα ενσωμάτωσης". πατήστε εκεί.
Τώρα υποβάλλετε το αίτημα ενσωμάτωσης.
Σύντομα θα ενσωματώσω όλες τις αλλαγές σας στον κύριο κλάδο αυτού του έργου. Θα λάβετε ένα email ειδοποίησης μόλις οι αλλαγές ενσωματωθούν.
Πού να πάτε από εδώ;
Συγχαρητήρια! Μόλις ολοκληρώσατε την κανονική ροή εργασίας fork -> clone -> edit -> PR που θα συναντήσετε συχνά ως συνεισφέροντες!
Γιορτάστε τη συνεισφορά σας και μοιραστείτε τη με τους φίλους και τους ακόλουθούς σας, πηγαίνοντας στην ιστοσελίδα εφαρμογής.
Μπορείτε να εγγραφείτε στην ομάδα μας στο slack σε περίπτωση που χρειάζεστε βοήθεια ή έχετε ερωτήσεις. Εγγραφείτε στην ομάδα slack.