Share
Een project is altijd leuker als je vrienden hebt die met je samenwerken, maar hoe kan het wanneer je aan een codeerproject werkt? Ik zal mijn toetsenbord voor mezelf houden, bedankt.
Ga naar GitHub. Met deze webservice kunt u uw coderingsprojecten delen en gemakkelijk samenwerken!
Deze tutorial gaat ervan uit dat je bekend bent met Git, misschien wel de beste gedistribueerde versiebeheersoftware die er is. Al verloren? Maak je geen zorgen: lees mijn inleiding tot Git om aan de slag te gaan. Kom dan hier terug en kom alles te weten over GitHub, het sociale netwerk voor ontwikkelaars!
Je hebt natuurlijk een GitHub-account nodig als je de sociale goedheid wilt ervaren. Laten we dat nu doen. Ga naar de GitHub-website en klik bovenaan op 'Prijzen en aanmelden'.
Er zijn verschillende plannen die u kunt gebruiken, afhankelijk van uw behoeften. Op dit moment is het gratis "open source" -account alles wat we willen; dus laten we op 'Aanmelden' klikken. Het is uw standaard aanmeldingspagina; vul uw naam, e-mailadres en wachtwoord in. Je hebt ook een publieke SSH-sleutel nodig; Ik heb uitgelegd hoe je er een kunt krijgen in mijn vorige artikel:
Open je terminal en typ dit:
ssh-keygen -t rsa -C "[email protected]". De t-optie wijst een type toe en de optie C voegt een opmerking toe, traditioneel uw e-mailadres. U wordt vervolgens gevraagd waar u de sleutel wilt opslaan; gewoon raken enter zal doen (dat bewaart het bestand naar de standaardlocatie). Voer vervolgens twee keer een wachtwoord in. Nu heb je een sleutel; laten we het aan GitHub geven.Haal eerst uw sleutel uit het bestand; de terminal heeft u verteld waar de sleutel werd opgeslagen; open het bestand, kopieer de sleutel (let op dat je geen nieuwe regels of witruimte toevoegt).
Zodra u de sleutel hebt, plakt u deze in het juiste veld. Zoals het zegt, hoef je dit nu niet te doen; je kunt later een sleutel toevoegen. Klik vervolgens op de knop om akkoord te gaan en u aan te melden.
Wanneer u zich voor het eerst aanmeldt, ziet u het dashboard; het is zoiets als dit:
In de rechterbovenhoek ziet u een werkbalk met opties voor het beheren van uw account. Er zijn ook enkele links voor het vinden van GitHub, evenals het zoekvak.
Het hoofdpaneel biedt een aantal acties; later zal het worden gebruikt om u op de hoogte te houden van projecten waarin u geïnteresseerd bent. En aan de rechterkant worden uw eigen repositories vermeld. Onthoud dat in Git, repository's de containers zijn die alle code en geschiedenis bevatten die gerelateerd zijn aan één project.
Als je de kans hebt, blader dan door de Accountinstellingen, het is alles wat je zou verwachten, dus ik zal er niet overheen gaan; maar als je van plan bent een fervent githubber te zijn, moet je waarschijnlijk je profiel invullen en zien wat er nog meer in zit.
Echt, het hele doel van GitHub maakt Git-archieven beschikbaar voor de wereld; daarom is het werken met repositories (of repos, zoals ze vaak worden genoemd) iets waar je comfortabel mee zou moeten zijn.
Het creëren van een repository is vrij eenvoudig. Klik op het dashboard op "Nieuwe repository" bovenaan uw repolijst (die momenteel leeg is).
Hier wachten drie tekstvakken op u; uw repository heeft een projectnaam, een beschrijving en de URL voor de projectwebsite nodig. Als u een upgrade hebt uitgevoerd naar een van de betaalde abonnementen, kunt u kiezen of dit openbaar moet zijn of niet. Als je klaar bent, klik je op 'Repository maken'.
GitHub geeft je nu instructies om de GitHub-repository aan te sluiten op een van je lokale Git-repository. Als je bekend bent met Git, zou dit voor jou behoorlijk oud moeten zijn. Het belangrijkste deel zijn de laatste twee regels van ofwel de "Next Steps" of de "Existing Git Repo?"
git remote add origin [email protected]: aburgess / My-First-GitHub-Repo.git duw de oorsprong meester
Met het commando git-remote kun je andere repositories volgen en ze "gesynchroniseerd" houden met je lokale. In ons geval volgen we de repository op GitHub vanuit onze lokale repository. Dus die eerste regel voegt een afstandsbediening toe; we noemen het "oorsprong" en geven het een URL. Dit is een privé-URL die alleen u kunt gebruiken om uw GitHub-repo te lezen en naar uw GitHub-repo te schrijven.
In de tweede regel gebruiken we de opdracht git-push om alles in de hoofdtak naar de bron te verzenden (onze GitHub-repository). Merk op dat geen enkele codering of project werk (het creëren van bestanden, enz.) Wordt gedaan op GitHub. Dat is allemaal lokaal werk; je zou aan je project moeten werken, net zoals je een gewone vanille lokale repo zou doen. Je pusht het echter regelmatig naar GitHub met die tweede regel.
Dus laten we zeggen dat je al een tijdje aan een project werkt en je hebt je commits naar een GitHub-repo gepusht. Welke projectmetagegevens kunnen we op GitHub verkennen? Laten we naar de jQuery-repository kijken.
Zie je die werkbalk aan de bovenkant, net onder de projectnaam? Met deze opties kunnen we een paar Git-gegevens bekijken die we de laatste keer op de opdrachtregel hebben gevonden. Op dit moment staan we op het brontabblad. Het begint met drop-downs voor de repotakken en tags; gebruik deze om de verschillende takken of tags te bekijken. Er zijn ook project meta-data; we hebben de projectnaam, URL en klonerings-URL's (deze URL's zijn alleen-lezen).
Vervolgens kunt u de informatie over de laatste commit zien: auteur, tijd, opmerking en hashes. Daaronder hebt u een bestandsbrowser waarin u de nieuwste versies van alle bestanden in het project ziet, evenals hun leeftijd en de boodschap van de laatste commit waarin ze werden gewijzigd.
Als het project een leesmij-bestand heeft, wordt het weergegeven onder de bestandsbrowser.
Laten we naar het tabblad commits bovenaan gaan en kijken wat het bevat.
Zoals je zou verwachten, kunnen we een achterstand van commits in dit project bekijken. Als u op de commit-hash klikt (aan de rechterkant van het commit-item), kunt u zien wat er in de commit is gewijzigd.
Groene lijnen (toegevoegd met een '+') zijn toevoegingen en rode lijnen (toegevoegd met een '-') zijn verwijderingen.
U kunt zich abonneren op de RSS-feed van de commit-geschiedenis van een willekeurige repo als u deze wilt bijhouden.
Het volgende tabblad is het netwerktabblad; dit toont u een grafische weergave van de geschiedenis van de repository. Deze grafiek is getekend vanuit het perspectief van de committer 'jQuery'. Elke commit verschijnt maar één keer, dus commits die niet op de regel van jQuery staan, staan niet in de repo van jQuery. Op deze manier kunnen we zien welke commits andere mensen hebben gemaakt die we niet hebben. Het is ongelooflijk handig, maar enigszins verwarrend als je niet helemaal wilt grokking. Als je meer wilt weten, bekijk dan de blogpost van GitHub erover.
Het netwerktabblad biedt ook een lijst met leden (mensen die de repo hebben gevorkt) en een feed ook.
Het tabblad Grafieken biedt u een aantal verschillende weergaven van uw project vanuit een grafisch perspectief. Het zijn eigenlijk alleen metagegevens, maar het kan enkele interessante inzichten bieden:
Als u een repository bekijkt waarvan u de eigenaar bent, ziet u een ander tabblad, Fork Queue. Hiermee wordt dezelfde informatie weergegeven die u in de netwerkgrafiek hebt gezien, maar anders. Hier kunt u kiezen welke commits u wilt toepassen op uw repository, op welke branch u ook wilt. Kijk voor meer informatie over de vorkrij op deze post en video op het GitHub-blog.
U kunt drie andere tabbladen in het repo-beheerderspaneel inschakelen: Wiki, problemen en downloads. Hiermee kun je een wiki maken, bugs in je project volgen en downloadbare exemplaren van je repo aanbieden. Ze zijn allemaal behoorlijk intuïtief.
Zoals de slogan aangeeft, gaat GitHub helemaal over sociale codering. Hoewel we er al een paar hebben gezien, is het tijd om de rest van de sociale functies van GitHub te bekijken.
Als je ooit wat vrije tijd hebt en een tijdje in een codeerproject wilt graven, is GitHub de ideale plaats om naartoe te gaan. Laten we eens kijken hoe we interessante projecten kunnen vinden.
Begin door te klikken op de "Explore GitHub" rechts van het zoekvak. We hebben een paar tabbladen om uit te kiezen:
Voor mij is het meest geïnteresseerd in het tabblad talen; kies uw taal en bekijk de meest bekeken en meest gevorkte projecten voor die taal.
Dus laten we zeggen dat je een project hebt gevonden waarin je bent geïnteresseerd; wat nu?
Bij het bekijken van een repository bevinden de sociale hulpmiddelen zich onder de zoekbalk. Aan de rechterkant kunt u zien hoeveel mensen het project hebben gevorkt en hoeveel mensen het bekijken. We hebben het gehad over forking en kijken, maar het is tijd om een paar formele definities op tafel te leggen.
Ik neem een konijnenpad, maar je kunt meer doen dan projecten bekijken; als je bijzonder getalenteerde ontwikkelaars vindt, kun je ze volgen om elke toetsaanslag bij te houden. Klik gewoon op de knop Volgen op hun profielpagina.
U kunt ook een bericht sturen als u dat wilt. Nu praten we over een sociaal netwerk!
Terug op de sociale werkbalk kunt u met de volgende knop (naar links) voorspelbaar de broncode van het project downloaden. Met de volgende knop kun je de repo splitsen, en laat je de laatste kijken (je zag het aankomen).
Als u naar een eigen repository kijkt, zijn er twee andere knoppen in de rij: 'Pull Request' en 'Admin'. We komen zo dadelijk terug bij 'Pull Request'; voel je vrij om rond te kijken in het admin-paneel.
Het zou duidelijk moeten zijn dat de meeste basisfuncties zijn:
Als u klaar bent, klikt u bovenaan op uw projectnaam om terug te keren naar de bronweergave.
Ons scenario voordat u de sociale tools introduceerde, was dat u een repo had gevonden waaraan u wilt werken. Het eerste ding om te doen is het project vork; klik gewoon op de knop 'vork'. Nu heb je een kopie van de repo in je account. Laten we de repo op je computer klonen, met behulp van je privé-kloon-URL. Als u dit doet, wordt automatisch een externe gebelde oorsprong ingesteld, zoals we eerder hebben besproken. Die oorsprong is niet het oorspronkelijke project dat je hebt gevorkt (je kunt daar niet naar schrijven), maar je gevorkte kopie ervan. U moet echter wel een afstandsbediening voor het oorspronkelijke project instellen; doe dat met dit commando:
git remote add upstream [de openbare kloon URL van origineel project hier] git fetch upstream
Die laatste regel haalt de nieuwste takken van de upstream-afstandsbediening en slaat ze op in tracking-takken.
Dit is het moment om te beginnen met coderen. Terwijl je commits maakt, verschijnen ze in de netwerkgrafiek van het originele project, omdat ze niet in die repo staan. Ze verschijnen ook in de vorkrij van die repo, zodat de eigenaar ze kan binnenhalen als hij ze leuk vindt. U kunt echter verzoeken dat ze worden ingetrokken. Daarvoor is de pull-request-knop bedoeld: u kunt de eigenaar van de originele repo een bericht sturen.
Het is niets speciaals; echt, het laat hen gewoon weten dat ze hun vorkrij moeten bekijken.
Maar wat als ze wijzigingen in het project hebben aangebracht sinds je het hebt gesplitst? Het is het beste om hun wijzigingen in uw repo te integreren voordat u ze vraagt om uw wijzigingen aan te brengen. Je kunt hun updates eenvoudig downloaden met die upstream-afstandsbediening die je hebt gemaakt! Voer gewoon deze opdracht uit:
git fetch upstream master git merge upstream / master
Zoals we zojuist zagen, haalt de fetch-opdracht de nieuwste inhoud van de opgegeven afstandsbediening, in dit geval onze upstream-afstandsbediening. We geven ook aan dat we alleen de hoofdtak willen. De tweede regel voegt de opgegeven vertakking samen met de tak waar we aan toe zijn. We zitten in de mastertak van onze lokale repo en we willen onze tracking branch upstream / master samenvoegen.
Opmerking: als u door deze vertakking van de trackingtak in de war bent, bekijkt u dit artikel op gitready.com. In feite zijn tracking-takken eenvoudig vertakkingen die bijhouden waar andere repo's met hetzelfde project zich verhouden tot uw repo. Om al uw takken te zien, voert u de opdracht uit git branch -a. Dit is wat ik krijg voor een gevorkte repo:
Als je lui bent, kun je het commando uitvoeren git trek stroomopwaartse meester. Dit doet zowel de ophaal- als de samenvoegopdrachten tegelijk. Dit kan echter problemen bij het samenvoegen veroorzaken, dus blijf er vanaf!
Zodra je de wijzigingen hebt samengevoegd, kun je met een gerust hart een pull aanvragen, in de wetenschap dat je fork up-to-date is met de upstream-repository.
Github geeft je een vrij uniek vermogen om een persoonlijke website te maken vanuit een GitHub-repository. Mijn GitHub-gebruikersnaam is andrew8088, dus als ik een repo met de naam andrew8088.github.com heb gemaakt, wordt deze gepubliceerd op http://andrew8088.github.com. Simpel als dat!
U kunt ook een site voor een project maken; dit is een beetje ingewikkelder, maar GitHub maakt het gemakkelijk om een generieke, één pagina te krijgen die je project uitlegt. Klik op die beheerdersknop in je sociale werkbalk. Klik vervolgens op 'Uw projectpagina genereren' onder 'Repositorygegevens'.
Vul dan gewoon alle velden in:
En klik op 'Pagina maken'.
Als u uw pagina verder wilt aanpassen of pagina's wilt toevoegen, kunt u de geavanceerde instructies volgen in de Help van GitHub Pages.
Heeft u ooit online een code met een vriend gesproken en een fragment willen delen? Het overkomt ons allemaal, en GitHub biedt een snelle manier om het te doen. Het is Gist. Ze zeggen het het beste:
Gist is een eenvoudige manier om fragmenten en pasta's met anderen te delen. Alle gists zijn git-archieven, dus ze zijn automatisch versieged, vertikbaar en bruikbaar als een git repository.
Klik op de link Gist links van het zoekvak of ga naar Gist.GitHub.com. Je kunt gewoon je fragment plakken of typen. Geef het een bestandsnaam en laat hen weten in welke taal je schrijft (voor syntax highlighting). Klik vervolgens op 'Openbaar maken creëren'. Kopieer de URL en deel!
Elk sociaal netwerk kan verslavend worden en GitHub is niet anders. Als je je repo's onderweg wilt volgen, bekijk dan iOctocat, de GitHub-app voor iPhone en iPod Touch.
Nou, het was een wervelende tour, maar ik hoop dat je je meer vertrouwd voelt met wat de beste site voor het hosten en delen van code op internet zou kunnen zijn! Ooit GitHub gebruikt? Heb je een betere optie? Klik op de opmerkingen!
Wist je dat je tot $ 600 kunt verdienen voor het schrijven van een PLUS tutorial en / of screencast voor ons?? We zijn op zoek naar diepgaande en goed geschreven tutorials over HTML, CSS, PHP en JavaScript. Als je van het vermogen bent, neem dan contact op met Jeffrey via [email protected].
Houd er rekening mee dat de daadwerkelijke compensatie afhankelijk is van de kwaliteit van de laatste zelfstudie en screencast.
Accentsconagua