Hurtig guide til brug af Github

Denne vejledning er en hurtig guide til installation og brug af GitHub. Sådan oprettes et lokalt lager, hvordan man forbinder dette lokale lager til det eksterne Github-lager (hvor alle kan se det), hvordan man forpligter sig til ændringer, og endelig hvordan man skubber alt lokalt lagerindhold til GitHub, blandt andre almindelige opgaver.

Før du starter, er det vigtigt at bemærke, at denne vejledning forudsætter en grundlæggende forståelse af de udtryk, der bruges i Git: push, pull, commit, repository osv. Det kræver også forudgående registrering i GitHub.

Github installation

På Debian / Ubuntu og derivater:

sudo apt-get install git

En Fedora og derivater:

sudo yum install git

En Arch og derivater:

sved pacman -S git

Github oprindelige opsætning

Når installationen er gennemført, er det næste trin at konfigurere GitHub-brugerkonfigurationsoplysningerne. For at gøre dette skal du bruge følgende kommandoer og erstatte "brugernavn" med dit GitHub-brugernavn og "email_id" med den e-mail-adresse, der bruges til at oprette GitHub-kontoen.

git config - global bruger.navn "brugernavn" git config - global user.email "email_id"

Opret et lokalt lager

Den første ting er at oprette en mappe på din computer, som fungerer som et lokalt lager. For at gøre dette skal du bare køre følgende kommando:

git init Mytest

Denne kommando opretter MyTest-mappen. Til gengæld gør .init-undermappen MyTest anerkendt som et lokalt Git-arkiv.

Hvis lageret oprettes med succes, vises en linje svarende til følgende:

Initieret tomt Git-arkiv i /home/tu_usuario/Mytest/.git/

Derefter skal du gå til MyTest-mappen:

cd Mytest

Opret en README-fil for at beskrive lageret

README-filen bruges generelt til at beskrive, hvad lageret indeholder, eller hvad projektet handler om. For at oprette en skal du bare køre:

gedit README

Når du har indtastet depotbeskrivelsen, skal du ikke glemme at gemme dine ændringer.

Tilføjelse af arkivfilerne til et indeks

Dette er et vigtigt skridt. Inden du kan uploade dine ændringer til Github eller en anden Git-kompatibel server, skal du indeksere alle filerne i det lokale lager. Dette indeks indeholder de nye filer samt ændringer til de eksisterende filer i det lokale arkiv.

I vores tilfælde indeholder vores lokale lager allerede en ny fil: README. Derfor skal vi oprette en anden fil med et simpelt C-program, og som vi vil kalde eksempel.c. Indholdet vil være:

#include int main () {printf ("hej verden"); returnere 0; }

Så nu har vi 2 filer i vores lokale arkiv: README og example.c.

Det næste trin er at tilføje disse filer til indekset:

git add README git add smaple. c

Kommandoen "git add" kan bruges til at tilføje et vilkårligt antal filer og mapper til indekset. For at tilføje alle ændringerne uden at angive filernes navn er det muligt at udføre "git add." (med en periode i slutningen).

Gem ændringer foretaget i indekset

Når alle filerne er tilføjet, er det muligt at registrere disse ændringer ved at gøre det, der i jargongen kaldes en "commit". Dette betyder, at tilføjelse eller ændring af filer er afsluttet, og ændringerne kan uploades til det eksterne Github-lager. For at gøre dette skal du udføre følgende kommando:

git commit -m "besked"

"Besked" kan være enhver besked, der kort beskriver de pågældende ændringer, for eksempel: "Jeg tilføjede en sådan funktionalitet" eller "Jeg har rettet en sådan ting" osv.

Opret et lager på GitHub

Lagringsnavnet skal være det samme som lageret på det lokale system. I dette tilfælde vil det være "MyTest". For at gøre dette skal du først og fremmest logge på Github. Klik derefter på plustegnet (+) i øverste højre hjørne af siden, og vælg indstillingen "Opret nyt lager". Endelig skal du udfylde dataene og klikke på knappen "Opret lager".

Når dette er gjort, oprettes lageret, og det vil være muligt at uploade indholdet af det lokale lager til GitHub-arkivet. For at oprette forbindelse til det eksterne lager på GitHub skal du køre kommandoen:

git remote tilføj oprindelse https://github.com/user_name/Mytest.git

Skub filer fra det lokale lager til GitHub-lageret

Det sidste trin er at skubbe indholdet af det lokale lager til det eksterne lager ved hjælp af kommandoen:

git push origin master

Det er kun at indtaste loginoplysningerne (brugernavn og adgangskode).

Dette uploader alt indholdet af MyTest-mappen (lokalt lager) til GitHub (eksternt lager). For efterfølgende projekter behøver du ikke længere følge disse trin fra bunden. I stedet kan du starte fra trin 3 direkte. Endelig skal du ikke glemme, at ændringerne vil være tilgængelige fra Github-webstedet.

Oprettelse af en gren

Når udviklere ønsker at rette fejl eller tilføje nye funktioner, opretter de ofte en filial eller kopi af koden, så de kan begå separat, uden at det påvirker det oprindelige projekt. Så når de er færdige, kan de fusionere denne gren tilbage til hovedgrenen (master).

For at oprette en ny gren er der to muligheder:

Lang mulighed:

git gren mirama # opret en ny gren kaldet mirama git checkout mirama - skift til brug af mirama gren.

Kort mulighed:

git checkout -b mirama - opret og skift til brug af mirama-grenen

Når ændringerne er foretaget, skal du tilføje dem til filialindekset og foretage den tilsvarende forpligtelse:

git add. git commit -m "ændringer til mirama"

Derefter skal du gå tilbage til hovedgrenen og tage de ændringer, der er foretaget i mirama:

git checkout master git fusion mirama

Endelig skal du slette mirama (da ændringerne blev indarbejdet i master):

git gren -d mirama

Og upload master til Github:

git push origin master

Oprettelse af et afledt Git-arkiv (fork)

Takket være Git og eksistensen af ​​store offentlige arkivbiblioteker, såsom Github, er det for det meste ikke nødvendigt at begynde at programmere vores projekt fra bunden. I disse tilfælde er det muligt at tage denne basiskode for at oprette et nyt projekt.

For at gøre dette er den første ting at gøre en gaffel i et eksisterende lager, det vil sige et projekt afledt af det, der tager koden for det oprindelige projekt som base. På Github opnås dette ved at klikke på den tilsvarende knap som vist på skærmbilledet nedenfor.

Derefter skal vi klone lageret til dette nye projekt på vores computer. Som et eksempel kan vi bruge mit Ankifox-arkiv, en udvidelse til Firefox, der gør det muligt at tilføje ord til Anki, som er tilgængelig på Github:

git-klon https://github.com/usemoslinux/Ankifox.git

Glem ikke at erstatte https://github.com/usemoslinux/Ankifox.git med den URL, der svarer til dit projekt. At få denne adresse er meget let, som det ses på billedet nedenfor.

Denne kommando opretter et bibliotek med navnet «Ankifox», det initialiserer .git-biblioteket inden i det, og det downloader alle data fra dette arkiv for at arbejde med den nyeste version.