Denna handledning är en snabbguide för installation och användning av GitHub. Så här skapar du ett lokalt arkiv, hur man ansluter det här lokala arkivet till Github-fjärrkontrollen (där alla kan se det), hur man gör ändringar och slutligen hur man trycker allt lokalt arkivinnehåll på GitHub, bland andra vanliga uppgifter. .
Innan vi börjar är det viktigt att notera att denna handledning förutsätter en grundläggande förståelse för de termer som används i Git: push, pull, commit, repository, etc. Det kräver också förhandsregistrering i GitHub.
Github-installation
På Debian / Ubuntu och derivat:
sudo apt-get install git
En fedora och derivat:
sudo yum installera git
En Arch och derivat:
sudo pacman -S git
Github första installation
När installationen har slutförts är nästa steg att konfigurera GitHub-användarkonfigurationsinformation. För att göra detta använder du följande kommandon och ersätter "användarnamn" med ditt GitHub-användarnamn och "email_id" med e-postadressen som används för att skapa GitHub-kontot.
git config --global user.name "användarnamn" git config --global user.email "email_id"
Skapa ett lokalt arkiv
Det första är att skapa en mapp på din dator, som fungerar som ett lokalt arkiv. För att göra detta, kör bara följande kommando:
git init Mytest
Detta kommando skapar MyTest-mappen. I sin tur gör undermappen .init MyTest igenkänd som ett lokalt Git-arkiv.
Om arkivet har skapats framgångsrikt visas en rad som liknar följande:
Initierat tomt Git-arkiv i /home/tu_usuario/Mytest/.git/
Sedan måste du gå till MyTest-mappen:
cd Mytest
Skapa en README-fil för att beskriva förvaret
README-filen används vanligtvis för att beskriva vad förvaret innehåller eller vad projektet handlar om. För att skapa en, kör bara:
gedit README
När du har angett förvarets beskrivning, glöm inte att spara dina ändringar.
Lägga till förvarets filer i ett index
Detta är ett viktigt steg. Innan du kan ladda upp dina ändringar till Github eller en annan Git-kompatibel server måste du indexera alla filer som finns i det lokala arkivet. Detta index kommer att innehålla de nya filerna samt ändringar av de befintliga filerna i det lokala arkivet.
I vårt fall innehåller vårt lokala arkiv redan en ny fil: README. Därför ska vi skapa en annan fil med ett enkelt C-program och som vi kommer att kalla exempel.c. Dess innehåll kommer att vara:
#include int main () {printf ("hej världen"); returnera 0; }
Så nu har vi två filer i vårt lokala arkiv: README och exempel.c.
Nästa steg är att lägga till dessa filer i indexet:
git add README git add smaple. c
Kommandot "git add" kan användas för att lägga till valfritt antal filer och mappar till indexet. För att lägga till alla ändringar, utan att ange namnet på filerna, är det möjligt att utföra "git add." (med en period i slutet).
Spara ändringar som gjorts i indexet
När alla filer har lagts till är det möjligt att lämna ett register över dessa ändringar genom att göra det i jargongen som kallas "commit". Det innebär att lägga till eller modifiera filer är färdiga och ändringarna kan laddas upp till fjärranslutet Github. För att göra detta måste du utföra följande kommando:
git commit -m "meddelande"
"Meddelande" kan vara vilket meddelande som helst som beskriver de aktuella ändringarna, till exempel: "Jag har lagt till sådan funktionalitet" eller "Jag har korrigerat sådant", och så vidare.
Skapa ett arkiv på GitHub
Förvarets namn måste vara detsamma som förvaret i det lokala systemet. I det här fallet blir det "MyTest". För att göra detta måste du först och främst logga in på Github. Klicka sedan på plustecknet (+) i sidans övre högra hörn och välj alternativet "skapa nytt arkiv". Slutligen måste du fylla i uppgifterna och klicka på knappen "Skapa förvar".
När detta är gjort skapas förvaret och det är möjligt att ladda upp innehållet i det lokala förvaret till GitHub-förvaret. För att ansluta till fjärrförvaret på GitHub måste du köra kommandot:
git remote lägg till ursprung https://github.com/user_name/Mytest.git
Push filer från lokalt arkiv till GitHub-arkiv
Det sista steget är att skicka innehållet i den lokala förvaret till fjärrförvaret med kommandot:
git push origin master
Det återstår bara att ange inloggningsuppgifterna (användarnamn och lösenord).
Detta laddar upp allt innehåll i MyTest-mappen (lokalt arkiv) till GitHub (externt arkiv). För efterföljande projekt behöver du inte längre följa dessa steg från grunden. Istället kan du börja från steg 3 direkt. Slutligen glöm inte att ändringarna kommer att vara tillgängliga från Github-webbplatsen.
Skapa en gren
När utvecklare vill fixa fel eller lägga till nya funktioner skapar de ofta en filial eller kopia av koden så att de kan begå separat, utan att det påverkar det ursprungliga projektet. Sedan när de är färdiga kan de slå samman den här grenen tillbaka till huvudgrenen (master).
För att skapa en ny filial finns det två alternativ:
Långt alternativ:
git branch mirama # skapa en ny gren som heter mirama git checkout mirama - byt till att använda mirama branch.
Kort alternativ:
git checkout -b mirama - skapa och byt till att använda mirama-grenen
När ändringarna har gjorts lägger du till dem i filialindexet och gör motsvarande åtagande:
git add. git commit -m "ändringar till mirama"
Sedan måste du gå tillbaka till huvudgrenen och ta de förändringar som gjorts i mirama:
git kassan master git merge mirama
Slutligen måste du ta bort mirama (eftersom ändringarna införlivades i master):
git gren -d mirama
Och ladda upp master till Github:
git push origin master
Skapa ett härledt Git-arkiv (gaffel)
Tack vare Git och förekomsten av stora offentliga arkivbibliotek, som Github, är det oftast inte nödvändigt att börja programmera vårt projekt från grunden. I dessa fall är det möjligt att ta denna baskod för att skapa ett nytt projekt.
För att göra detta är det första att göra en gaffel i ett befintligt förvar, det vill säga ett projekt som härrör från det baserat på koden för det ursprungliga projektet. På Github uppnås detta genom att klicka på motsvarande knapp, som visas på skärmdumpen nedan.
Vad vi måste göra är att klona förvaret för det nya projektet på vår dator. Som ett exempel kan vi använda mitt Ankifox-arkiv, ett tillägg för Firefox som gör det möjligt att lägga till ord till Anki, som finns på Github:
git-klon https://github.com/usemoslinux/Ankifox.git
Glöm inte att ersätta https://github.com/usemoslinux/Ankifox.git med den URL som motsvarar ditt projekt. Att få den här adressen är väldigt lätt, vilket framgår av bilden nedan.
Detta kommando skapar en katalog som heter «Ankifox», den initialiserar .git-katalogen i den och den laddar ner all data från det förvaret för att arbeta med den senaste versionen.