github

"github" ist ein Quellverwaltungssystem auf der Basis von "git". Es ist zur Zeit das beliebteste System um verteilte Entwicklungen für Open Source Software durchzuführen. Für diese Zwecke ist es auch kostenfrei.

Wer sich mit den Quellen einer Open Source Software, wie z.B. CCU.IO, beschäftigt, möchte vielleicht Änderungen und Korrekturen anbringen. Dies funktioniert am einfachsten mit github, weil die meisten Quellen, so auch die von CCU.IO und der CCU.IO Addons, bei github liegen.

Auch um andere Dokumente gemeinsam zu bearbeiten ist git und github die Möglichkeit der Wahl.

Auch Google benutzt git für ihre Open-Source Projekte : https://opensource.google.com/docs/why/

Wer als Einsteiger anderen Mitstreitern den eigenen Code zur Verfügung stellen will, benötigt als wichtigste Kommandos :

[master] > git status # was ist los ?

[master] > git commit . # bringt alle Änderungen seit dem letzten "commit" in die Code Basis

# git commit -m "Add cute octocat story" vermeidet den Editor Aufruf

[master] > git push # schiebt die Änderungen auf die Webseite von github

Obiges gilt, wenn man sich die Git-Windows Version (Ab Windows 7) von github auf seinen Rechner geladen hat. Der Haken "[master] >" ist der Prompt der Powershell. Der Text, der vor dem eigentlichen Haken ">" steht, nämlich "[master] " ändert schon mal die Farbe (grün, blau, ?), oder wird um Statusindikatoren erweitert. Bei der Installation wird ein Link zu einer GIT-Windows Version und ein Link zur Powershell abgelegt.

Atom

Dieser (Open-Source) Editor ( https://atom.io/ ) wurde vom Github Team entwickelt für Windows, macOS und Linux und ist optimal mit den Github Quellen verwoben (siehe Wikipedia https://de.wikipedia.org/wiki/Atom_(Texteditor) ). Viele Kommandos werden nicht mehr gebraucht, da sie in die Oberfläche integriert sind. Auch hier gibt es zuverlässige Stolperfallen. Aber es wird kontinuierlich besser, :-) .

Es kann Neulingen passieren, daß sie glauben, git und github wären zickig. Aus merkwürdigen Gründen, die letztlich nachvollziehbar natürlich alle am Novizenstatus des Anwenders liegen. In einer solchen Situation könnte folgendes Kommando helfen, wieder Ruhe in den Laden zu bekommen :

[master .... | .... ]git push -f origin master

... roedel, roedel

[master] git status

On branch master

Your branch is up-to-date with 'origin/master'

nothing to commit, working directory clean

Es mag elegantere Wege geben, Diese erschliessen sich dem Neuling nicht direkt.

Die Verlockung, direkt auf der Webseite von github zu editieren ist groß. Aber : Lieber Finger weg ! Die Unanehmlichkeiten beim Aufräum hinterher sind schmerzhaft !

Eine nette git-Kurzanleitung : https://rogerdudler.github.io/git-guide/index.de.html

Dieser Online Kurs zu git ist gut : https://try.github.io/

Die Spezifkation von HSX und ein Programmgerippe für HSX liegen übrigens auch bei github :

https://github.com/Ekkib/hsxspec.git

Zur Dokumentation reicht in der Regel der schlichte Ascii Text vollkommen aus. Um etwas Struktur und Textattribute zu bekommen, hat GitHub eine Modifikation von Markdown entwickelt : "GitHub Flavored Markdown Spec" : https://github.github.com/gfm/ .

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

Alternativen

Neben github gibt es noch weitere Angebote im Netz, wie GitLab und Bitbucket. Auch diese Organisationen bieten freie Konten an, bei denen Quellen mit git verwaltet werden können.