Damit viele neue User wissen was Github ist und was Github kann, hier mal eine kurze Beschreibung, FAQ Github (Deutsch)
.pdf Download
Einleitung
Was ist eigentlich git/GitHub
GitHub ist sozusagen eine Web-Anbindung für die Versionsverwaltung "git"
Eine Versionsverwaltung dient dazu, den Verlauf eines Projektes zu protokollieren, indem automatisch alle Änderungen gespeichert werden und gegen die ursprüngliche Version verglichen werden können ("diff")
In der Regel werden solche Versionierungs-Systeme in der Software-Entwicklung angewandt, können aber auch für alle anderen Arten von dynamisch veränderten Projekten gebraucht werden, z.B. Bücher, Fahrpläne, Musik-Kompositionen u.v.m.
Bei Projekten mit mehreren oder gar vielen Entwicklern kann GitHub die Schnittstelle bilden zwischen den einzelnen Beteiligten, die jeweils lokal die Versionen mit git verwalten
Außerdem bietet es eine grafische Oberfläche und viele auf die Teamarbeit bezogene Zusatzfunktionen
Inhaltsverzeichnis
1.Was ist Github
2.Wer kann auf Github arbeiten
3.Wie kann ich ein Project erstellen
4.Wo sehe ich die Änderungen
5.Wie kann ich an einem Project mitarbeiten wenn ich keine Schreibrechte/Berechtigung für diese Github Seite habe
6.Wie kann ich Änderungen (Pull Requests) beim Entwickler einreichen
7.Wie kann ich ein „PullRequest“ annehmen
8.Wie bekomme ich Schreibrechte/Berechtigung, bzw. wie kann ich einem User Rechte erteilen für ein Github Project
9.Wie können Daten hochgeladen werden bzw. neu erstellt werden
10.Wie kann ich eine „Branch“ erstellen
11.Wie lösche ich eine“Branch“
12.Wie kann ich ein Project löschen
13. Github Historie (aufrufen), Wie bekommt man alte Versionen
1.Was ist Github
Github ist eine Entwickler Plattform, auf der viele User gemeinsam an einem Project arbeiten können Hier liegen meistens die Daten von Repositories, Addons usw.
Es können aber alle Arten von Daten hochgeladen werden
Wichtig ist noch zu erwähnen, das Euer Github „öffentlich“ ist, dass heiß jeder kann es sehen
Will man das nicht, so muss man bezahlen
Es gibt für den PC die Anwendung Github Desktop. Damit können die Daten auf dem PC bearbeitet werden und dann hochgeladen werden
Hilfe beim Arbeiten mit Github gibt es hier:
help.github.com/
Eine kurz Einführung in Github findet Ihr hier:
guides.github.com/introduction/flow/
2.Wer kann auf Github arbeiten
Jeder User, der sich auf
www.github.com anmeldet, kann auf /mit Github arbeiten.
Github ist kostenlos („öffentlich“).
Es können eine Vielzahl an Daten hochgeladen werden
Es ist immer ersichtlich, wer die Daten bearbeitet hat und was genau geändert wurde
3.Wie kann ich ein Project erstellen
Dazu auf Deiner Githubseite anmelden
1. In der Menüleiste auf „Repositories“ klicken
2. Dann rechts auf „New“ klicken
3. Nun bei „Repository name“ den Namen Eures Projects eingeben
Public (öffentlich) anklicken oder wenn Ihr bezahlen wollt dann privat
Und unbedingt „Initialize this repository with a README“ anklicken
4. Dann „Create Repository“ klicken und das Project ist angelegt
https://help.github.com/articles/create-a-repo/
4.Wo sehe ich die Änderungen
Besucht eine beliebige Githubseite, z.B.
github.com/kodinerds/
Das „blau“ geschrieben sind die angebotenen Repositories oder Addons
Klickt ihr auf eines drauf, ist der Inhalt dieses Repos/Addons zu sehen
Hier findet ihr nun 3 Spalten:
Links: die Datei Mitte: die Änderungen an der Datei rechts: zuletzt bearbeitet
Mit einem Klick in der mittleren Spalte, seht Ihr die Änderungen
Rot bedeutet gelöscht, Grün bedeutet neu hinzugefügt
5.Wie kann ich an einem Project mitarbeiten wenn ich keine Schreibrechte/Berechtigung für diese Github Seite habe
Da ist eigentlich ganz einfach
Wenn Ihr keine Schreibrechte/Berechtigung für diese Seite habt, so müsst Ihr von dieser Github Seite ein „Fork“ machen
Das ist sozusagen eine 1:1 Kopie, welche in wenigen Sekunden auf Eurer Github Seite erscheint
Um einen „Fork“ zu erzeugen, klickt Ihr einfach rechts oben auf das „Fork“ Symbol
Nun könnt Ihr an dieser Seite (welche sich ja nun auf Eurem Github befindet) Änderungen durchführen und diese dann beim Entwickler einreichen
help.github.com/articles/fork-a-repo/
6.Wie kann ich Änderungen (Pull Requests) beim Entwickler einreichen
Das Einreichen einer Änderung bezeichnet man als „Pull Requests“
Das bedeutet, dass die Änderungen, welche Ihr auf Eurer Github Seite (auf dem „Fork“) gemacht habt, direkt auf der Github Seite des Entwickler erscheint, in der Kategorie „Pull Requests“ (am oberen Rand in Github)
Der Entwickler kann diese „Einreichung“ annehmen oder ablehnen
Nimmt er sie an, so wird diese (meistens) so übernommen wie ihr sie erstellt habt
help.github.com/articles/creat…pull-request-from-a-fork/
7.Wie kann ich ein „PullRequest“ annehmen
Die eingereichten Änderungen eines Users bei Euch, seht Ihr in der Menüleiste „Pull Requests“
Wählt den „Pull“, welchen Ihr bearbeiten bzw. mit Eurem Project „mergen“ (zusammenfügen) wollt
Wenn die eingereichte Branche nicht mit Eurer Branche übereinstimmt (welche zusammen geführt werden sollen), so könnt Ihr das ganz einfach noch anpassen:
Compare changes
Compare changes across branches, commits, tags, and more below
Hier steht darunter:
Base: master Base: master……
Das linke ist die Branche von Euch, wohin der „PullRequest“ eingefügt wird
Das rechte die Branch des anderen Users
Ändert die linke Seite so, wir Ihr es benötigt (master, nightly, beta usw…)
Rechts am Rand steht „Edit“. Nach einem Klick daruf, könnt Ihr Eure Branch anpassen
help.github.com/articles/chang…branch-of-a-pull-request/
Bei „This Branch has no conflicts with the base branch“ könnt Ihr nun auf den grünen Knopf
„Merge Pull Requests“ klicken
Zum Schluss klickt Ihr unten auf „Confirm Merge“
help.github.com/articles/merging-a-pull-request/
8.Wie bekomme ich Schreibrechte/Berechtigung, bzw. wie kann ich einem User Rechte erteilen für ein Github Project
Diese Berechtigung, kann nur der Inhaber der Github Project Seite erteilen
Dazu wir das jeweilige Project ausgewählt, am oberen Rand auf „Settings“
Dann ein Klick auf „Collaboartos“
Jetzt steh auf der rechten Seite: „Search by username, full name or email address“
Hier sucht ihr den User, welchen Ihr Berechtigen wollt
Dieser bekommt dann eine E-Mail mit dem Aktivierungslink. Sobald dieser angenommen wird, hat der User Schreibrechte (nur) für diese eine Project
Bekommt der User die E-Mail nicht, so kann ihm der Github Inhaber den Link auch so geben
Steht unter „Collaborators“, neben dem eben angelegten User: „Copy invite Link“
help.github.com/articles/invit…to-a-personal-repository/
9.Wie können Daten hochgeladen werden bzw. neu erstellt werden
Zum Hochladen wählt ihr ein Project aus und klickt auf „Upload Files“
Die maximale Größe pro Upload hierbei beträgt 25MB
Wollt ihr eine größere Datenmenge hochladen, so benötigt ihr Github Desktop. Damit können maximal 100MB pro Upload hochgeladen werden
help.github.com/articles/adding-a-file-to-a-repository/
Zum Erstellen einer Datei klickt Ihr auf „Create new file“
Auch hier für benötigt Ihr die oben erwähnte Berechtigung (außer es ist Euer Github)
help.github.com/articles/creating-new-files/
10.Wie kann ich eine „Branch“ erstellen
Dazu öffnet Ihr das Project (Repo, Addons usw.)
Dann wählt Ihr das Feld „Branch“
Es öffnet sich nun ein (weißes) Textfeld
In diese Feld könnt Ihr nun den Namen einer neuen Branch eingeben
help.github.com/articles/creat…s-within-your-repository/
11.Wie lösche ich eine“Branch“
Wenn das Project geöffnet ist, findet Ihr eine Menüleiste die folgendes beinhaltet:
commits, branches, releases, contributors, GPL-3.0
Hier wählt ihr „branches“
Wählt die zu löschende Branche und klickt auf den Mistkübel
Die „Master Branche“ ist die default (Standard) Branche. Um diese löschen zu können, muss vorher eine neu default branch festgelegt werden (change default branch)
12.Wie kann ich ein Project löschen
Dazu besucht ihr Eure Github Seite, und wählt das Project welche gelöscht werden soll
Klickt oben auf „Settings“
Ganz nach unten Scrollen und „Delete this Repository“
In dem sich nun öffnenden Fenster muss der genaue Name des zu löschenden Projects eingegeben werden und bestätigen
help.github.com/articles/deleting-a-repository/
13. Github Historie (aufrufen), Wie bekommt man alte Versionen
Von jedem Github Project, kann eine Historie aufgerufen werden. Hier sind auch bereits gelöschte Dateien zu finden
Dazu öffnet man Github und das entsprechende Project
In der Menüleiste findet Ihr: commits, branches, releases, contributors, GPL-3.0
Hier den Menüpunkt „Commits“ anklicken
Auf der nun angezeigten Seite, sieht man, wer/wann welche Änderung gemacht hat
Ganz unten kann man weiter zurückgehen in der Zeit, durch Klick auf „Older“
Über die blauen Felder auf der rechten Seite, kann man zu genau dieser Änderung springen:
<>: Springt zum Repo/Addon und zeigt es so an, wie es mal war. Kann dann auch genauso
heruntergeladen werden
ddf12nhg: beim Klick auf eine Buchstaben/Zahlenkombination, springt man direkt in die geänderte
Datei von damals. Rot bedeutet gelöscht, Grün hinzugefügt
Mit einem Klick auf „Browse files“ kommt man zum Repo/Addon von damals
Eine super genaue Anleitung dazu und wie man nach Dateien suchen kann, findet ihr hier:
Link
Im folgendem hab ich die Anleitung aus obigem Link mal hier eingefügt:
Wie bekommt man alte Versionen?
Vorraussetzung: Repo liegt bei Github
1. Man sucht sich das Datum wann es die Version gab die man haben will, im Fall von Youtv:
[Release] Youtv
Hab ich geschrieben werds am Freitag rausnehmen. Der Freitag war dann der 11 November, als Brauch man was vor diesem Datum
Nun geht man auf die Github Seite des Repos
github.com/kodinerds/repo/
Da gibt es eine Knopf "[ANZAHL] Commits"
Den drückt man
Jetzt sieht man wer was geändert hat........
Unten kann man auf „Older“ drücken
Dann wird in der Browser Adressleiste, eine URL wie folgt angezeigt:
github.com/kodinerds/repo/comm…dddc6fe1e863fd3e97c154+34
Wenn es viele Commits gibt, wird man beim Rückwerts springen Wahnsinnig
Deshalb einfach eine große Zahl statt der 34 Ganz hinten in der URL eingeben
Schauen ob es passt: je älter= größere Nummer, je Neuer=kleinere Nummer
Das macht man solange bis man die richtige Zahl hat in dem Beispiel: 42461
github.com/kodinerds/repo/comm…c6fe1e863fd3e97c154+42461
Der Oberste ist 9.November also liegt es vor dem Datum
Dann die Überschrift anklicken in dem Fall "Autoupdate"
Jetzt Zeigt er die Änderungen (grün/rot) an (Inhalte)
Das ist egal, wir brauchen Links oben den Knopf "Browse Files"
Nun sieht man das Repo von damals
Bein unserem Beispiel
github.com/kodinerds/repo/tree…5671053c6e92c2b241a9ee99f
Nun findet man das addon plugin.video.youtv geht in das Verzeichnis
github.com/kodinerds/repo/tree…9ee99f/plugin.video.youtv
Dort findet man das zipfile, das klickt man an:
github.com/kodinerds/repo/blob…in.video.youtv-0.4.27.zip
Dann auf Download klicken und man hat das Addon ....
