interessant

Hvordan pokker bruger jeg GitHub?

Kære Goldavelez.com,

Jeg har lært at kode og vil begynde at bruge GitHub til at styre mine projekter. På trods af den indledende lektion, de leverer, forstår jeg stadig ikke, hvordan det fungerer overhovedet. Kan du hjælpe mig?

Med venlig hilsen

Git Hjælp

Kære GH,

GitHub er et godt værktøj, men det er bestemt lidt forvirrende første gang (og muligvis et par gange efter det). Det er sandsynligt, hvorfor GitHub oprettede software (til OS X og Windows) for at gøre processen lidt lettere. Ikke desto mindre er det godt at lære den gammeldags måde, ellers giver dine indstillinger i den forenklede software ikke mening. Lad os starte med at gå gennem det grundlæggende.

Trin 1: Tilmeld dig GitHub

Her kommer den lette del: Lav dig selv en GitHub-konto, der tilmelder dig på forsiden. Når du har udfyldt formularen, logger GitHub dig ind og fører dig til dit tomme nyhedsfeed. Midt på siden ser du bagagerummet (afbildet til højre). Vi vil gennemgå det for at konfigurere din konto og senere oprette din første depot. Klik på "Set Up Git" for at komme i gang.

Trin to: Installer Git

GitHub findes på grund af et versionskontrolprogram kaldet git . Webstedet er baseret på, hvordan git fungerer, og git er temmelig gammelt. Det kører via kommandolinjen og har ingen smarte grafiske brugerflade. Da det er lavet til at administrere kode, der er skrevet, burde dette ikke lyde for skræmmende. (Som tidligere nævnt lavede GitHub naturligvis vidunderlig software, så du kan bruge deres service uden kommandolinjen, men det hjælper dig ikke for meget, medmindre du kender det grundlæggende.)

Git fungerer ved at læse et lokalt kodelager (bare en mappe, der indeholder kode til dit projekt) på din computer og spejle den kode andetsteds (i dette tilfælde GitHubs servere). Oprindeligt vil vi forpligte (dvs. sende) hele dit lokale depot til GitHub, men det er bare en engangsaffære. Når du fortsætter med at arbejde på din kode, foretager du blot ændringer. GitHub vil derefter holde styr på de ændringer, du har foretaget, og skabe forskellige versioner af filer, så du kan vende tilbage til gamle, hvis du vil (eller bare holde styr på disse ændringer af andre årsager). Dette er primært hvorfor du gerne vil bruge et versionskontrolsystem som git på egen hånd, men der opstår yderligere fordele, når du bruger git til at administrere kode med andre, der arbejder på dit projekt. Når flere udviklere begår kode med git, bliver GitHub et centralt arkiv, hvor al den kode, som alle arbejder på, kan forblive synkroniseret. Du begår dine ændringer, og andre udviklere vil trække dem (dvs. synkronisere dem til deres lokale arkiv). Du gør det samme med deres kode.

Git får alt dette til at ske, så du er nødt til at downloade den nyeste version og installere den. På OS X skal du bare installere kommandolinjeappen. På Windows får du et par flere varer. Vi diskuterer, hvordan de fungerer i det næste trin.

Trin tre: Opsæt Git

For at opsætte git skal du gå ind på kommandolinjen. På OS X betyder det, at man starter Terminal-appen (Hard Drive -> Applications -> Utilities -> Terminal), og på Windows betyder det, at du starter den Git Bash-app, du lige har installeret - Windows-kommandoprompten. Når du er klar, så fortæl dit navn:

git config --global user.name "Your Name Here"

For eksempel ville mine se sådan ud, fordi jeg bruger en testkonto til dette eksempel:

git config --global user.name "Adam Dachis"

Du kan indsætte ethvert navn, du kan lide, men bagefter skal du indtaste din e-mail, og den e-mail er den e-mail, du brugte, da du tilmeldte dig GitHub:

git config --global user.email " "

Hvis du uanset årsag tilmeldte dig GitHub med den forkerte e-mail-adresse, skal du ændre den.

For at undgå, at du altid indtaster dine loginoplysninger og genererer SSH-nøgler, skal du installere legitimationshjælperen, så dine adgangskoder cache. Hvis du er på Windows, skal du downloade det og installere det. Hvis du er på OS X, skal du håndtere dette gennem terminalen. For at starte skal du bruge denne kommando til at downloade legitimationshjælper:

curl -s -O \

//github-media-downloads.s3.amazonaws.com/osx/git-credential-osxkeychain

Dette vil downloade en lille fil og bør ikke tage for lang tid. Når du er færdig, skal du indtaste følgende kommando for at sikre dig, at tilladelserne er korrekte i den fil, du lige downloader (og rett dem, hvis ikke):

chmod u+x git-credential-osxkeychain

Nu er det tid til at installere legitimationshjælperen i den samme mappe, hvor du installerer git. For at gøre dette skal du indtaste denne kommando:

sudo mv git-credential-osxkeychain `dirname \`which git\``

Du bliver bedt om din administratoradgangskode, fordi ovennævnte kommando begyndte med sudo. Sudo er kortfattet for "super user do" og er nødvendig, når du udfører en opgave, der kræver rodadgang. Sudo-kommandoen giver dig mulighed for at blive rodbrugeren (en bruger med tilladelse til at gøre stort set noget) på dit operativsystem et øjeblik, så du kan udføre denne opgave. Du bliver bedt om at indtaste din adgangskode for at bevise, at du er administrator på computeren og bør have tilladelse til at gøre dette. Når du har indtastet din adgangskode og legitimationshjælpen er flyttet, skal du afslutte installationen med denne kommando:

git config --global credential.helper osxkeychain

Nu er du klar til at gå videre til faktisk at bruge git og GitHub!

Trin fire: Opret dit første lager

Nu, hvor du har nået det så langt, kan du faktisk bruge GitHub! Som en første forretningsordre opretter vi et lager (eller "repo" kort). Gå videre til GitHub, og klik på knappen "Ny oplagring" øverst til højre på din kontoside. (Bemærk: Hvis du stadig viser GitHub-startcamp-sektionen, vises den under det.)

Når du opretter et lager, har du et par ting at beslutte, herunder navnet og hvorvidt det vil være offentligt tilgængeligt eller ej. Valg af navn skal være temmelig enkelt, fordi du sandsynligvis allerede har et navn til dit projekt. Hvis du bare følger med til læringsformål, skal du bruge "Hello-World." Hvorfor "Hello-World" og ikke "Hello World"? Fordi mellemrum og specialtegn vil forårsage problemer. Hold det enkelt og nemt at indtaste kommandolinjen. Hvis du vil inkludere et mere komplekst navn, kan du tilføje det til det valgfri beskrivelse felt under navnefeltet.

Hvis du opretter et open source-projekt, vil du have et offentligt lager. Hvis du vil kode selv eller kun dele med bestemte personer, gør et privat oplagringssted. Foretag det valg, der fungerer bedst for dig og dit projekt.

Når du er færdig, kan du klikke på knappen "Opret repository", men du vil måske først gøre en anden ting: markér afkrydsningsfeltet "Initialiser dette depot med en README". Hvorfor? Alle lagre kræver en README-fil. Den fil ville ideelt set indeholde lidt information om dit projekt, men du ønsker måske ikke at tackle det lige nu. Ved at initialisere depotet med en README, får du en tom README-fil, som du lige kan håndtere senere. Med henblik på denne tutorial vil vi forlade boksen, fordi vi i det næste afsnit opretter en README-fil fra bunden for at øve dig på at overføre (sende) den til GitHub.

Trin fem: Foretag dit første engagement

Når du sender filer til GitHub, du dem. For at øve vil vi initialisere dit lokale arkiv og oprette en README-fil, der skal bruges som praksis. Inden du starter, skal du vide, hvor dit lokale kodelager er på din computer, og hvordan du får adgang til det via kommandolinjen. I denne selvstudie antager vi, at der er et bibliotek kaldet "Hello-World" i din computers hjemmemappe. Hvis du har brug for at oprette en, skal du bare køre denne kommando (samme for Git Bash på Windows og OS X's terminal):

mkdir ~/Hello-World

Skift nu til det bibliotek ved hjælp af kommandoen cd (skift katalog):

cd ~/Hello-World

I tilfælde af at du undrede dig, repræsenterer ~ dit hjemmekatalog i Git Bash og Terminal. Det er simpelthen kortvarigt, så du ikke behøver at skrive det hele ud (hvilket vil se mere ud som / Brugere / dit brugernavn /). Nu hvor dit arkiv er klar, skal du skrive dette:

git init

Hvis du allerede havde et arkiv klar til at gå, skulle du bare cd til det bibliotek og derefter køre git init kommandoen derinde i stedet. Uanset hvad, er dit lokale arkiv klar til at gå, og du kan begynde at udføre kode. Men vent, du har ikke noget at forpligte dig! Kør denne kommando for at oprette en README-fil:

touch README

Lad os tage en pause et øjeblik og se, hvad der lige er sket. Gå ind i hjemmemappen på din computer og se på Hello-World-mappen (eller se på den mappe, du bruger til et lokalt arkiv). Du vil bemærke en README-fil indeni takket være den kommando, du lige har kørt. Hvad du ikke ser er en .git-mappe, men det er fordi den er usynlig. Git skjuler den derinde, men fordi du kørte git init kommandoen, ved du, at den findes. Hvis du er skeptisk, skal du bare køre ls kommandoen i Git Bash / Terminal for at få vist en liste over alt i det aktuelle bibliotek (som, hvis du følger med, er dit lokale arkiv).

Så hvordan ved git, at vi ønsker at begå denne README-fil, vi lige har oprettet? Det gør det ikke, og du skal fortælle det. Denne kommando vil gøre det trick:

git add README

Hvis du vil tilføje andre filer, der skal bruges, bruger du den samme kommando, men erstatter README med navnet på en anden fil. Kør nu denne kommando for at begå den:

git commit -m 'first commit'

Mens de andre kommandoer var temmelig ligetil, har kommando-kommandoen lidt mere foregår, så lad os nedbryde det. Når du skriver git, fortæller det bare kommandolinjen, at du vil bruge git-programmet. Når du skriver commit, fortæller du git, at du vil bruge kommandoen commit. Alt, der følger disse to ting, tæller som muligheder. Den første, er, hvad der er kendt som et flag. Et flag specificerer, at du vil gøre noget specielt i stedet for bare at køre commit-kommandoen. I dette tilfælde betyder -m-flaget "besked", og det, der følger efter, er din engagementsmeddelelse (i eksemplet 'første begivenhed'). Meddelelsen er ikke absolut nødvendig (selvom du normalt har brug for at angive en), men blot en henvisning til at hjælpe dig med at differentiere de forskellige versioner af en fil (eller filer), du forpligter til dit arkiv.

Dit første engagement skulle gå forbi et par sekunder, fordi du ikke har uploadet noget endnu. For at få denne tomme README-fil til GitHub, skal du skubbe den til med et par kommandoer. Her er den første:

git remote add origin //github.com/yourusername/Hello-World.git

Du skal erstatte "dit brugernavn" med - du gætte det - dit GitHub-brugernavn. For mig ser det sådan ud:

git remote add origin //github.com/gittest1040/Hello-World.git

Denne kommando fortæller, hvor du skal sende dit Hello-World-arkiv. Nu skal du bare sende det:

git push origin master

Når du kører denne kommando, vil alting (i dette tilfælde bare din README-fil) gøre det over til GitHub. Tillykke med dit første engagement!

Lær mere

Brug af GitHub kræver mere end blot at udføre en README-fil, men disse grundlæggende ting skal give dig et godt greb om, hvordan du interagerer med GIT-appen og tjenesten. Nu hvor du ved, hvordan GitHub fungerer som dets kerne, kan du bruge GitHub-apps til at administrere din kode i stedet, hvis du foretrækker det. Hvis du vil lære mere om GitHub, er der nogle gode tutorials. For det første skal du se, hvordan man gaffler et lager og LockerGnome's GitHub-guide.

Hav det sjovt at administrere din kode!

Kærlighed,

Goldavelez.com