Korte handleiding voor het gebruik van Github

Deze tutorial is een korte handleiding voor het installeren en gebruiken van GitHub. Hier leest u hoe u een lokale repository maakt, hoe u deze lokale repository verbindt met de externe Github-repository (waar iedereen het kan zien), hoe u wijzigingen vastlegt en ten slotte hoe u alle lokale repository-inhoud naar GitHub pusht, naast andere veelvoorkomende taken.

Voordat we beginnen, is het belangrijk op te merken dat deze tutorial een basisbegrip veronderstelt van de termen die in Git worden gebruikt: push, pull, commit, repository, etc. Het vereist ook voorafgaande registratie in GitHub.

Github-installatie

Over Debian / Ubuntu en afgeleiden:

sudo apt-get install git

En Fedora en derivaten:

sudo yum install git

En boog en derivaten:

sudo pacman -S git

Github eerste installatie

Zodra de installatie met succes is voltooid, is de volgende stap het configureren van de GitHub-gebruikersconfiguratiedetails. Gebruik hiervoor de volgende opdrachten, waarbij je "gebruikersnaam" vervangt door je GitHub-gebruikersnaam en "email_id" door het e-mailadres dat is gebruikt om het GitHub-account aan te maken.

git config --global user.name "gebruikersnaam" git config --global user.email "email_id"

Maak een lokale repository

Het eerste is om een ​​map op uw computer aan te maken, die zal dienen als een lokale opslagplaats. Om dit te doen, voert u gewoon de volgende opdracht uit:

git init Mytest

Met deze opdracht wordt de map MyTest gemaakt. Op zijn beurt zorgt de .init-submap ervoor dat MyTest wordt herkend als een lokale Git-repository.

Als de repository met succes is aangemaakt, verschijnt een regel die lijkt op de volgende:

Geïnitialiseerde lege Git-opslagplaats in /home/tu_usuario/Mytest/.git/

Vervolgens moet u naar de map MyTest gaan:

cd Mijntest

Maak een README-bestand om de repository te beschrijven

Het README-bestand wordt over het algemeen gebruikt om te beschrijven wat de repository bevat of waar het project over gaat. Om er een te maken, voert u gewoon uit:

gedit LEES MIJ

Vergeet niet uw wijzigingen op te slaan nadat u de beschrijving van de repository heeft ingevoerd.

De repository-bestanden toevoegen aan een index

Dit is een belangrijke stap. Voordat je je wijzigingen naar Github of een andere Git-compatibele server kunt uploaden, moet je alle bestanden in de lokale repository indexeren. Deze index bevat zowel de nieuwe bestanden als wijzigingen aan de bestaande bestanden in de lokale repository.

In ons geval bevat onze lokale repository al een nieuw bestand: de README. Daarom gaan we een ander bestand maken met een eenvoudig C-programma en dat we example.c zullen noemen. De inhoud zal zijn:

#include int main () {printf ("hallo wereld"); retourneer 0; }

Dus nu hebben we 2 bestanden in onze lokale repository: README en example.c.

De volgende stap is om deze bestanden aan de index toe te voegen:

git add README git add smaple.c

Het "git add" commando kan gebruikt worden om een ​​willekeurig aantal bestanden en mappen aan de index toe te voegen. Om alle wijzigingen toe te voegen, zonder de naam van de bestanden op te geven, is het mogelijk om "git add" uit te voeren. (met een punt aan het einde).

Sla wijzigingen op die in de index zijn aangebracht

Zodra alle bestanden zijn toegevoegd, is het mogelijk om een ​​record van deze wijzigingen achter te laten door te doen wat in het jargon een "commit" wordt genoemd. Dit betekent dat het toevoegen of wijzigen van bestanden is voltooid en dat de wijzigingen kunnen worden geüpload naar de externe Github-repository. Om dit te doen, moet u de volgende opdracht uitvoeren:

git commit -m "bericht"

"Bericht" kan elk bericht zijn dat een korte beschrijving geeft van de wijzigingen in kwestie, bijvoorbeeld: "Ik heb een dergelijke functionaliteit toegevoegd" of "Ik heb zoiets verbeterd", enzovoort.

Maak een repository op GitHub

De naam van de opslagplaats moet hetzelfde zijn als de opslagplaats op het lokale systeem. In dit geval is het "MyTest". Om dit te doen, moet u zich allereerst aanmelden bij GitHub. Klik vervolgens op het plusteken (+) in de rechterbovenhoek van de pagina en selecteer de optie "nieuwe opslagplaats aanmaken". Ten slotte moet u de gegevens invullen en op de knop "opslagplaats maken" klikken.

Zodra dit is gebeurd, wordt de repository gemaakt en is het mogelijk om de inhoud van de lokale repository te uploaden naar de GitHub-repository. Om verbinding te maken met de externe repository op GitHub, moet je de volgende opdracht uitvoeren:

git remote origin toevoegen https://github.com/user_name/Mytest.git

Push bestanden van de lokale repository naar de GitHub-repository

De laatste stap is om de inhoud van de lokale repository naar de externe repository te pushen met behulp van de volgende opdracht:

git push origin master

Het blijft alleen om de inloggegevens (gebruikersnaam en wachtwoord) in te voeren.

Hiermee wordt alle inhoud van de MyTest-map (lokale repository) geüpload naar GitHub (externe repository). Voor volgende projecten hoeft u deze stappen niet meer vanaf nul te volgen. In plaats daarvan kunt u direct vanaf stap 3 beginnen. Vergeet ten slotte niet dat de wijzigingen beschikbaar zullen zijn op de Github-website.

Een filiaal aanmaken

Wanneer ontwikkelaars bugs willen repareren of nieuwe functies willen toevoegen, maken ze vaak een branch of kopie van de code zodat ze afzonderlijk kunnen vastleggen, zonder het oorspronkelijke project te beïnvloeden. Als ze klaar zijn, kunnen ze deze branch weer samenvoegen in de hoofdtak (master).

Er zijn twee opties om een ​​nieuwe branch aan te maken:

Lange optie:

git branch mirama # maak een nieuwe branch aan met de naam mirama git checkout mirama - schakel over naar het gebruik van de mirama branch.

Korte optie:

git checkout -b mirama - maak aan en schakel over naar het gebruik van de mirama branch

Zodra de wijzigingen zijn aangebracht, voegt u ze toe aan de branchindex en voert u de bijbehorende commit uit:

git add. git commit -m "verandert in mirama"

Vervolgens moet je teruggaan naar de hoofdtak en de wijzigingen aanbrengen die in mirama zijn aangebracht:

git checkout master git merge mirama

Ten slotte moet je mirama verwijderen (aangezien de wijzigingen in master zijn verwerkt):

git branch -d mirama

En upload master naar Github:

git push origin master

Een afgeleide Git-repository (fork) maken

Dankzij Git en het bestaan ​​van grote openbare repositorybibliotheken, zoals Github, is het meestal niet nodig om ons project helemaal opnieuw te programmeren. In die gevallen is het mogelijk om deze basiscode te gebruiken om een ​​nieuw project te creëren.

Om dit te doen, is het eerste dat u moet doen een splitsing van een bestaande repository, dat wil zeggen, een project dat ervan is afgeleid op basis van de code van het oorspronkelijke project. Op Github wordt dit bereikt door op de overeenkomstige knop te klikken, zoals te zien is in de onderstaande schermafbeelding.

Wat we dan moeten doen, is de repository van dit nieuwe project op onze computer klonen. Als voorbeeld kunnen we mijn Ankifox-repository gebruiken, een extensie voor Firefox waarmee woorden kunnen worden toegevoegd aan Anki, die beschikbaar is op Github:

git kloon https://github.com/usemoslinux/Ankifox.git

Vergeet niet om https://github.com/usemoslinux/Ankifox.git te vervangen door de URL die overeenkomt met uw project. Het verkrijgen van dit adres is heel eenvoudig, zoals te zien is in de onderstaande afbeelding.

Dit commando zal een directory aanmaken met de naam «Ankifox», het zal de .git directory daarin initialiseren, en het zal alle data uit die repository downloaden om met de laatste versie te werken.