Viisi parasta merkkiä, jotka vievät GitHub-arkiston uudelle tasolle

GitHub-tunnukset voivat parantaa arkiston luettavuutta tarjoamalla käyttäjille nopean tavan siepata arkiston mittareita. Merkit voidaan upottaa README.md-tiedostoon selventämään projektisi tärkeyttä ja välttämättömyyttä muille kehittäjille. Tämän seurauksena lukijat saavat todella nopean kuvan arkistosta tarkistamalla liitteenä olevat merkit.

Internetissä on monia GitHub-merkkejä, tässä on viisi tärkeintä informatiivista merkkiä, jotka sisällytetään README.md-tiedostoon. Jokaisesta luettelomerkistä annetaan vastaava Markdown-koodi.

Mitä GitHub-merkit voivat tehdä sinulle?

GitHub-merkkien lisääminen arkistoon saattaa tuntua triviaalilta, mutta itse asiassa se on uskomattoman hyödyllistä. Sinun tarvitsee vain tuoda Markdown-koodi lähteestä README.md-tiedostoon.

Kun loin Python Programming GitHub -tietovarastoni, jätin merkit pois. Koristamattomalla arkistollani oli oikea sisältö, mutta se ei eronnut. Tämän vuoksi arkisto sai vain vähän liikennettä (yksilöllisiä kävijöitä).

Liittyvät: Kuinka luoda GitHub-arkisto

Kuinka luoda ensimmäinen arkisto Githubiin

Haluatko jakaa kehityshankkeesi verkossa? Näin pääset alkuun ensimmäisen Github-arkiston kanssa.

Lisättyään lisää merkkejä arkistooni, huomasin ulkoisten kävijöiden automaattisen nousun (5: stä 767: een) kuukausittain (tarkastele ainutlaatuisia kävijöitäsi Tilastot> Liikenne arkistossasi.)

Postilaatikkoni oli täynnä kommentteja siitä, kuinka hyvin tietovarastoni erottui muista Python-ohjelmointivarastoista merkkien vuoksi. Yksinkertainen GitHub-merkki voi muuttaa täysin arkiston ulkoasua.

Pidä tämä aina mielessä: rintanappi on 1000 koodirivin arvoinen.

GitHub Stats -merkki osoittaa tähtien, sitoutumisten, vetopyyntöjen, ongelmien ja lahjoitusten kokonaismäärän GitHub-arkistossasi.

1. Tähdet: Käyttäjät tallentavat GitHub-arkistoja (kuten kirjanmerkkejä). Tämä osoittaa, että käyttäjä on kiinnostunut ja haluaa pysyä ajan tasalla tallennetusta arkistosta. Tähdellä merkittyä arkistoa ei kuitenkaan voi muokata.
2. Sitoutuu: Muutoksen tallentamista arkistoon kutsutaan sitoutumiseksi. Sitoumukseen liitetään erilaisia ​​yksityiskohtia, sisältö, viesti (kuvaus), tekijän nimi ja aikaleima.
3. Vedä pyyntö: Pull Request ilmoittaa muille parannuksista, jotka olet siirtänyt toiseen GitHub-arkistoon, paitsi sinun. Viittaamme usein vetopyyntöön GitHub-yhteistyön sydämenä.
4. Kysymykset: GitHub-aiheita käytetään käyttäjien palautteen saamiseen, ideoiden seuraamiseen, parannuksiin ja luetteloon arkistoihin ilmoitetuista virheistä.
5. Osallistuminen: GitHub-julkaisut osoittavat muille arkistoille tehtyjen vastausten määrän. Lahjoitus voidaan tehdä vetopyynnön avulla.

Lisää GitHub Stats -merkki arkistoon upottamalla alla oleva Markdown-koodi README.md-tiedostoon.

! [Tietovarastosi tilastot] ( https://github-readme-stats.vercel.app/api? käyttäjänimi = Your_GitHub_Username & show_icons = true)

Varmista, että vaihdat käyttäjänimi = arvo GitHub-käyttäjänimellesi. GitHub Stats -merkki tarjoaa myös rivejä kuten S + (ylin 1%), S (ylin 25%), A ++ (ylin 45%), A + (ylin 60%) ja B + (kaikki). Mitä korkeampi tilastosi, sitä parempi sijoituksesi.

Kuten nimestä voi päätellä, Käytetyimmät kielet -merkki näyttää yleisimmät kielet, joita käytetään koko GitHubissa. Se on GitHub-metriikka kielistä, kuten HTML, CSS, JavaScript, Python, Go, ja muilla on eniten koodia GitHubissa. Kielet on lueteltu laskevassa järjestyksessä.

Liittyvät: Mikä ohjelmointikieli sinun pitäisi oppia?

Voit lisätä Käytetyimmät kielet -merkin arkistoon upottamalla alla olevan merkinnän README.md-tiedostoon.

! [Tietovarastosi tilastot] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Your_GitHub_Username&theme=blue-green)

Tämän merkin ainoa haittapuoli on, että siinä ei mainita Markdownia yleisimmin käytettynä kielenä.

Contributors Badge näyttää kaikki toiminnot, kuten lisäykset, poistotja sitoutuu jotka on tehty arkistoillesi. Kun yhdistät vetopyynnön arkistoon, pyynnön luonut henkilö lisätään avustajana. On todella hyvä tapa hyvittää avustajia, jotka ovat käyttäneet aikansa päivityksen tarjoamiseen arkistoon.

Contributors-merkki voidaan luoda käyttämällä Contributor-img-verkkosovellusta, joka luo kuvan avustajien luettelon näyttämiseen.

Avustajan kuvan luominen on melko triviaalia. Siirry avustajien-img-verkkosivustolle ja liitä arkiston nimi yhdessä sinun käyttäjänimi luoda URL-osoite. Vaihtoehtoisesti upota alla oleva Markdown-koodi saadaksesi kuvan.

! [GitHub-avustajien kuva] ( https://contrib.rocks/image? repo = Sinun_GitHub_Username / Sinun_GitHub_Repository_Name)

Satunnainen vitsigeneraattori tuottaa teknisen vitsin kysymysten ja vastausten muodossa. Esimerkiksi, "Mikä on tietokonevirus? Terminaalitauti”.

Tunnuksen käyttämiseksi sinun on upotettava Markdown-koodi README.md-tiedostoon alla olevan kuvan mukaisesti.

## 😂 Tässä on satunnainen vitsi, joka saa sinut nauramaan!
! [Vitsikortti] ( https://readme-jokes.vercel.app/api)

Profiilinäkymän laskuri -merkki näyttää, kuinka monta kertaa GitHub-profiiliasi on katsottu profiilissasi. Voit luoda tämän tunnuksen upottamalla seuraavan Markdown-koodin:

! [Profiilinäkymä laskuri] ( https://komarev.com/ghpvc/?username=Your_GitHub_Username)

Voit luoda tietovarastosi näyttökertojen määrän HITS (Kuinka idiootit seuraavat menestystä) merkki. Se on yksinkertainen tapa nähdä, kuinka moni ihminen on käynyt sivustollasi GitHub arkisto:

! [Osumat] ( https://hitcounter.pythonanywhere.com/count/tag.svg? url = Liitä_Oma_GitHub_Repository_Link_Tätä)

Mutta sekä profiilinäkymälaskurin että HITSin haittana on, että ne eivät näytä yksilöivillä tunnuksilla varustettujen näyttökertojen määrää. Aina kun lataat selaimen / arkiston uudelleen, lukumäärää lisätään. Voit helposti saada enemmän katselukertoja päivittämällä sivun.

GitHub-merkkien täydellinen toteutus

Olen käyttänyt GitHub-arkistoni esimerkkinä. Tunnusten luomiseksi on suositeltavaa lisätä nämä koodit määritettyyn README.md-tiedostoon. Jos sinulla ei ole README.md-tiedostoa GitHub-arkistossa, sen luominen manuaalisesti on paras vaihtoehto.

# 5 parasta merkkiä, jotka vievät GitHub-arkiston uudelle tasolle
## 1. GitHub-tilastot
! [Tietovarastosi tilastot] ( https://github-readme-stats.vercel.app/api? käyttäjänimi = Tanu-N-Prabhu & show_icons = tosi)
## 2. Eniten käytetyt kielet
! [Tietovarastosi tilastot] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Tanu-N-Prabhu&theme=blue-green)
## 3. Avustajien rintanappi
! [Tietovarastosi tilastot] ( https://contrib.rocks/image? repo = Tanu-N-Prabhu / Python)
## 4. Satunnainen vitsigeneraattori
! [Vitsikortti] ( https://readme-jokes.vercel.app/api)
## 5. Profiilinäkymä laskuri
! [Profiilinäkymä laskuri] ( https://komarev.com/ghpvc/?username=Tanu-N-Prabhu)
### Repository View Counter - HITS
! [Osumat] ( https://hitcounter.pythonanywhere.com/count/tag.svg? URL = https://github.com/Tanu-N-Prabhu/Python)

Edellä olevaa merkintäkoodinpätkää ei tarvitse suorittaa tai suorittaa README.md-tiedostossasi. Heti kun tallennat tiedoston (.md) -laajennuksella, GitHub renderöi tuloksen automaattisesti ja muutokset heijastuvat suoraan arkistoon.

Lisää GitHub-merkkejä saatavana

Nyt kun tiedät kuinka lisätä GitHub-merkit arkistoon, se on loistava vaihtoehto kehittäjille ja yksityishenkilöille, jotka voivat käyttää näitä merkkejä parantamaan arkistojensa luettavuutta. Se ei ole niin vaikeaa - sinun tarvitsee vain upottaa muutama Markdown-koodirivi tunnusten luomiseksi.

Mitä enemmän merkkejä sisällytät arkistoon, sitä enemmän huomiota saat. Yksi merkki voi tuottaa hyödyllistä tietoa tilastoista, tilasta ja mittareista.

Tietovaraston kloonaus GitHub Desktopin avulla

Haluatko tutustua GitHubin ohjelmistoihin? Näin pääset itään virtaviivaisella GitHub Desktop -työkalulla.

Kirjailijasta