„GitHub“ ženkleliai gali pagerinti saugyklos įskaitomumą teikdami vartotojams greitą būdą užfiksuoti saugyklos metriką. Ženklelius galima įterpti į jūsų README.md, kad kiti kūrėjai galėtų paaiškinti jūsų projekto svarbą ir būtinybę. Todėl skaitytojai patikrina pridedamus ženklelius iš tiesų greitai suprasdami saugyklą.

Yra daug „GitHub“ ženklelių, kuriuos galima rasti internete, pateikiame penkis svarbiausius informacinius ženklelius, kuriuos norite įtraukti į savo failą README.md. Kiekvienam nurodytam ženklui pateikiamas lygiavertis „Markdown“ kodas.

Ką „GitHub“ ženkleliai gali padaryti jums?

GitHub ženklelių pridėjimas prie saugyklos gali atrodyti nereikšmingas, bet iš tikrųjų tai nepaprastai naudinga. Viskas, ką jums reikia padaryti, tai importuoti „Markdown“ kodą iš šaltinio į failą README.md.

Kai sukūriau „Python Programming GitHub“ saugyklą, praleidau ženklelius. Mano nepagražinta saugykla turėjo tinkamą turinį, tačiau neišsiskyrė. Dėl to saugykla sulaukė labai nedaug lankytojų (unikalių lankytojų).

instagram viewer

Susijęs: Kaip sukurti „GitHub“ saugyklą

Kaip sukurti savo pirmąją saugyklą „Github“

Norite pasidalinti savo plėtros projektais internete? Štai kaip pradėti naudoti savo pirmąją „Github“ saugyklą.

Į savo saugyklą pridėjęs daugiau ženklelių, pamačiau, kad kas mėnesį automatiškai padidėja išoriniai lankytojai (nuo 5 iki 767) (peržiūrėkite savo unikalius lankytojus Įžvalgos> Eismas jūsų saugykloje.)

Mano pašto dėžutė buvo užpildyta komentarais, kaip mano saugykla išsiskyrė iš kitų „Python“ programavimo talpyklų dėl ženklelių. Paprastas „GitHub“ ženklelis gali visiškai pakeisti saugyklos išvaizdą.

Visada turėkite tai omenyje: ženklelis vertas 1000 eilučių kodo.

„GitHub Stats“ ženklelis rodo bendrą „GitHub“ saugyklos žvaigždžių, įsipareigojimų, prašymų pateikti, prašymų ir įnašų skaičių.

  1. Žvaigždės: Vartotojai išsaugo „GitHub“ saugyklas (pvz., Žymes). Tai rodo, kad vartotojas domisi ir nori atsinaujinti išsaugotoje saugykloje. Tačiau žvaigždute pažymėtos saugyklos redaguoti negalima.
  2. Įsipareigoja: Pakeitimų išsaugojimas saugykloje vadinamas įsipareigojimu. Įsipareigojimui pridedama įvairių detalių, turinys, pranešimas (aprašas), autoriaus vardas ir laiko žyma.
  3. „Pull Request“: „Pull Request“ informuoja kitus apie patobulinimus, kuriuos perdavėte į kitą „GitHub“ saugyklą, išskyrus jūsų. „Pull Request“ dažnai vadiname „GitHub“ bendradarbiavimo širdimi.
  4. Problemos: „GitHub“ problemos naudojamos norint gauti vartotojų atsiliepimus, sekti idėjas, patobulinimus ir įrašyti į klaidas, apie kurias pranešta saugykloje.
  5. Indėlis: „GitHub“ įnašai nurodo įnašų, atliktų kitose saugyklose, skaičių. Įnašas gali būti pateiktas naudojant „Pull Request“.

Norėdami pridėti „GitHub Stats“ ženklelį prie savo saugyklos, įdėkite žemiau esantį „Markdown“ kodą į savo failą README.md.

! [Jūsų saugyklos statistika] ( https://github-readme-stats.vercel.app/api? naudotojo vardas = jūsų_GitHub_Username & show_icons = tiesa)

Nepamirškite pakeisti vartotojo vardas = vertė jūsų „GitHub“ vartotojo vardui. „GitHub Stats“ ženklelyje taip pat pateikiami tokie rangai kaip S + (1% viršuje), S (25% viršuje), A ++ (45% viršuje), A + (60% geriausių) ir B + (visiems). Kuo aukštesnė jūsų statistika, tuo geresnis jūsų reitingas.

Kaip rodo pavadinimas, žymenyje „Dažniausiai naudojamos kalbos“ rodomos dažniausiai „GitHub“ vartojamos kalbos. Tai yra „GitHub“ metrika, kurios kalbos, pvz HTML, CSS, „JavaScript“, „Python“, „Go“, ir daugiau turi daugiausiai „GitHub“ kodo. Kalbos pateikiamos mažėjimo tvarka.

Susijęs: Kokią programavimo kalbą turėtumėte išmokti?

Norėdami pridėti saugyklą „Dažniausiai naudojamos kalbos“, į savo failą README.md įdėkite toliau pateiktą žymėjimą.

! [Jūsų saugyklos statistika] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Your_GitHub_Username&theme=blue-green)

Vienintelis šio ženklelio trūkumas yra tas, kad jame nebus nurodyta „Markdown“ kaip dažniausiai naudojama kalba.

„Contributors“ ženklelyje rodomos visos operacijos, pvz papildymai, išbraukimaiir įsipareigoja kurie buvo atlikti jūsų saugyklose. Sujungus traukimo užklausą į saugyklą, užklausą sukūręs asmuo bus pridėtas kaip bendraautorius. Tai tikrai geras įprotis įskaityti prisidedančius asmenis, kurie savo laiką skyrė atnaujinti savo saugyklą.

„Contributors“ ženklelis gali būti sugeneruotas naudojant „Contribors-img“ - žiniatinklio programą, kuri sugeneruoja vaizdą, kuriame pateikiamas bendraautorių sąrašas.

Sugeneruoti įvaizdžio įvaizdį yra gana trivialu. Eikite į „Contribors-img“ svetainę ir įklijuokite jūsų saugyklos pavadinimas kartu su tavo Vartotojo vardas sugeneruoti URL. Arba tiesiog įdėkite žemiau pateiktą „Markdown“ kodą, kad gautumėte vaizdą.

! [„GitHub“ bendraautorių vaizdas] ( https://contrib.rocks/image? repo = Jūsų_GitHub_Username / Jūsų_GitHub_Repository_Name)

Atsitiktinių pokštų generatorius sukurs techninį pokštą klausimų ir atsakymų forma. Pavyzdžiui, "Kas yra kompiuterio virusas? Terminalo liga”.

Jei norite naudoti ženklelį, turite įterpti „Markdown“ kodą į savo failą README.md, kaip parodyta žemiau.

## 😂 Čia yra atsitiktinis pokštas, kuris privers jus juoktis!
! [Anekdotų kortelė] ( https://readme-jokes.vercel.app/api)

„Profilio peržiūros skaitiklio“ ženklelis rodo, kiek kartų jūsų „GitHub“ profilis buvo peržiūrėtas jūsų profilyje. Norėdami sugeneruoti šį ženkliuką, įdėkite šį žymėjimo kodą:

! [Profilio peržiūros skaitiklis] ( https://komarev.com/ghpvc/?username=Your_GitHub_Username)

Norėdami sugeneruoti saugyklos peržiūrų skaičių, galite naudoti HITS (Kaip idiotai seka sėkmę) ženkliukas. Tai paprastas būdas pamatyti, kiek žmonių aplankė jūsų „GitHub“ saugykla:

! [Hitai] ( https://hitcounter.pythonanywhere.com/count/tag.svg? url = Įklijuoti_Jūsų_GitHub_Repository_Link_Here)

Bet tiek „Profile View“ skaitiklio, tiek „HITS“ trūkumas yra tas, kad jie nerodo peržiūrų skaičiaus su unikaliu ID. Kiekvieną kartą, kai iš naujo įkeliate naršyklę / saugyklą, skaičiai bus didinami. Atnaujindami puslapį lengvai gautumėte daugiau peržiūrų.

Visiškas „GitHub“ ženklelių įgyvendinimas

Kaip pavyzdį naudojau savo „GitHub“ saugyklą. Norint sugeneruoti ženklelius, rekomenduojama šiuos kodus pridėti prie nurodyto failo README.md. Jei „GitHub“ saugykloje neturite failo README.md, geriausias pasirinkimas yra rankinis.

# 5 geriausių ženklelių, kurie pakels jūsų „GitHub“ saugyklą į kitą lygį
## 1. „GitHub“ statistika
! [Jūsų saugyklos statistika] ( https://github-readme-stats.vercel.app/api? vartotojo vardas = Tanu-N-Prabhu ir show_icons = tiesa)
## 2. Dažniausiai vartojamos kalbos
! [Jūsų saugyklos statistika] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Tanu-N-Prabhu&theme=blue-green)
## 3. Pagalbininkų ženklas
! [Jūsų saugyklos statistika] ( https://contrib.rocks/image? atpirkimas = Tanu-N-Prabhu / Python)
## 4. Atsitiktinis pokšto generatorius
! [Anekdotų kortelė] ( https://readme-jokes.vercel.app/api)
## 5. Profilio peržiūros skaitiklis
! [Profilio peržiūros skaitiklis] ( https://komarev.com/ghpvc/?username=Tanu-N-Prabhu)
### saugyklos peržiūros skaitiklis - HITS
! [Hitai] ( https://hitcounter.pythonanywhere.com/count/tag.svg? URL = https://github.com/Tanu-N-Prabhu/Python)

README.md faile nereikia vykdyti ar paleisti aukščiau nurodyto žymėjimo kodo fragmento. Kai išsaugosite failą su plėtiniu (.md), „GitHub“ automatiškai pateiks išvestį, o pakeitimai bus tiesiogiai atspindėti jūsų saugykloje.

Yra daugiau „GitHub“ ženklelių

Dabar, kai žinote, kaip pridėti „GitHub“ ženklelius prie savo saugyklos, tai yra puiki galimybė kūrėjams ir asmenims, kurie gali naudoti šiuos ženklelius, kad padidintų savo saugyklų įskaitomumą. Tai nėra taip sunku - tereikia įdėti keletą „Markdown“ kodo eilučių, kad būtų sugeneruoti ženkleliai.

Kuo daugiau ženklelių įtrauksite į savo saugyklą, tuo daugiau dėmesio sulauksite. Vienas ženklelis galės pateikti naudingos informacijos apie statistiką, būseną ir metriką.

El
Kaip klonuoti saugyklą naudojant „GitHub Desktop“

Norite susipažinti su „GitHub“ programine įranga? Štai kaip tai padaryti rytuose naudojant supaprastintą „GitHub Desktop“ įrankį.

Susijusios temos
  • Programavimas
  • Užsirašyk
  • „GitHub“
Apie autorių
Tanu Pradhu (Paskelbta 1 straipsnis)Daugiau iš Tanu Pradhu

Prenumeruokite mūsų naujienlaiškį

Prisijunkite prie mūsų naujienlaiškio, kuriame rasite techninių patarimų, apžvalgų, nemokamų el. Knygų ir išskirtinių pasiūlymų!

Dar vienas žingsnis…!

Prašome patvirtinti savo el. Pašto adresą el. Laiške, kurį jums ką tik išsiuntėme.

.