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

Vergeet niet 'gebruikersnaam' en 'MyTest' te vervangen door uw overeenkomstige gebruikersnaam en map.

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.

Vork van een Github-repository

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.

Een Github-repository klonen

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.


De inhoud van het artikel voldoet aan onze principes van redactionele ethiek. Klik op om een ​​fout te melden hier.

22 reacties, laat de jouwe achter

Laat je reactie achter

Uw e-mailadres wordt niet gepubliceerd.

*

*

  1. Verantwoordelijk voor de gegevens: Miguel Ángel Gatón
  2. Doel van de gegevens: Controle SPAM, commentaarbeheer.
  3. Legitimatie: uw toestemming
  4. Mededeling van de gegevens: De gegevens worden niet aan derden meegedeeld, behalve op grond van wettelijke verplichting.
  5. Gegevensopslag: database gehost door Occentus Networks (EU)
  6. Rechten: u kunt uw gegevens op elk moment beperken, herstellen en verwijderen.

  1.   Victor Martinez zei

    Precies zoiets waar ik naar op zoek was, een eenvoudige en praktische gids die alles stap voor stap uitlegt.
    Voor Bibucket denk ik dat het bijna dezelfde stappen zouden zijn, toch?

    1.    laten we linux gebruiken zei

      Precies. Het lijkt erg op elkaar. Verander gewoon de URL van de externe host.
      Het interessante van Bitbucket is dat het de mogelijkheid biedt om privé-repositories te creëren (dat wil zeggen, het is niet open voor het grote publiek, maar is alleen toegankelijk voor een specifieke groep mensen). Op Github is dit ook mogelijk, maar dan moet je wel betalen. Aan de andere kant, in Bitbucket nr.
      Proost! Paul.

  2.   Jonathan Diaz zei

    Geweldige vrienden !!! Van de beste ruimtes in inter om te ontdekken en te leren,

    1.    laten we linux gebruiken zei

      Als je geïnteresseerd bent in het onderwerp, raad ik je aan een tutorial te bekijken die een communitylid heeft gedaan over het gebruik van Git + Google Code, die ook erg interessant en praktisch is:

      https://blog.desdelinux.net/iniciando-un-proyecto-con-git-y-google-code-parte-i/
      https://blog.desdelinux.net/iniciando-un-proyecto-con-git-y-google-code-parte-ii/
      https://blog.desdelinux.net/iniciando-un-proyecto-con-git-y-google-code-parte-iii/
      https://blog.desdelinux.net/iniciando-un-proyecto-con-git-y-google-code-parte-iv/

      Proost! Paul.

  3.   elav zei

    Dankzij jou vind ik Bitbucket leuker .. hoe dan ook goed artikel 😀

  4.   nex zei

    @usemoslinux Kun je "GitHub" maken om het FreeBSD-systeem automatisch te installeren?, het bijna automatische installatieprogramma zou net als Arch een grote hulp zijn, interessant bericht.

    PS: een GitHub-gids voor FreeBSD zou leuk zijn.

  5.   josep m. Fernandez zei

    Bedankt voor de gids. Ik volg het en ik had een klein probleempje, ik kan de lokale repository niet uploaden naar de externe. Het geeft me de volgende foutmelding:

    [root @ iou Mytest] #git push oorsprong master
    error: De opgevraagde URL heeft een fout geretourneerd: 403 Verboden tijdens toegang https://github.com/miusuario/Mytest.git/info/refs

    Iemand een idee?

    1.    laten we linux gebruiken zei

      Wat er mogelijk gebeurt, is dat de URL van de externe repository die u invoert niet correct is. Dit kan te wijten zijn aan een typfout bij het invoeren van de URL of je hebt de repository niet echt op Github gemaakt (via hun webpagina).

      Als het foutbericht exact hetzelfde is als het bericht dat u toont, miste u de wijziging van "mijngebruiker" voor uw gebruikersnaam.

      Typ git remote -v om de ingevoerde URL's te zien. Om het te wijzigen, plaatst u git remote set-url origin URLNEW

      URLNEW vervangen door de juiste URL.

      Vergeet ten slotte niet dat de URL hoofdlettergevoelig is.

      Proost! Paul.

  6.   Tesla zei

    Verbazingwekkend!

    Uitgelegd zodat zelfs degenen die minder goed geïnformeerd zijn, zoals ik, het begrijpen en onze eerste stappen kunnen zetten in git of Github. Nu zijn veel termen als push, pull of commit mij duidelijk.

    Hartelijk dank!

    1.    laten we linux gebruiken zei

      Het was het idee! Ik ben er blij om!
      Een knuffel en bedankt voor het achterlaten van je reactie! Paul.

  7.   statisch zei

    Geniaal

    Een vraag als ik bestanden verwijder die ik niet langer nodig heb, noch in de lokale noch in de Github-repository

  8.   statisch zei

    Ik corrigeer mijn twijfel om mappen met volledige bestanden te verwijderen

    git rm -rf map

    of als ???

    1.    laten we linux gebruiken zei

      Om bestanden te verwijderen:
      git rm bestand1.txt

      Om mappen (en hun inhoud) te verwijderen:
      git rm -r mijn map

  9.   statisch zei

    Ik ontdekte dat het er uitzag, uitstekende dank

  10.   Victor Mansilla zei

    En hoe gebruik ik Gitlab?
    In elementaryOS kan het tenminste de configuratie niet voltooien ...

  11.   statisch zei

    Deze foutmelding verschijnt als ik een

    git pull oorsprong master

    http://i.imgur.com/fy5Jxvs.png

    1.    laten we linux gebruiken zei

      Zoals uitgelegd in de schermafbeelding die u deelt, zijn er wijzigingen op de server die niet zijn opgenomen in de versie die op uw computer is opgeslagen. Op hun beurt zijn er wijzigingen op uw computer die niet op de server staan ​​(dit zijn de wijzigingen die u wilt uploaden). Vandaar het conflict.

      Probeer eerst een git pull uit te voeren, zoals voorgesteld in de schermafbeelding.

  12.   Jose zei

    Bedankt voor de hulp, zeer goede info, ik zal het in de praktijk brengen, nogmaals bedankt

  13.   Alonso zei

    In de sectie: "Push bestanden van lokale repository naar GitHub-repository"
    , jij kunt lezen:
    Dit zal alle inhoud van de MyTest-map (lokale repository) uploaden 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. »

    Ik begin hiermee vanuit Git. Kunt u mij vertellen wat "stap 3" is?

    Bovendien zijn de commando's:
    git config –global user.name "gebruikersnaam"
    git config –global user.email "email_id"

    Moeten ze in elke Git-sessie worden gedaan?

    Evenzo het commando:
    git init "mapnaam"
    Is het nodig om het in elke werksessie met Git of de repository in kwestie uit te voeren, wat gebeurt er als ik twee of meer repositories heb?

    Geweldige tutorials, gefeliciteerd, bedankt en groeten.

  14.   sergio zei

    Ik begreep het perfect, het doet pijn dat er geen GUI-client is zoals Windows / Mac: /

  15.   sonia zei

    Ik ben hier gekomen om een ​​probleem op te lossen dat voortkomt uit: fatal: geen git-repository (of een van de bovenliggende mappen): .git Is deze handleiding opgelost ??? bij voorbaat dank 🙂

  16.   Alexander zei

    Gebruikersnaam voor 'https://github.com': «royalAlexander»
    Wachtwoord voor 'https: // »royalAlexander» @ github.com':
    remote: ongeldige gebruikersnaam of wachtwoord.
    fataal: verificatie is mislukt voor 'https://github.com/royalSanity/Mytest.git/'

    help me