Τα σήματα GitHub μπορούν να ενισχύσουν την αναγνωσιμότητα ενός αποθετηρίου παρέχοντας στους χρήστες έναν γρήγορο τρόπο για να καταγράψουν τις μετρήσεις του αποθετηρίου. Τα σήματα μπορούν να ενσωματωθούν στο README.md σας για να αποσαφηνίσετε τη σημασία και την αναγκαιότητα του έργου σας σε άλλους προγραμματιστές. Ως αποτέλεσμα, οι αναγνώστες παίρνουν μια πολύ γρήγορη ιδέα του αποθετηρίου ελέγχοντας τα συνημμένα σήματα.
Υπάρχουν πολλά σήματα GitHub διαθέσιμα στο Διαδίκτυο, εδώ είναι τα πέντε πιο ενημερωτικά σήματα που πρέπει να συμπεριλάβετε στο αρχείο README.md. Για κάθε σήμα που αναφέρεται, παρέχεται ο αντίστοιχος κωδικός Markdown.
Τι μπορούν να κάνουν τα σήματα GitHub για εσάς;
Η προσθήκη σημάτων GitHub στο αποθετήριο σας μπορεί να φαίνεται ασήμαντη, αλλά στην πραγματικότητα είναι απίστευτα χρήσιμη. Το μόνο που χρειάζεται να κάνετε είναι να εισαγάγετε τον κωδικό Markdown από την πηγή στο αρχείο README.md.
Όταν δημιούργησα το αποθετήριο GitHub προγραμματισμού Python, παρέλειψα τα σήματα. Το ασυναγώνιστο αποθετήριό μου είχε τα σωστά περιεχόμενα αλλά δεν ξεχώρισε. Εξαιτίας αυτού, το αποθετήριο κέρδισε πολύ λίγη κίνηση (μοναδικοί επισκέπτες).
Σχετιζομαι με: Πώς να δημιουργήσετε ένα αποθετήριο GitHub
Θέλετε να μοιραστείτε τα αναπτυξιακά σας έργα στο διαδίκτυο; Δείτε πώς μπορείτε να ξεκινήσετε με το πρώτο σας αποθετήριο Github.
Μετά την προσθήκη περισσότερων σημάτων στο αποθετήριο μου, είδα μια αυτόματη αύξηση των εξωτερικών επισκεπτών (από 5 σε 767) μηνιαίως (δείτε τους μοναδικούς επισκέπτες σας στο Πληροφορίες> Επισκεψιμότητα στο αποθετήριο σας.)
Τα Εισερχόμενά μου ήταν γεμάτα με σχόλια σχετικά με το πόσο καλά ξεχώριζε το αποθετήριο μου από άλλα αποθετήρια προγραμματισμού Python λόγω των σημάτων. Ένα απλό σήμα GitHub μπορεί να αλλάξει εντελώς την εμφάνιση του αποθετηρίου σας.
Να έχετε πάντα αυτό υπόψη: ένα σήμα αξίζει 1000 γραμμές κώδικα.
Το σήμα GitHub Stats δείχνει τα συνολικά αστέρια, δεσμεύσεις, αιτήματα τραβήγματος, ζητήματα και συνεισφορές του αποθετηρίου σας GitHub.
- Αστέρια: Οι χρήστες αποθηκεύουν αποθετήρια GitHub (όπως σελιδοδείκτες). Αυτό δείχνει ότι ο χρήστης ενδιαφέρεται και επιθυμεί να παραμείνει ενημερωμένος με το αποθηκευμένο αποθετήριο. Ωστόσο, δεν είναι δυνατή η επεξεργασία ενός αποθετηρίου με αστέρι.
- Δεσμεύει: Η αποθήκευση μιας αλλαγής σε ένα αποθετήριο αναφέρεται ως Commit. Διάφορες λεπτομέρειες επισυνάπτονται σε μια δέσμευση, περιεχόμενο, μήνυμα (περιγραφή), όνομα συγγραφέα και χρονική σήμανση.
- Τραβήξτε το αίτημα: Ένα αίτημα τραβήγματος ενημερώνει τους άλλους για βελτιώσεις που προωθήσατε σε διαφορετικό αποθετήριο GitHub, εκτός από το δικό σας. Συχνά αναφέρεται στο Pull Request ως η καρδιά της Συνεργασίας GitHub.
- Θέματα: Τα ζητήματα GitHub χρησιμοποιούνται για τη λήψη σχολίων από τους χρήστες, τις ιδέες παρακολούθησης, τις βελτιώσεις και τη λίστα σφαλμάτων που αναφέρονται στο αποθετήριο.
- Συνεισφορά: Οι συνεισφορές GitHub υποδεικνύουν τον αριθμό των συνεισφορών που έχουν γίνει σε άλλα αποθετήρια. Μια συνεισφορά μπορεί να γίνει με τη βοήθεια ενός Pull Request.
Για να προσθέσετε το σήμα GitHub Stats στο αποθετήριό σας, ενσωματώστε τον παρακάτω κωδικό Markdown στο αρχείο README.md.
! [Στατιστικά του αποθετηρίου σας] ( https://github-readme-stats.vercel.app/api? όνομα χρήστη = Your_GitHub_Username & show_icons = true)
Βεβαιωθείτε ότι έχετε αλλάξει το όνομα χρήστη = τιμή στο όνομα χρήστη του GitHub. Το σήμα GitHub Stats παρέχει επίσης κατατάξεις όπως S + (top 1%), S (top 25%), A ++ (top 45%), A + (top 60%) και B + (όλοι). Όσο υψηλότερα είναι τα στατιστικά σας, τόσο καλύτερη είναι η κατάταξή σας.
Όπως υποδηλώνει το όνομα, το σήμα Γλώσσες που χρησιμοποιούνται περισσότερο εμφανίζει τις πιο κοινές γλώσσες που χρησιμοποιούνται σε ολόκληρο το GitHub. Πρόκειται για μια μέτρηση GitHub με τις οποίες γλώσσες όπως HTML, CSS, JavaScript, Python, Go, και περισσότεροι έχουν τον μεγαλύτερο κώδικα στο GitHub. Οι γλώσσες παρατίθενται σε φθίνουσα σειρά.
Σχετιζομαι με: Ποια γλώσσα προγραμματισμού πρέπει να μάθετε;
Για να προσθέσετε το σήμα "Γλώσσες που χρησιμοποιούνται περισσότερο" στο αποθετήριο σας, ενσωματώστε την παρακάτω υπογραφή στο αρχείο README.md.
! [Στατιστικά του αποθετηρίου σας] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Your_GitHub_Username&theme=blue-green)
Το μόνο μειονέκτημα αυτού του σήματος είναι ότι δεν θα καταγράψει τη Σημείωση ως τη γλώσσα που χρησιμοποιείται πιο συχνά.
Το σήμα Contributors εμφανίζει όλες τις λειτουργίες όπως προσθήκες, διαγραφές, και διαπράττει που έχουν πραγματοποιηθεί στα αποθετήρια σας. Όταν συγχωνεύσετε ένα αίτημα έλξης στο αποθετήριο σας, το άτομο που δημιούργησε το αίτημα θα προστεθεί ως συνεισφέρων. Είναι πραγματικά καλή συνήθεια να πιστώνετε τους συνεισφέροντες που έχουν επενδύσει το χρόνο τους για την παροχή ενημέρωσης στο αποθετήριο σας.
Το σήμα Contributors μπορεί να δημιουργηθεί χρησιμοποιώντας το contributors-img, μια εφαρμογή ιστού που δημιουργεί μια εικόνα για την εμφάνιση της λίστας των συνεισφερόντων.
Η δημιουργία της εικόνας του συνεργάτη είναι πολύ ασήμαντη. Μεταβείτε στον ιστότοπο των συνεργατών-img και επικολλήστε το όνομα του αποθετηρίου σας μαζί με το δικό σας όνομα χρήστη για να δημιουργήσετε τη διεύθυνση URL. Εναλλακτικά, απλώς ενσωματώστε τον κωδικό Markdown που δίνεται παρακάτω για να λάβετε την εικόνα.
! [Εικόνα συντελεστών GitHub] ( https://contrib.rocks/image? repo = Your_GitHub_Username / Your_GitHub_Repository_Name)
Η γεννήτρια τυχαίων αστείων θα δημιουργήσει ένα τεχνικό αστείο με τη μορφή ερωτήσεων και απαντήσεων. Για παράδειγμα, "Τι είναι ο ιός του υπολογιστή; Η τελική ασθένεια”.
Για να χρησιμοποιήσετε το σήμα πρέπει να ενσωματώσετε τον κωδικό Markdown στο αρχείο README.md όπως φαίνεται παρακάτω.
## 😂 Εδώ είναι ένα τυχαίο αστείο που θα σας κάνει να γελάσετε!
! [Κάρτα αστείων] ( https://readme-jokes.vercel.app/api)
Το σήμα Μετρητής προβολής προφίλ εμφανίζει πόσες φορές έχει προβληθεί το προφίλ σας στο GitHub στο προφίλ σας. Για να δημιουργήσετε αυτό το σήμα, ενσωματώστε τον ακόλουθο κωδικό Markdown:
! [Μετρητής προβολής προφίλ] ( https://komarev.com/ghpvc/?username=Your_GitHub_Username)
Για να δημιουργήσετε τον αριθμό προβολών του αποθετηρίου σας, ίσως θελήσετε να χρησιμοποιήσετε το HITS (Πώς οι Ηλίθιοι παρακολουθούν την επιτυχία) σήμα. Είναι ένας απλός τρόπος για να δείτε πόσα άτομα έχουν επισκεφτεί τη δική σας GitHub αποθήκη:
! [Χτυπήματα] ( https://hitcounter.pythonanywhere.com/count/tag.svg? url = Επικόλληση_Το_GitHub_Repository_Link_Here)
Αλλά το μειονέκτημα τόσο του μετρητή προβολής προφίλ όσο και του HITS είναι ότι δεν εμφανίζουν τον αριθμό των προβολών με μοναδικά αναγνωριστικά. Κάθε φορά που επαναφορτώνετε το πρόγραμμα περιήγησης / αποθετήριο, οι μετρήσεις θα αυξάνονται. Κάποιος θα μπορούσε εύκολα να πάρει περισσότερες προβολές ανανεώνοντας τη σελίδα.
Πλήρης εφαρμογή των σημάτων GitHub
Έχω χρησιμοποιήσει το αποθετήριο GitHub ως παράδειγμα. Για να δημιουργήσετε τα σήματα, συνιστάται να προσθέσετε αυτούς τους κωδικούς στο καθορισμένο αρχείο README.md. Εάν δεν έχετε αρχείο README.md στο αποθετήριο GitHub, τότε η μη αυτόματη δημιουργία ενός είναι η καλύτερη επιλογή.
# Κορυφαία 5 σήματα που θα μεταφέρουν το αποθετήριο GitHub στο επόμενο επίπεδο
## 1. Στατιστικά GitHub
! [Στατιστικά του αποθετηρίου σας] ( https://github-readme-stats.vercel.app/api? όνομα χρήστη = Tanu-N-Prabhu & show_icons = true)
## 2. Οι περισσότερες χρησιμοποιούμενες γλώσσες
! [Στατιστικά του αποθετηρίου σας] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Tanu-N-Prabhu&theme=blue-green)
## 3. Σήμα συνεργατών
! [Στατιστικά του αποθετηρίου σας] ( https://contrib.rocks/image? repo = Tanu-N-Prabhu / Python)
## 4. Γεννήτρια τυχαίων αστείων
! [Κάρτα αστείων] ( https://readme-jokes.vercel.app/api)
## 5. Μετρητής προβολής προφίλ
! [Μετρητής προβολής προφίλ] ( https://komarev.com/ghpvc/?username=Tanu-N-Prabhu)
### Μετρητής προβολής αποθετηρίου - HITS
! [Χτυπήματα] ( https://hitcounter.pythonanywhere.com/count/tag.svg? url = https://github.com/Tanu-N-Prabhu/Python)
Δεν χρειάζεται να εκτελέσετε ή να εκτελέσετε το παραπάνω απόσπασμα κώδικα καταγραφής στο αρχείο README.md. Τη στιγμή που θα αποθηκεύσετε το αρχείο με επέκταση (.md), το GitHub θα αποδώσει αυτόματα την έξοδο και οι αλλαγές θα αντικατοπτρίζονται απευθείας στο αποθετήριο σας.
Διατίθενται περισσότερα σήματα GitHub
Τώρα που γνωρίζετε πώς να προσθέσετε τα σήματα GitHub στο αποθετήριο σας, είναι μια εξαιρετική επιλογή για προγραμματιστές και άτομα που μπορούν να χρησιμοποιήσουν αυτά τα σήματα για να αυξήσουν την αναγνωσιμότητα των αποθετηρίων τους. Δεν είναι τόσο δύσκολο - το μόνο που χρειάζεται να κάνετε είναι να ενσωματώσετε μερικές γραμμές κώδικα Markdown για να δημιουργήσετε τα σήματα.
Όσο περισσότερα σήματα συμπεριλαμβάνετε στο αποθετήριο σας, τόσο περισσότερη προσοχή θα λάβετε. Ένα μεμονωμένο σήμα θα έχει τη δυνατότητα να παρέχει χρήσιμες πληροφορίες όσον αφορά τα στατιστικά στοιχεία, την κατάσταση και τις μετρήσεις.
Θέλετε να αντιμετωπίσετε το λογισμικό στο GitHub; Δείτε πώς μπορείτε να το κάνετε ανατολικά με το βελτιωμένο εργαλείο GitHub Desktop.
- Προγραμματισμός
- Χαμήλωση τιμής
- GitHub
Εγγραφείτε στο Newsletter μας
Εγγραφείτε στο ενημερωτικό δελτίο μας για τεχνικές συμβουλές, κριτικές, δωρεάν ebook και αποκλειστικές προσφορές!
Ένα ακόμη βήμα…!
Επιβεβαιώστε τη διεύθυνση email σας στο email που μόλις σας στείλαμε.