Teilen Sie Ihr Open Source-Projekt über GitHub

Dieser Artikel erschien zuerst in Ausgabe 216 of .net magazine - das weltweit meistverkaufte Magazin für Webdesigner und Entwickler.

Wenn viele Leute Git hören, denken sie an GitHub. GitHub ist der beliebte Online-Git-Hosting-Service, der die Kraft sozialer Netzwerke in die Open-Source-Coding-Community gebracht hat. Und da immer mehr Projekte auf Git umsteigen und immer mehr Unternehmen und einzelne Entwickler dorthin ziehen, um ihre Open- und Closed-Source-Projekte zu hosten, wird es immer wichtiger zu wissen, wie man an dieser Community teilnimmt.

GitHub hat über 650.000 Entwickler auf der Website registriert, die mehr als 500.000 einzigartige Open Source-Projekte und 1,8 Millionen Repositories hosten. Unternehmen wie Twitter, Facebook, Yahoo und Rackspace nutzen GitHub, um ihre Open-Source-Projekte zu teilen und Beiträge von der größeren Open-Source-Community zu erhalten. Viele weitere Unternehmen verwenden GitHub, um ihre Code-Hosting-Anforderungen auszulagern oder Entwickler zu finden, die eingestellt werden können. Wenn Sie die Website kennenlernen, erhalten Sie möglicherweise Ihren nächsten Job oder was Sie verwenden, wenn Sie dort ankommen.



Letzte Woche haben wir das Git Version Control Tool eingeführt und heute schauen wir uns die Verwendung von GitHub an. Wir werden sehen, wie Sie ein Konto erstellen, ein vorhandenes Projekt zu Git hinzufügen und es an GitHub senden, um es für die breitere Community freizugeben. Schließlich lernen wir, wie Sie zu einem Open Source-Projekt eines anderen auf GitHub beitragen können. Am Ende dieses Tutorials sollten Sie sich beim Open-Sourcing neuer Projekte auf GitHub wohl fühlen und zu bestehenden Projekten beitragen, die Sie auf GitHub entdecken.

1. Laden Sie Tower herunter

Wenn Sie Git noch nicht verwenden, können Sie den kostenlosen Befehlszeilen-Client unter herunterladen git-scm.com , oder Sie können eine der GUIs erhalten. Hier verwenden wir Tower, einen kommerziellen Mac-GUI-Client mit einer 30-Tage-Testversion, die Sie herunterladen können git-tower.com .

2. Importieren und Festschreiben von Code

Laden Sie die Dateien von oben herunter. Entpacken Sie die Datei und initialisieren Sie das Verzeichnis als Git-Repository. Klicken Sie im Tower auf Lokales Repository erstellen Wählen Sie dann Ihren Pfad. Sie können dann Ihr erstes Commit ausführen, indem Sie auf klicken Alle inszenieren und dann die Verpflichten Taste.

3. Erstellen Sie ein Konto

Unser erstes Ziel wird es sein, diesen Code auf GitHub zu übertragen, um ihn mit anderen zu teilen. Erstellen Sie dazu ein Konto auf GitHub, falls Sie noch kein Konto haben. Gehe zu GitHub.com/plans und klicken Sie auf Erstelle einen kostenlosen Account Klicken Sie dann auf die Schaltfläche und füllen Sie das einfache Formular aus.

4. Erstellen Sie ein neues Repository

Um Ihr Projekt zu teilen, müssen wir ein Repository auf GitHub erstellen. Sie sollten eine Schaltfläche mit dem Titel sehen Neues Repository auf dem Dashboard, auf dem Sie landen, nachdem Sie ein Konto erstellt haben. Klicken Sie darauf und geben Sie im nächsten Formular einen Projektnamen ein, um Ihr neues Repository zu erstellen.

5. Fügen Sie GitHub als Remote-Repo hinzu

Wählen Sie im Tower die Option Refs> Neues Remote-Repository hinzufügen und fügen Sie die auf der Projektseite gefundene HTML-URL in das URL-Feld des angezeigten Formulars ein. Geben Sie dann Ihr GitHub-Passwort ein und klicken Sie auf OK .

xp-pen artist 15.6 Stiftanzeige

6. Schieben Sie Ihren Code an GitHub

Klicken Sie in Tower mit der rechten Maustaste auf den Hauptzweig in der Seitenleiste und wählen Sie Zweig veröffentlichen . Dadurch wird Ihre Arbeit an GitHub weitergeleitet, sodass Sie auf Ihrer Projektseite Ihre veröffentlichten Arbeiten anzeigen können. Von nun an können Sie einfach klicken drücken um weitere Updates zu teilen.

7. Forken Sie ein Repository

Wir haben Code geteilt, daher sollten wir jetzt zu einem Projekt beitragen. Der erste Schritt zur Arbeit an einem Projekt in GitHub besteht darin, es zu verzweigen, dh eine eigene beschreibbare Kopie zu erhalten. Gehe zu GitHub.com/schacon/example und klicken Sie auf Gabel Taste, um dies zu erreichen.

8. Klonen Sie dieses Repository

Um dieses Projekt zu verbessern, benötigen wir eine lokale Kopie zum Bearbeiten. Wählen Sie die HTTP-URL auf der Projektseite aus und weisen Sie Tower an, sie für uns zu klonen. Gehen Sie zur Seite Repositories (Befehl + D) und klicken Sie auf Remote-Repository klonen und fügen Sie die HTTP-URL ein.

9. Nehmen Sie eine Änderung vor

Jetzt möchten wir eine Funktion hinzufügen, daher sollten wir einen Zweig erstellen, in dem die Änderungen vorgenommen werden. Erstellen Sie einen neuen Zweig (Befehl + B) mit dem Namen neue Funktion und schau es dir an. Kopieren Sie dann die beiden Dateien aus dem ursprünglichen Beispielprojekt in dieses gegabelte Repository und übernehmen Sie die neuen Änderungen.

10. Veröffentlichen Sie Ihren Themenzweig

Klicken Sie mit der rechten Maustaste auf neue Funktion Verzweigen Sie in der Seitenleiste und wählen Sie Zweig veröffentlichen um es auf GitHub zu veröffentlichen. Dadurch wird ein neuer Zweig mit dem Namen erstellt neue Funktion auf GitHub, dass der ursprüngliche Autor des Codes, den Sie gegabelt haben, jetzt mit all Ihren neuen Arbeiten sehen kann.

11. Starten Sie eine Pull-Anfrage

Da unsere Arbeit jetzt öffentlich und auf GitHub ist, möchten wir den ursprünglichen Projektautor anweisen, sie in sein Projekt aufzunehmen. Dies wird als Pull-Anfrage bezeichnet. Gehen Sie zur gegabelten Projektseite
und klicken Sie auf Pull-Anfrage Schaltfläche, um das Formular zu öffnen.

wie man einen Stift für Android macht

12. Füllen Sie Ihre Pull-Anfrage aus und überprüfen Sie sie

Geben Sie einen überzeugenden Titel und eine Beschreibung ein, warum Ihre Arbeit aufgenommen werden sollte. In dem Commits Auf der Registerkarte können Sie die Liste der eindeutigen Commits anzeigen, die Sie senden. In dem Dateien geändert Auf der Registerkarte sehen Sie den einheitlichen Unterschied zwischen dem, was Sie senden.

13. Siehe Bildunterschiede

Wenn ein Bild geändert wird, können Sie mit GitHub mehrere Ansichten verwenden, z Seite an Seite , wischen , Zwiebelhaut und Unterschied So können Sie sehen, wie es geändert wurde. Wenn Sie mit der Änderung zufrieden sind, senden Sie die Pull-Anfrage.

14. Kommentar zur geänderten Zeile

Pull-Anforderungen dienen als Codeüberprüfungsprozess, und mit GitHub können Sie sich über die Änderungen unterhalten, bevor sie akzeptiert werden. Gehe zum Dateien geändert Ansicht der gerade gesendeten Anfrage und Kommentar zu einer Codezeile.

15. Pull-Request-Diskussion anzeigen

Sobald Sie einen Kommentar abgegeben haben, können Sie den Kommentar und alle anderen zugehörigen Informationen für die Pull-Anforderung auf der Haupt-Pull-Anforderungsseite anzeigen. Klicke auf das Diskussion Klicken Sie auf die Registerkarte, um zu sehen, wie sich Ihr Kommentar- und Codekontext jetzt in der Hauptdiskussionsliste befindet.

16. Zweigliste anzeigen

Nachdem Sie mehr als einen Zweig in Ihr Projekt verschoben haben, können Sie diese mit dem vergleichen Branchenliste Aussicht. Wenn Sie auf klicken Branchenliste unter dem Quelle Auf der Registerkarte erhalten Sie eine schöne Visualisierung aller Ihrer Filialen und wie viele Commits für jede Branche eindeutig sind.

17. Siehe Vergleichsseite

Wenn Sie an einem der Zweige interessiert sind und sehen möchten, wie dieser mit Ihrem Hauptzweig verglichen wird, klicken Sie auf die Schaltfläche 'Vergleichen' Branchenliste Seite neben diesem Zweig. Dadurch wird eine Ansicht Ihrer geänderten Dateien, ein einheitlicher Diff und eine Liste von Commits angezeigt.

18. Ihre Pull-Anfragen

Um den Status Ihrer gesendeten und ausstehenden Pull-Anfragen für Projekte auf GitHub zu verfolgen, können Sie auf klicken Anfragen ziehen Registerkarte von Ihrem Instrumententafel . Jetzt, da Sie an einem Social-Coding-Netzwerk teilnehmen, ist dies wichtig.

19. Dein Profil

Stellen Sie als aktives und geschultes Mitglied der GitHub-Community sicher, dass Sie ordnungsgemäß vertreten sind. Auf Ihrer Profilseite unter GitHub.com/[username] können Personen sehen, wer Sie sind, und Sie kontaktieren. Stellen Sie sicher, dass Sie einen Avatar unter hochladen Gravatar.com und füllen Sie Ihr Profil aus.

Expertentipp: Die GitHub-Benutzeroberfläche ist sehr schön, aber wenn Sie etwas anderes oder wiederholt tun müssen, hat GitHub auch eine schöne kleine API, mit der Sie mit einem Skript fast alles tun können, was Sie über die Web-Benutzeroberfläche tun können. Besuch Develop.GitHub.com Erfahren Sie mehr darüber, wie Sie eine Ihrer GitHub-Interaktionen skripten, einschließlich vorhandener Bibliotheken, um dies in Java, JavaScript, PHP, Perl, Python, Ruby und anderen zu vereinfachen. Wenn GitHub nicht genau das tut, was Sie wollen, können Sie es möglicherweise nach Ihrem Willen biegen.