GitHub hvad det er, og hvordan man bruger det

GitHub er et stykke software, der er meget brugt af softwareudviklingsteams til udviklingsversionskontrol.

Det er nyttigt, når mere end én person arbejder på et projekt.

Antag for eksempel, at et team af softwareudviklere ønsker at bygge et websted, og at de alle skal opdatere koden samtidigt, mens de arbejder på projektet. I dette tilfælde hjælper Github med at skabe et centraliseret lager, hvor alle kan uploade, redigere og administrere programkodefiler.

Før du begynder at bruge GitHub, skal du oprette en konto GitHub.

Repository

Et arkiv bruges normalt til at organisere et applikationssoftwareprojekt. Lagre kan indeholde mapper og filer, billeder, videoer, regneark og datasæt - alt hvad dit projekt har brug for. Ofte indeholder depoter en README-fil, en fil med information om dit projekt.

README-filer er skrevet i Markdown-sprog i almindelig tekst. Du kan rådføre dig denne side web som en hurtig reference til Markdown-sproget. GitHub giver dig mulighed for at tilføje en README-fil, samtidig med at du opretter dit nye depot. GitHub tilbyder også andre almindelige muligheder såsom en licensfil, men du behøver ikke at vælge nogen i starten.

For at oprette et nyt lager, skal du øverst til højre vælge i menuen New repository. Fortsæt med følgende trin:

1. I øverste højre hjørne af enhver side skal du bruge rullemenuen og vælge New repository.

1. Indtast i feltet Depotnavn first-repository.
2. Skriv en kort beskrivelse i boksen Beskrivelse.
3. Vælg Tilføj en README-fil.
4. Vælg, om dit lager skal være offentligt eller privat.
5. Klik på Create repository.

Oprettelse af en filial

Oprettelse af en filial giver dig mulighed for at have flere versioner af et lager på samme tid.

Som standarddefinita, depotet first-repository har en navngivet filial main som betragtes som grenen definitiv. Du kan oprette yderligere filialer til main i depotet first-repository. Du kan bruge filialer til at have forskellige versioner af et projekt på samme tid. Dette er nyttigt, når du vil tilføje ny funktionalitet til et projekt uden at ændre hovedkildekoden. Arbejde udført på forskellige grene vises ikke på mastergrenen, før du flette den. Du kan bruge filialer til at eksperimentere og foretage ændringer, før du forpligter dem til main.

Når du opretter en gren fra hovedgrenen, laver du en kopi eller snapshot af main, som den var på det tidspunkt. Hvis en anden foretog ændringer i mastergrenen, mens du arbejdede på din filial, kunne du skubbe disse opdateringer.

I det følgende diagram kan vi se:

Hovedgrenen
En ny afdeling kaldet feature
Den vej, som feature udfører, før den fusioneres med main

At oprette en filial til en ny implementering eller fejlrettelse er som at gemme en fil. Med GitHub bruger softwareudviklere filialer til at holde fejlrettelser og funktionsarbejde adskilt fra hovedproduktionsgrenen. Når en ændring er klar, flettes den ind i hovedgrenen.

Lad os skabe en gren

Når du har oprettet vores lager, skal du flytte til fanen <>Code(1) af depotet:

Klik på hovedmenuen (2), og giv derefter den nye et navn branch (3)

Klik på Create branch: first branch from 'main'

Nu har vi to branch, main e first-branch. Lige nu ser de præcis ens ud. Senere vil vi tilføje ændringerne til den nye branch.

Foretag og bekræft ændringer

Har lige oprettet den nye branch, GitHub bragte dig til code page for det nye first-branch, som er en kopi af main.

Vi kan foretage og gemme ændringer til filer i depotet. På GitHub kaldes gemte ændringer commit. Hver commit har en besked fra commit tilknyttet, som er en beskrivelse, der forklarer, hvorfor en bestemt ændring blev foretaget. Beskederne fra commit de fanger historien om ændringer, så andre bidragydere kan forstå, hvad der blev gjort og hvorfor.

Under grenen first-branch oprettet, skal du klikke på filen README.md og derefter på blyanten for at redigere filen.

Skriv ved hjælp af Markdown i editoren.

I kassen Commit changes (Preview), skriver vi en besked om commit beskriver ændringerne.

Klik til sidst på knappen Commit changes.

Disse ændringer vil kun blive foretaget i README-filen first-branch, så nu indeholder denne gren et andet indhold end den primære.

Åbning af en pull request

Nu hvor vi har ændringer i en hovedafgrening, kan vi åbne en pull request.

Le pull request de er hjertet i samarbejdet på GitHub. Når du åbner en pull request, du foreslår dine ændringer og anmoder nogen om at lave en review e pull af dit bidrag og at fusionere dem i deres afdeling. Det pull request vis forskellene i indholdet af begge grene. Ændringer, additioner og subtraktioner vises i forskellige farver.

Så snart du forpligter dig, kan du åbne en pull-anmodning og starte en diskussion, selv før koden er færdig.

Brug af funktionen @mention fra GitHub i dit indlæg fra pull request, kan du bede specifikke personer eller teams om feedback, uanset deres placering.

Du kan endda åbne pull request i dit lager og flet dem selv. Det er en fantastisk måde at lære GitHub-strømmen, før du arbejder på større projekter.

At lave en pull request du skal:

• Klik på fanen pull request af dit lager first-repository.

• Klik på New pull request
• I kassen Example Comparisons, vælg den gren, du har oprettet, first-branch, der skal sammenlignes med main (den originale).
• Gennemgå dine ændringer i forskellene på siden Sammenlign, og sørg for, at det er dem, du vil indsende.

• Klik på Create pull request.

• Giv din en titel pull request skriv en kort beskrivelse af dine ændringer. Du kan inkludere emojis og træk og slip billeder og gifs.

• Til højre for titlen og beskrivelsen kan du eventuelt klikke ved siden af ​​Korrekturlæsere. Modtagere, etiketter, projekter eller milepæle for at tilføje nogen af ​​disse muligheder til dine pull request. Du behøver ikke tilføje dem endnu, men disse muligheder tilbyder flere måder at samarbejde på ved hjælp af din pull request.
• Klik på Create pull request.

Dine samarbejdspartnere kan nu gennemgå dine ændringer og komme med forslag.

Flet din pull request

I dette sidste trin vil du flette din filial first-branch i hovedgrenen. Efter sammenlægning af pull request, ændringer til grenen first-branch vil blive indlejret i hovedfilen.

Nogle gange kan en pull-anmodning introducere kodeændringer, der er i konflikt med eksisterende kode på main. Hvis der er nogen konflikter, vil GitHub advare dig om den modstridende kode og forhindre fusionen, indtil konflikterne er løst. Du kan lave en commit, der løser konflikterne eller bruge kommentarerne i pull-anmodningen til at diskutere konflikterne med dine teammedlemmer.

• Klik på Merge pull request at flette ændringerne til hoved.

• Klik på Confirm merge. Du vil modtage en besked om, at anmodningen er blevet flettet, og at anmodningen er blevet lukket.
• Klik på Delete branch. Nu hvor din richiesta pull er slået sammen, og dine ændringer er på main, kan du roligt slette grenen first-branch. Hvis du ønsker at foretage yderligere ændringer i dit projekt, kan du altid oprette en ny filial og gentage denne proces.

Ercole Palmeri