A GitHub jelvények javíthatják az adattár olvashatóságát azáltal, hogy a felhasználóknak gyors módot kínálnak a tároló metrikáinak rögzítésére. Jelvények ágyazhatók a README.md-be, hogy tisztázzák a projekt fontosságát és szükségességét más fejlesztők számára. Ennek eredményeként az olvasók nagyon gyorsan képet kapnak a tárról a csatolt jelvények ellenőrzésével.
Számos GitHub jelvény érhető el az interneten, itt található az öt legfontosabb informatív jelvény, amelyet fel kell venni a README.md fájlba. Minden felsorolt jelvényhez megadják az egyenértékű Markdown kódot.
Mit tehetnek a GitHub jelvények az Ön számára?
A GitHub jelvények hozzáadása a tárához csekélynek tűnhet, de valójában hihetetlenül hasznos. Csak annyit kell tennie, hogy importálja a Markdown kódot a forrásból a README.md fájlba.
Amikor létrehoztam a Python Programming GitHub adattáramat, kihagytam a jelvényeket. Dísztelen tárházam megfelelő tartalommal rendelkezett, de nem tűnt ki. Emiatt az adattár nagyon kevés forgalmat nyert (egyedi látogatók).
Összefüggő: A GitHub-tár létrehozása
Szeretné online megosztani fejlesztési projektjeit? Így kezdheti el az első Github-tárházat.
Miután több jelvényt adtam az adattáramhoz, láttam, hogy a külső látogatók havonta automatikusan nőttek (5-ről 767-re) (tekintse meg egyedi látogatóit itt: Betekintés> Forgalom a táradon.)
A Beérkezett üzeneteim tele voltak megjegyzésekkel arról, hogy az adattáram kitűnt-e a többi Python programozási lerakattól a jelvények miatt. Egy egyszerű GitHub jelvény teljesen megváltoztathatja a tárház kinézetét.
Ezt mindig tartsa szem előtt: a jelvény 1000 sornyi kódot ér.
A GitHub statisztika jelvény bemutatja a GitHub-adattárad összes csillagát, elkötelezettségét, lekérési kérelmét, kiadását és hozzájárulását.
- Csillagok: A felhasználók elmentik a GitHub adattárakat (például könyvjelzőket). Ez azt jelzi, hogy a felhasználó érdeklődik és szeretné naprakészen tartani a mentett adattárat. Csillagozott adattár azonban nem szerkeszthető.
- Vállalások: A lerakat változásainak mentését Commit-nak nevezzük. Különféle részleteket csatolnak az elkötelezettséghez, tartalma, üzenet (leírás), szerző neve és időbélyegzője.
- Húzási kérelem: A Pull Request tájékoztat másokat azokról a fejlesztésekről, amelyeket egy másik GitHub adattárba tett, kivéve az Önét. Gyakran hivatkozunk a Pull Request-re, mint a GitHub Collaboration szívére.
- Problémák: A GitHub-problémák felhasználásával visszajelzést kapunk a felhasználókról, nyomon követhetjük az ötleteket, a fejlesztéseket és felsoroljuk az adattárnak jelentett hibákat.
- Hozzájárulás: A GitHub-hozzájárulások jelzik a más adattárakhoz tett hozzájárulások számát. Hozzájárulás Pull Request segítségével történhet.
A GitHub Stats jelvény adattárhoz való hozzáadásához ágyazza be az alábbi Markdown kódot a README.md fájljába.
! [A tárad statisztikája] ( https://github-readme-stats.vercel.app/api? felhasználónév = Your_GitHub_Username & show_icons = true)Győződjön meg róla, hogy megváltoztatta a felhasználónév = érték a GitHub felhasználónevéhez. A GitHub Stats jelvény rangsorolást is nyújt, mint pl S + (felső 1%), S (felső 25%), A ++ (felső 45%), A + (felső 60%) és B + (mindenki). Minél magasabb a statisztikád, annál jobb a rangsorod.
Ahogy a neve is sugallja, a Leggyakrabban használt nyelvek jelvény a GitHub egész területén használt leggyakoribb nyelveket jeleníti meg. Ez egy GitHub mutató, mely nyelvek, mint pl HTML, CSS, JavaScript, Python, Go, és még sok más rendelkezik a legtöbb kóddal a GitHubon. A nyelvek csökkenő sorrendben vannak felsorolva.
Összefüggő: Melyik programozási nyelvet kell megtanulnia?
A leggyakrabban használt nyelvek jelvény adattárához való hozzáadásához ágyazza be az alábbi Jelölést a README.md fájlba.
! [A tárad statisztikája] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Your_GitHub_Username&theme=blue-green)A jelvény egyetlen hátránya, hogy a Markdown-t nem fogja felsorolni a leggyakrabban használt nyelvként.
A Contributors Badge megjeleníti az összes olyan műveletet, mint pl kiegészítések, törlések, és elköveti amelyeket a tárolókon végeztek. Amikor egy lekérési kérelmet egyesít a tárába, a kérelmet létrehozó személy hozzáadódik közreműködőként. Valóban jó szokás jóváírni azokat a közreműködőket, akik időt fordítottak arra, hogy frissítést nyújtsanak a tárodhoz.
A Contributors Badge a Contribors-img webalkalmazással hozható létre, amely képet készít a közreműködők listájának megjelenítésére.
A közreműködő képének generálása elég triviális. Keresse meg a közreműködők-img webhelyet, és illessze be a az adattár neve a te felhasználónév az URL létrehozásához. Alternatív megoldásként egyszerűen beágyazhatja az alább megadott Markdown kódot a kép megszerzéséhez.
! [GitHub közreműködők képe] ( https://contrib.rocks/image? repo = Your_GitHub_Username / Your_GitHub_Repository_Name)A véletlenszerű viccgenerátor technikai viccet generál kérdések és válaszok formájában. Például, "Mi az a számítógépes vírus? A Terminal betegség”.
A jelvény használatához be kell ágyaznia a Markdown kódot a README.md fájlba, az alábbiak szerint.
## 😂 Itt egy véletlenszerű vicc, amely megnevettet!
! [Humor kártya] ( https://readme-jokes.vercel.app/api)A Profile View Counter jelvény megmutatja, hogy hányszor tekintették meg a GitHub-profilt a profilodban. A jelvény előállításához beágyazza a következő Markdown kódot:
! [Profil megtekintése számláló] ( https://komarev.com/ghpvc/?username=Your_GitHub_Username)A tárház nézettségének előállításához érdemes használni a HITS (Az idióták hogyan követik a sikert) jelvényt. Ez egy egyszerű módja annak, hogy lássa, hány ember látogatta meg az Önét GitHub adattár:
! [Találatok] ( https://hitcounter.pythonanywhere.com/count/tag.svg? URL = Paste_Your_GitHub_Repository_Link_Here)De mind a Profile View számláló, mind a HITS hátránya, hogy nem mutatják meg az egyedi azonosítókkal rendelkező megtekintések számát. A böngésző / adattár minden egyes újratöltésekor a számok növekedni fognak. Az oldal frissítésével könnyen több megtekintést kaphat.
A GitHub jelvények teljes megvalósítása
Példaként a GitHub adattáramat használtam. A jelvények előállításához ajánlott ezeket a kódokat hozzáadni a kijelölt README.md fájlhoz. Ha nincs README.md fájl a GitHub-tárházban, akkor a legjobb manuális létrehozása.
# # 5 legfontosabb jelvény, amely a GitHub-tárházat a következő szintre emeli
## 1. GitHub statisztika
! [A tárad statisztikája] ( https://github-readme-stats.vercel.app/api? felhasználónév = Tanu-N-Prabhu & show_icons = igaz)
## 2. Leggyakrabban használt nyelvek
! [A tárad statisztikája] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Tanu-N-Prabhu&theme=blue-green)
## 3. Közreműködők jelvénye
! [A tárad statisztikája] ( https://contrib.rocks/image? repo = Tanu-N-Prabhu / Python)
## 4. Véletlenszerű viccgenerátor
! [Humor kártya] ( https://readme-jokes.vercel.app/api)
## 5. Profil nézet számláló
! [Profil megtekintése számláló] ( https://komarev.com/ghpvc/?username=Tanu-N-Prabhu)
### Repository View Counter - HITS
! [Találatok] ( https://hitcounter.pythonanywhere.com/count/tag.svg? URL = https://github.com/Tanu-N-Prabhu/Python)Nincs szükség a fenti jelölési kódrészlet végrehajtására vagy futtatására a README.md fájlban. Abban a pillanatban, amikor elmenti a fájlt (.md) kiterjesztéssel, a GitHub automatikusan megjeleníti a kimenetet, és a változtatások közvetlenül tükröződnek a tárában.
További GitHub jelvények kaphatók
Most, hogy tudja, hogyan kell hozzáadni a GitHub-jelvényeket az adattárához, nagyszerű lehetőség azoknak a fejlesztőknek és magánszemélyeknek, akik ezeket a jelvényeket használva javíthatják táraik olvashatóságát. Ez nem olyan nehéz - a jelvények előállításához csak néhány sort kell beágyaznia a Markdown kódból.
Minél több jelvényt helyez el a tárában, annál több figyelmet kap. Egyetlen jelvény képes hasznos információkkal szolgálni a statisztika, az állapot és a mutatók tekintetében.
Szeretne megismerkedni a GitHub szoftverével? Így teheti meg a kelet felé a korszerűsített GitHub Desktop eszközzel.
- Programozás
- Árleszállítás
- GitHub
Iratkozzon fel hírlevelünkre
Csatlakozzon hírlevelünkhöz, amely műszaki tippeket, véleményeket, ingyenes e-könyveket és exkluzív ajánlatokat tartalmaz!
Még egy lépés…!
Kérjük, erősítse meg e-mail címét az imént elküldött e-mailben.