Βρήκατε ποτέ ένα πακέτο στο GitHub που σας άρεσε, αλλά θέλατε να προσθέσετε μια γρήγορη λειτουργία, να διορθώσετε ένα σφάλμα που βρήκατε ή ίσως απλώς να συνεισφέρετε στο open source στο σύνολό του; Συμμετάσχετε στην τάση της κοινωνικής κωδικοποίησης, μοιραστείτε τις δεξιότητές σας και βοηθήστε να ωφεληθείτε τον κόσμο ανοιχτού κώδικα. Σε αυτό το άρθρο, μάθετε όλα σχετικά με τον τρόπο συνεισφοράς κώδικα σε ένα αποθετήριο στο GitHub ή σε οποιαδήποτε φιλοξενούμενη υπηρεσία git.
Λάβετε Ρύθμιση
Αυτό το άρθρο προϋποθέτει ότι έχετε ήδη λογαριασμό GitHub, αλλά αν όχι, παρακαλώ γρήγορα Εγγραφείτε για ένα δωρεάν λογαριασμό. Επίσης, βεβαιωθείτε ότι έχετε ήδη σκατά εγκατασταθεί εκτελώντας την ακόλουθη εντολή στο τερματικό:
git - μετατροπήΕάν αντί να δείτε τον αριθμό έκδοσης, λαμβάνετε ένα μήνυμα "εντολή δεν βρέθηκε", μπορείτε να το εγκαταστήσετε σκατά με την εντολή:
sudo apt-get -y εγκατάσταση gitΠιέστε το αποθετήριο
Πρώτα πρέπει να επιλέξετε το αποθετήριο στο οποίο θέλετε να συνεισφέρετε και να το επισκεφθείτε στο πρόγραμμα περιήγησής σας. Εάν δεν είστε σίγουροι για το αποθετήριο που θα επιλέξετε, μπορείτε να χρησιμοποιήσετε το αποθετήριο επίδειξης που βρίσκεται στη διεύθυνση
https://github.com/mdizak/muo_demo. Αυτή είναι μια απλή επίδειξη και μπορείτε να δημιουργήσετε αιτήματα έλξης εναντίον της για δοκιμές και μαθησιακούς σκοπούς.Κατά την προβολή του αποθετηρίου στο πρόγραμμα περιήγησης ιστού σας, αναζητήστε το Αποθήκη Fork κουμπί και κάντε κλικ σε αυτό. Αυτό θα διαγράψει το αποθετήριο στον δικό σας λογαριασμό GitHub και θα σας φέρει σε αυτό. Στη συνέχεια πρέπει να κλωνοποιήστε το πρόσφατα διχασμένο αποθετήριο, ανοίξτε το τερματικό στον τοπικό υπολογιστή σας και εκτελέστε:
Θέλετε να αντιμετωπίσετε το λογισμικό στο GitHub; Δείτε πώς μπορείτε να το κάνετε ανατολικά με το βελτιωμένο εργαλείο GitHub Desktop.
git κλώνος https://github.com/myusername/muo_demo.git
cd muo_demoΦυσικά, βεβαιωθείτε ότι αλλάζετε την παραπάνω διεύθυνση URL σε αυτήν του πρόσφατα διαμορφωμένου αποθετηρίου σας. Μόλις κλωνοποιηθεί, προσθέστε το αρχικό αποθετήριο ως ανάντη με την εντολή:
git remote add ανάντη https://github.com/mdizak/muo_demo.gitΒεβαιωθείτε ότι έχετε αλλάξει τη διεύθυνση URL στην παραπάνω εντολή με αυτήν του αρχικού αποθετηρίου που κλωνοποιήσατε. Αυτό δηλώνει ότι είναι ένα γονικό αποθετήριο από το οποίο εργάζεστε.
Προετοιμασία τοπικού αποθετηρίου
Κάθε φορά πριν αρχίσετε να εργάζεστε σε μια νέα συνεισφορά, βεβαιωθείτε ότι χρησιμοποιείτε την τελευταία βάση κώδικα του γονικού αποθετηρίου. Εντός του καταλόγου έργου, εκτελέστε τις ακόλουθες εντολές στο τερματικό:
git checkout master
git pull upstream master && git push origin masterΗ πρώτη εντολή διασφαλίζει ότι εργάζεστε αυτήν τη στιγμή στον κύριο κλάδο και η δεύτερη εντολή συγχρονίζει το γονικό αποθετήριο με τα τοπικά αποθετήρια και τα αποθετήρια GitHub. Αυτό διασφαλίζει ότι τροποποιείτε την πιο ενημερωμένη βάση κώδικα και δεν εργάζεστε με ξεπερασμένο κώδικα.
Επίσης, βεβαιωθείτε ότι έχετε ελέγξει αν το έργο διαθέτει αρχείο cont.m.m και αν ναι, βεβαιωθείτε ότι ακολουθείτε ό, τι λέει. Μερικές φορές τα έργα έχουν συγκεκριμένες οδηγίες σχετικά με τον τρόπο παροχής συνεισφορών, οι οποίες πρέπει πάντα να τηρούνται.
Δημιουργήστε ένα νέο υποκατάστημα
Πρέπει να δημιουργήσετε ένα νέο υποκατάστημα που θα περιέχει όλες τις τροποποιήσεις για αυτήν τη συνεισφορά, η οποία αργότερα θα συγχωνευτεί στο κύριο αποθετήριο GitHub από τους συντηρητές του έργου. Ο κλάδος πρέπει να είναι αλφαριθμητικός και μπορεί να ονομάζεται οτιδήποτε θέλετε.
Αν και δεν απαιτείται, γενικά θεωρείται κοινή ευγένεια με το πρόθεμα του ονόματος κλάδου με επείγουσα επιδιόρθωση / για γρήγορες διορθώσεις σφαλμάτων ή χαρακτηριστικό/ για πρόσθετα χαρακτηριστικά. Επιλέξτε το όνομα κλάδου που θέλετε και εκτελέστε την εντολή:
git checkout -b χαρακτηριστικό / my_cool_featureΠρέπει πάντα να δημιουργείτε έναν ξεχωριστό κλάδο για κάθε δυνατότητα / διόρθωση σφαλμάτων και να μην συμπεριλαμβάνετε ποτέ πολλές συνεισφορές σε μία. Αυτό βοηθά στη διατήρηση μιας ομαλής ροής ανάπτυξης και επίσης διασφαλίζει ότι η συνεισφορά σας είναι αποδεκτή και περιλαμβάνεται στο έργο.
Τώρα που έχει δημιουργηθεί το υποκατάστημα σας, προχωρήστε και ολοκληρώστε τις απαραίτητες τροποποιήσεις που θέλετε με την τυπική ροή εργασίας git.
Δέσμευση και δημιουργία αιτήματος τραβήγματος
Μόλις ολοκληρώσετε τις εργασίες για τη συνεισφορά σας, δεσμεύστε την με ένα κατάλληλο μήνυμα δέσμευσης και σπρώξτε το στο διχαλωτό αποθετήριό σας με τις εντολές:
git commit - αρχείο commit.txt
git push -u origin feature / my_cool_featureΤο τελευταίο βήμα είναι να δημιουργήσετε μια αίτηση έλξης που θα ειδοποιεί τους συντηρητές του έργου ότι εκκρεμεί μια νέα συνεισφορά. Επισκεφτείτε το διχαλωτό αποθετήριο GitHub στο πρόγραμμα περιήγησης ιστού και θα δείτε ένα αναπτυσσόμενο κουμπί που σας επιτρέπει να αλλάξετε κλάδους. Αλλαγή στον πρόσφατα δημιουργημένο κλάδο σας και η επόμενη σελίδα θα περιέχει έναν σύνδεσμο που σας επιτρέπει να δημιουργήσετε ένα νέο αίτημα τραβήγματος.
Κάνοντας κλικ σε αυτόν τον σύνδεσμο, θα δείτε μια σελίδα που εμφανίζει το μήνυμα δέσμευσης και όλες τις αλλαγές που έχετε πραγματοποιήσει στον κώδικα. Ελέγξτε τα πάντα για να βεβαιωθείτε ότι είναι σωστά, προσθέστε οποιοδήποτε απαραίτητο πρόσθετο μήνυμα για τους συντηρητές και υποβάλετε το αίτημα τραβήγματος.
Συνεχίστε να συνεισφέρετε στο GitHub
Συγχαρητήρια, υποβάλατε με επιτυχία μια συνεισφορά σε ένα έργο GitHub!
Το αίτημα τραβήγματος σας περιμένει τώρα έλεγχο και έγκριση από τους υπεύθυνους του έργου και θα ειδοποιηθείτε μέσω e-mail εάν έχει εγκριθεί ή όχι και με τυχόν μηνύματα που έχουν για εσάς. Τώρα που έχετε μάθει πώς να συνεισφέρετε σε έργα στο GitHub, συνεχίζετε να προχωράτε και συμβάλλετε στην ανάπτυξη του κοινότητα ανοιχτού κώδικα.
Εάν το τηλέφωνο ή το tablet Android σας λειτουργεί λίγο αργά, μπορεί να χρειαστεί λίγο περισσότερη μνήμη RAM. Μπορούμε να σας βοηθήσουμε με αυτό.
- Προγραμματισμός
- GitHub
Εγγραφείτε στο Newsletter μας
Εγγραφείτε στο ενημερωτικό δελτίο μας για τεχνικές συμβουλές, κριτικές, δωρεάν ebook και αποκλειστικές προσφορές!
Ένα ακόμη βήμα…!
Επιβεβαιώστε τη διεύθυνση email σας στο email που μόλις σας στείλαμε.