mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-14 09:06:41 +00:00
145 lines
18 KiB
Markdown
145 lines
18 KiB
Markdown
[](https://github.com/ellerbrock/open-source-badges/)
|
|
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/Readme/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="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/thumb/6/61/Visual_Studio_2017_logo_and_wordmark.svg/2000px-Visual_Studio_2017_logo_and_wordmark.svg.png" width="200">|Έκδοση Visual Studio 2017|
|
|
|---|---|
|
|
|
|
Είναι δύσκολο. Πάντα είναι δύσκολο την πρώτη φορά που κάνεις κάτι. Ειδικά όταν συνεργάζεσαι, οι λάθος δεν είναι κάτι άνετο. Αλλά ο ανοιχτός κώδικας αφορά τη συνεργασία και την εργασία μαζί. Ήθελαν να απλοποιήσουν τον τρόπο με τον οποίο νέοι συνεισφέροντες ανοιχτού κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά.
|
|
|
|
Το να διαβάζεις άρθρα και να παρακολουθείς οδηγούς μπορεί να βοηθήσει, αλλά τίποτα δεν είναι καλύτερο από το να κάνεις πραγματικά τα πράγματα χωρίς να χαλάσεις τίποτα. Αυτό το έργο στοχεύει να παρέχει καθοδήγηση και να απλοποιεί τον τρόπο που οι νέοι συνεισφέροντες κάνουν την πρώτη τους συνεισφορά. Θυμήσου, όσο πιο χαλαρός είσαι, τόσο καλύτερα μαθαίνεις. Αν ψάχνεις να κάνεις την πρώτη σου συνεισφορά, ακολούθησε απλά τα απλά βήματα παρακάτω. Σου υποσχόμαστε, θα είναι διασκεδαστικό.
|
|
|
|
Αν δεν έχετε την Visual Studio 2017 στη μηχανή σας, [εγκαταστήστε την](https://www.visualstudio.com/downloads/).
|
|
|
|
## Κλωνοποίηση του αποθετηρίου
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/fork.png" alt="κλωνοποίηση του αποθετηρίου" />
|
|
|
|
Κλωνοποιήστε αυτό το αποθετήριο κάνοντας κλικ στο κουμπί "fork" στην κορυφή αυτής της σελίδας. Αυτό θα δημιουργήσει ένα αντίγραφο αυτού του αποθετηρίου στο λογαριασμό σας στο GitHub.
|
|
|
|
Το GitHub παρακολουθεί τη σχέση ανάμεσα στο αποθετήριό σας και αυτό από το οποίο το διακλαδώσατε. Μπορείτε να σκεφτείτε το αποθετήριό σας ως μια εργασιακή αντιγραφή.
|
|
|
|
Τα περισσότερα αποθετήρια GitHub επιπέδου κορυφής (δηλαδή εκείνα που δεν διακλαδώθηκαν από κανένα άλλο αποθετήριο) έχουν μια μικρή πυρήνα ομάδα ανθρώπων που μπορούν να κάνουν απευθείας αλλαγές. Οι υπόλοιποι συνεισφέροντες πρέπει να διακλαδώσουν το αποθετήριο και να κάνουν αλλαγές στο διακλάδωμα, και στη συνέχεια να δημιουργήσουν ένα αίτημα τραβήγματος για να ζητήσουν τις αλλαγές τους να ενσωματωθούν πίσω στο αποθετήριο επιπέδου κορυφής. Εάν ο διαχειριστής του αποθετηρίου επιπέδου κορυφής αρέσει τις αλλαγές, θα ενσωματώνονται και θα κερδίσετε άμεση φήμη και πλούτο! Περισσότερα για το πώς να το κάνετε αυτό αργότερα.
|
|
|
|
## Κλωνοποίηση του αποθετηρίου σας
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/clone.png" alt="κλωνοποίηση αυτού του αποθετηρίου" />
|
|
|
|
Ο επόμενος βήμα είναι να κλωνοποιήσετε το αποθετήριο σας στη μηχανή σας ώστε να μπορέσετε να αρχίσετε να κάνετε αλλαγές. Η Visual Studio χρειάζεται το URL του αποθετηρίου σας, οπότε κάντε κλικ στο κουμπί "clone" και στη συνέχεια κάντε κλικ στο εικονίδιο "αντιγραφή στο πρόχειρο".
|
|
|
|
**ΠΡΟΣΟΧΗ:** Ένα σφάλμα που κάνουν συχνά οι νέοι συνεισφέροντες είναι να κλωνοποιούν το αποθετήριο που διακλάδωσαν *από* αντί να κλωνοποιούν το αποθετήριο τους. Ελέγξτε τη γραμμή διεύθυνσης του προγράμματος περιήγησής σας και βεβαιωθείτε ότι κλωνοποιείτε το αποθετήριό σας.
|
|
|
|
Τώρα είναι η στιγμή να μεταβείτε στην Visual Studio 2017! Θα εργαστείτε στην καρτέλα "Ομάδα Εξερεύνησης" για το μεγαλύτερο μέρος αυτού του οδηγού. Εάν δεν είναι ανοικτή από προεπιλογή, κάντε κλικ στο `Προβολή > Ομάδα Εξερεύνησης` για να την ανοίξετε.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-01-clone1.png" alt="Ομάδα Εξερεύνησης" />
|
|
|
|
Η Ομάδα Εξερεύνησης έχει πολλές προβολές και υπάρχουν κουμπιά πλοήγησης στην κορυφή για να σας βοηθήσουν να βρείτε τις διάφορες περιοχές. Για να κλωνοποιήσετε ένα αποθετήριο, πρέπει να βρίσκεστε στην προβολή Σύνδεση, η οποία πρέπει να είναι η προεπιλεγμένη. Εάν δεν βλέπετε το κουμπί "κλώνος", κάντε κλικ στην πράσινη πρίζα στην κορυφή.
|
|
|
|
Κάντε κλικ στην επιλογή "Κλώνος" κάτω από **Τοπικά Αποθετήρια Git** και επικολλήστε το URL του αποθετηρίου σας στο πλαίσιο κειμένου. Αυτό θα πρέπει να είναι το URL που έχετε αντιγράψει στο πρόχειρο από το GitHub προηγουμένως.
|
|
|
|
Κάντε κλικ στο κουμπί "Κλώνος" για να ξεκινήσετε τη διαδικασία.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-02-clone2.png" alt="Κλώνος αποθετηρίου" />
|
|
|
|
Όταν ολοκληρωθεί η διαδικασία, θα μεταφερθείτε στην καρτέλα Εξερεύνησης Λύσης, όπου μπορείτε να δείτε τα περιεχόμενα του αποθετηρίου σας. Το δικό σας θα διαφέρει από τη στιγμιότυπη λήψη παρακάτω επειδή τα πράγματα αλλάζουν!
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-03-clone3.png" alt="Εξερεύνηση Λύσης" />
|
|
|
|
## Δημιουργία κλαδιού
|
|
|
|
Κάντε κλικ πίσω στην καρτέλα Ομάδα Εξερεύνησης και χρησιμοποιήστε το κυρίως αναπτυσσόμενο μενού πλοήγησης για να ανοίξετε την προβολή Κλαδιά.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-04-branch1.png" alt="Προβολή Κλαδιών" />
|
|
|
|
Θα πρέπει να δείτε το αποθετήριο **first-contributions** και το προεπιλεγμένο κλαδί, το οποίο ονομάζεται `master`. Κάντε δεξί κλικ στο `master` και επιλέξτε "Δημιουργία Νέου Τοπικού Κλαδιού Από...".
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-05-branch2.png" alt="Νέο κλαδί" />
|
|
|
|
Δώστε στο κλαδί σας ένα όνομα όπως `add-<όνομα_σας_εδώ>`, για παράδειγμα: `add-alonzo-church`.
|
|
|
|
Αφήστε το πλαίσιο "Έλεγχος κλαδιού" επιλεγμένο και κάντε κλικ στο κουμπί "Δημιουργία Κλαδιού".
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-06-branch3.png" alt="Δημιουργία κλαδιού" />
|
|
|
|
Θα πρέπει να δείτε το νέο κλαδί σας στη λίστα.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-07-branch4.png" alt="Προβολή νέου κλαδιού" />
|
|
|
|
|
|
Here is the translation of the remaining text:
|
|
|
|
## Κάντε τις απαραίτητες αλλαγές
|
|
|
|
Ανοίξτε το αρχείο `Contributors.md` και προσθέστε το όνομά σας στο τέλος της λίστας. Αυτό το αρχείο περιέχει την GFM (GitHub Flavored Markdown), η οποία είναι μια προπριεταριακή παραλλαγή της [σύνταξης Markdown](https://en.wikipedia.org/wiki/Markdown).
|
|
|
|
Αντιγράψτε μία από τις γραμμές άλλων συνεισφερόντων και τροποποιήστε τη με το όνομά σας για να βεβαιωθείτε ότι έχετε σωστή σύνταξη - μπορεί να είναι λεπτομερής.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-08-change1.png" alt="Προσθήκη του ονόματός σας" />
|
|
|
|
## Κάντε commit & αποστείλετε τις αλλαγές στο GitHub
|
|
|
|
Μεταβείτε πίσω στο Team Explorer και πλοηγηθείτε στην προβολή Αλλαγές.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-09-commit1.png" alt="Αλλαγές" />
|
|
|
|
Εισαγάγετε τις πληροφορίες που θέλετε να προσθέσετε με το commit σας και κάντε κλικ στο "Αποθήκευση". Το Visual Studio θα το θυμάται για μελλοντικά commit.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-10-commit2.png" alt="Πληροφορίες χρήστη Git" />
|
|
|
|
**ΣΗΜΕΙΩΣΗ:** Το Visual Studio χρησιμοποιεί έναν κρυφό φάκελο με το όνομα `.vs` για να αποθηκεύει τις προσωπικές σας ρυθμίσεις και προτιμήσεις. Τα περιεχόμενα αυτού του φακέλου **δεν πρέπει να αποθηκευτούν στο Git**. Αν δεν έχει ήδη γίνει αγνόησή του, μπορεί να χρειαστεί να ενημερώσετε το Git να τον αγνοεί, ώστε να μην τον αποστέλλει στο αποθετήριο.
|
|
|
|
Αυτός ο φάκελος έχει ήδη αγνοηθεί σε αυτό το αποθετήριο, οπότε δεν θα χρειαστεί να εκτελέσετε αυτό το βήμα... είναι απλά εδώ για την αναφορά σας για μελλοντικά έργα.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-11-commit3.png" alt="Παράβλεψη του φακέλου .vs" />
|
|
|
|
Τώρα θα πρέπει να δείτε μια λίστα με τα αλλαγμένα αρχεία και ένα πλαίσιο κειμένου για να πληκτρολογήσετε ένα σχόλιο commit. Τα σχόλια πρέπει να είναι σύντομα, αλλά λεπτομερή. Δεν υπάρχει χειρότερο από το να διαβάζετε σχόλια commit και να βλέπετε κάτι τέτοιο: `"Έκανα ανανεώσεις"`. Αφιερώστε λίγα δευτερόλεπτα για να περιγράψετε το commit σας. Η ομάδα σας θα σας ευγνωμονήσει αργότερα, και εσ
|
|
|
|
είς μπορείτε ακόμα και να ευχαριστήσετε τον εαυτό σας!
|
|
|
|
Κάντε κλικ στο "Καταχώρηση όλων και αποστολή" για να πραγματοποιήσετε ένα τοπικό commit και να αποστείλετε τις αλλαγές σας πίσω στο αποθετήριό σας, όλα με ένα βήμα.
|
|
|
|
**ΣΗΜΕΙΩΣΗ:** Το commit μπορεί να γίνει ξεχωριστά από το Push. Εδώ κάνουμε και τα δύο για άνεση. Το commit καταγράφει τις αλλαγές σας τοπικά, αλλά δεν θα αντανακλαστούν στο αποθετήριό σας στο GitHub μέχρι να κάνετε Push.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-12-commit4.png" alt="Καταχώρηση και αποστολή" />
|
|
|
|
Την πρώτη φορά που θα κάνετε Push στο GitHub, το Visual Studio θα ζητήσει τα διαπιστευτήριά σας στο GitHub. Θα αποθηκευτούν στη μνήμη cache, οπότε δεν θα βλέπετε αυτό πολύ συχνά.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-13-commit5.png" alt="Σύνδεση" />
|
|
|
|
Αφού ολοκληρωθεί η λειτουργία Push, ανοίξτε το αποθετήριό σας στο GitHub και θα δείτε ένα μήνυμα που υποδεικνύει μια πρόσφατα απεσταλμένη κλαδί.
|
|
|
|
Μπορείτε να δείτε τις αλλαγές σας ανοίγοντας το αναπτυσσόμενο μενού "Branch: master" και επιλέγοντας το νέο σας κλαδί. Συγχαρητήρια, μπορείτε να μοιραστείτε το URL του κλαδιού με τον κόσμο για να δείξετε την πρόοδό σας!
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/vs2017-14-commit6.png" alt="Προβολή απεσταλμένου κλαδιού στο GitHub" />
|
|
|
|
## Υποβάλλετε τις αλλαγές σας για αναθεώρηση
|
|
|
|
Σε αυτό το σημείο, έχετε ολοκληρώσει την αλλαγή σας, αλλά εξακολουθεί να βρίσκεται μόνο στο αποθετήριό σας. Αυτό το βήμα θα σας δείξει πώς να υποβάλετε αίτημα προς τον διαχειριστή του ανώτατου επιπέδου αποθετηρίου για να ενσωματώσετε την αλλαγή σας.
|
|
|
|
Στο αποθετήριό σας στο GitHub, θα δείτε το κουμπί "Σύγκριση & αίτηση ενσωμάτωσης" δίπλα στην ειδοποίηση του νέου κλαδιού. Κάντε κλικ σε αυτό το κουμπί.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/compare-and-pull.png" alt="Δημιουργία αίτησης ενσωμάτωσης" />
|
|
|
|
Τώρα υποβάλετε το αίτημα ενσωμάτωσης.
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs2017-tutorial/submit-pull-request.png" alt="Υποβολή αίτησης ενσωμάτωσης" />
|
|
|
|
Σύντομα θα συνοψίσω όλες τις αλλαγές σας στον κ
|
|
|
|
ύριο κλαδί αυτού του έργου. Θα λάβετε ένα 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#tutorials-using-other-tools) |