benthayer / git-gud

Wat is het?

Welkom bij Git Gud, een opdrachtregelspel dat ontworpen is om je te helpen het populaire versiebeheersysteem Git te leren gebruiken!Naarmate de levels vorderen, zul je meer en meer over Git weten, en uiteindelijk een Git grootmeester worden!

Als er iets ontbreekt, voel je dan vrij om een issue toe te voegen, of als je geïnteresseerd bent, bekijk dan het contribuanten bestand en voeg zelf iets toe! Het project is zo gestructureerd dat het heel makkelijk is om nieuwe levels toe te voegen!

Als je meer een visuele leerling bent, zou je moeten beginnen met “Leer Git Branching”, en dan Git Gud eens proberen. Leer Git Branching is meer visueel, maar met Git Gud, gebruik je Git om de levels te voltooien.

Hoe gebruik ik het?

Voor installatie instructies, zie hieronder.

Als Git Gud eenmaal geïnstalleerd is, zal het typen van “git gud” uitvoer produceren en je vertellen wat je moet doen.Git Gud is bedoeld als een spel, en net als een spel, heeft het levels.De levels zijn verdeeld in vaardigheden, waarvan elk je zal introduceren in een nieuw onderwerp in Git.Het begint, ervan uitgaande dat je nul kennis hebt, en bouwt dan op.Voor elk level, zal het je een doel geven en zal uitleggen wat er aan de hand is.Idealiter leert het spel je alles wat je moet weten om het te verslaan, maar je wordt nog steeds aangemoedigd om andere bronnen te gebruiken om zoveel te leren als je wilt.

De beginlevels van het spel beginnen met je te laten wennen aan de Git Gud interface, maar later gaan de trainingswielen eraf, en zul je moeten onthouden om de commando’s in te typen.Als je ooit vergeet welke commando’s er zijn, of als je op een later level wilt beginnen, kun je altijd “git gud help” uitvoeren.De belangrijkste commando’s zijn git gud goal, git gud status, git gud explain git gud test, en git gud load next.Andere commando’s zijn ook nuttig, maar de uitvoer van die commando’s zou genoeg moeten zijn om je door het level te leiden.

Om te beginnen moet je Git Gud initialiseren in een lege map.Als Git Gud eenmaal geïnitialiseerd is, heeft het volledige controle over die map, en zal het beginnen met het toevoegen/verwijderen van commits en bestanden.Er zullen normaal gesproken meerdere branches zijn, en er wordt van je verwacht dat je Git commando’s gebruikt om elk level op te lossen.De levels variëren in moeilijkheidsgraad, en vereisen dat je verschillende dingen doet.Sommige levels zijn erg makkelijk en vereisen alleen dat je de uitleg leest, maar anderen geven je alleen een situatie en je zult moeten gebruiken wat je geleerd hebt om het level op te lossen.

Hoe te installeren

Git Gud is geschreven in Python 3.Je moet Python >=3.6 in je systeem geïnstalleerd hebben om Git Gud te laten werken.Ik gebruik liever Anaconda om er zeker van te zijn dat alles correct werkt, maar je kunt ook met pip installeren als je weet wat je doet.

Als je omgeving eenmaal is ingesteld met Python >=3.6, is installeren eenvoudig:

pip3 install git-gud

Aan de slag gaan is ook eenvoudig:

git gud

Git Gud leidt u door wat u moet doen

Als een van deze commando’s niet werkt, zijn er nog verschillende dingen die u kunt proberen:

• Gebruik pip in plaats van pip3
• Zorg ervoor dat uw PATH variabele de Python executables bevat
• User installeer: pip3 install --user git-gud
• Gebruik Anaconda