Hurtigguide for bruk av Github

Denne opplæringen er en rask guide til installering og bruk av GitHub. Slik oppretter du et lokalt depot, hvordan du kobler dette lokale depotet til det eksterne Github-depotet (hvor alle kan se det), hvordan du kan foreta endringer, og til slutt hvordan du skyver alt lokalt depotinnhold på GitHub, blant andre vanlige oppgaver. .

Før du starter, er det viktig å merke seg at denne opplæringen forutsetter en grunnleggende forståelse av begrepene som brukes i Git: push, pull, commit, repository, etc. Det krever også forhåndsregistrering kl GitHub.

Installasjon av Github

På Debian / Ubuntu og derivater:

sudo apt-get install git

En Fedora og derivater:

sudo yum installer git

En Arch og derivater:

sudo pacman -S git

Github første oppsett

Når installasjonen er fullført, er neste trinn å konfigurere GitHub-brukerkonfigurasjonsdetaljene. For å gjøre dette, bruk følgende kommandoer, og erstatt "brukernavn" med GitHub-brukernavnet ditt og "email_id" med e-postadressen som ble brukt til å opprette GitHub-kontoen.

git config - global bruker.navn "brukernavn" git config - global user.email "email_id"

Opprett et lokalt depot

Det første er å lage en mappe på datamaskinen din, som vil fungere som et lokalt lager. For å gjøre dette, bare kjør følgende kommando:

git init Mytest

Denne kommandoen oppretter MyTest-mappen. I sin tur gjør .init-undermappen MyTest anerkjent som et lokalt Git-depot.

Hvis depotet er opprettet, vises en linje som ligner på følgende:

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

Deretter må du gå til MyTest-mappen:

cd Mytest

Lag en README-fil for å beskrive depotet

README-filen brukes vanligvis til å beskrive hva depotet inneholder eller hva prosjektet handler om. For å lage en, er det bare å løpe:

gedit README

Når du har angitt depotbeskrivelsen, ikke glem å lagre endringene.

Legge til depotfilene i en indeks

Dette er et viktig skritt. Før du kan laste opp endringene til Github eller en annen Git-kompatibel server, må du indeksere alle filene i det lokale depotet. Denne indeksen inneholder de nye filene, samt endringer i eksisterende filer i det lokale arkivet.

I vårt tilfelle inneholder vårt lokale depot allerede en ny fil: README. Derfor skal vi lage en annen fil med et enkelt C-program og som vi vil kalle eksempel.c. Innholdet vil være:

#include int main () {printf ("hallo verden"); retur 0; }

Så nå har vi to filer i vårt lokale arkiv: README og example.c.

Neste trinn er å legge til disse filene i indeksen:

git add README git add smaple. c

Kommandoen "git add" kan brukes til å legge til et hvilket som helst antall filer og mapper i indeksen. For å legge til alle endringene, uten å spesifisere navnet på filene, er det mulig å utføre "git add." (med en periode på slutten).

Lagre endringer som er gjort i indeksen

Når alle filene er lagt til, er det mulig å legge igjen en oversikt over disse endringene ved å gjøre det i sjargongen som kalles en "commit". Dette betyr at å legge til eller endre filer er fullført, og endringene kan lastes opp til det eksterne Github-depotet. For å gjøre dette må du utføre følgende kommando:

git commit -m "melding"

"Melding" kan være en hvilken som helst melding som kort beskriver de aktuelle endringene, for eksempel: "Jeg har lagt til en slik funksjonalitet" eller "Jeg har korrigert en slik ting", og så videre.

Opprett et lager på GitHub

Datalagernavnet må være det samme som depotet på det lokale systemet. I dette tilfellet vil det være "MyTest". For å gjøre dette må du først og fremst logge deg på Github. Klikk deretter på plusstegnet (+) øverst til høyre på siden og velg alternativet "opprett nytt lager". Til slutt må du fylle ut dataene og klikke på knappen "Opprett lager".

Når dette er gjort, vil lageret opprettes, og det vil være mulig å laste opp innholdet i det lokale depotet til GitHub-depotet. For å koble til det eksterne depotet på GitHub må du kjøre kommandoen:

git remote legg til opprinnelse https://github.com/user_name/Mytest.git

Push filer fra lokalt depot til GitHub repository

Det siste trinnet er å skyve innholdet i det lokale depotet til det eksterne depotet ved hjelp av kommandoen:

git push origin master

Det gjenstår bare å legge inn påloggingsinformasjonen (brukernavn og passord).

Dette vil laste opp alt innholdet i MyTest-mappen (lokalt depot) til GitHub (eksternt arkiv). For påfølgende prosjekter trenger du ikke lenger å følge disse trinnene fra bunnen av. I stedet kan du starte fra trinn 3 direkte. Til slutt, ikke glem at endringene vil være tilgjengelige fra Github-nettstedet.

Opprette en gren

Når utviklere ønsker å fikse feil eller legge til nye funksjoner, lager de ofte en filial eller kopi av koden slik at de kan forplikte seg separat, uten å påvirke det opprinnelige prosjektet. Så når de er ferdige, kan de slå sammen denne grenen tilbake til hovedgrenen (master).

For å opprette en ny gren er det to alternativer:

Langt alternativ:

git branch mirama # opprett en ny gren som heter mirama git checkout mirama - bytt til bruk av mirama-grenen.

Kort alternativ:

git checkout -b mirama - opprett og bytt til bruk av mirama-grenen

Når endringene er gjort, legg dem til i grenindeksen og foreta tilsvarende forpliktelse:

git add. git commit -m "endringer i mirama"

Deretter må du gå tilbake til hovedgrenen og ta endringene som er gjort i mirama:

git kassa master git merge mirama

Til slutt må du slette mirama (siden endringene ble innlemmet i master):

git gren -d mirama

Og last opp master til Github:

git push origin master

Opprette et avledet Git-depot (gaffel)

Takket være Git og eksistensen av store offentlige arkivbiblioteker, som Github, er det oftest ikke nødvendig å begynne å programmere prosjektet vårt fra bunnen av. I slike tilfeller er det mulig å ta denne grunnkoden for å lage et nytt prosjekt.

For å gjøre dette er den første tingen å gjøre en gaffel i et eksisterende depot, det vil si et prosjekt avledet fra det som tar koden til det opprinnelige prosjektet som base. På Github oppnås dette ved å klikke på den tilsvarende knappen, som vist på skjermbildet nedenfor.

Så, hva vi må gjøre er å klone depotet til dette nye prosjektet på datamaskinen vår. Som et eksempel kan vi bruke Ankifox-depotet mitt, en utvidelse for Firefox som gjør det mulig å legge ord til Anki, som er tilgjengelig på Github:

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

Ikke glem å erstatte https://github.com/usemoslinux/Ankifox.git med URL-en som tilsvarer prosjektet ditt. Å få denne adressen er veldig enkelt, som vist på bildet nedenfor.

Denne kommandoen vil opprette en katalog kalt «Ankifox», den vil initialisere .git-katalogen i den, og den vil laste ned alle dataene fra datalageret, for å jobbe med den nyeste versjonen.