Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- werkzeuge:github:start [11.08.2026 06:42] – angelegt admin
+++ werkzeuge:github:start [29.09.2026 05:50] (aktuell) – admin
@@ Zeile 1: / Zeile 1: @@
-<WRAP rww-subpage-header>
+<WRAP rww-page-header>
+<WRAP rww-page-header-main>
-<WRAP rww-subpage-heading>
+<WRAP rww-page-title>
 ====== GitHub ======
 </WRAP>
-<WRAP rww-back>
+<WRAP rww-page-icon>
-[[werkzeuge:start|←]] [[werkzeuge:start|Werkzeuge]]
+<iconify mdi:github>
+</WRAP>
 </WRAP>
+<WRAP rww-page-back>
+[[werkzeuge:start|← Werkzeuge]] · [[:start|Startseite]]
+</WRAP>
 </WRAP>
-KURZE EINLEITUNG ZUM THEMA.
+----
-===== ABSCHNITT 1 =====
+===== Was ist GitHub? =====
-INHALT DES ABSCHNITTS.
+GitHub ist eine Online-Plattform, auf der Softwareprojekte und deren Dateien gespeichert und gemeinsam verwaltet werden können.
+Die Grundlage dafür bildet das Versionsverwaltungssystem Git. Git zeichnet Änderungen an Dateien auf. GitHub stellt diese Git-Projekte online bereit und ergänzt sie um weitere Funktionen für Verwaltung, Zusammenarbeit und Dokumentation.
+Ein auf GitHub gespeichertes Projekt wird als **Repository** bezeichnet.
+Für mich ist GitHub noch Neuland. Diese Seite dokumentiert deshalb meinen Einstieg, die wichtigsten Grundlagen und vor allem die Dinge, die ich bei meiner eigenen Arbeit tatsächlich kennenlerne und nutze.
+===== Git und GitHub – ist das dasselbe? =====
+Nein. Git und GitHub gehören zusammen, sind aber nicht dasselbe.
+**Git** ist ein Versionsverwaltungssystem. Es läuft auf meinem Rechner und kann Änderungen an Dateien eines Projekts nachvollziehen und speichern.
+**GitHub** ist eine Online-Plattform, auf der Git-Repositories gespeichert werden können. Dadurch kann ich mein lokales Git-Projekt zusätzlich online ablegen und beispielsweise von anderen Rechnern darauf zugreifen oder mit anderen daran arbeiten.
+Vereinfacht kann ich mir den Unterschied so merken:
+<code>
+Git     → Versionsverwaltung auf meinem Rechner
+GitHub  → Plattform für meine Git-Repositories im Internet
+</code>
+Git funktioniert auch ohne GitHub. GitHub baut dagegen auf Git auf.
+===== Warum beschäftige ich mich damit? =====
+GitHub ist für mich vor allem im Zusammenhang mit meinen eigenen Entwicklungsprojekten interessant.
+Bei TheCruiserBlog nutze ich bereits Git zur Versionsverwaltung. Das Projekt besitzt außerdem ein GitHub-Repository, sodass der lokale Entwicklungsstand zusätzlich auf GitHub gespeichert werden kann.
+Bisher habe ich GitHub dabei eher benutzt, ohne mich intensiver damit zu beschäftigen. Jetzt möchte ich verstehen, was dabei eigentlich passiert und wie Git und GitHub zusammenspielen.
+Mein Ziel ist nicht, möglichst viele GitHub-Funktionen kennenzulernen. Ich möchte zunächst genau die Funktionen verstehen und dokumentieren, die ich für meine eigenen Projekte tatsächlich benötige.
+===== Wie funktioniert GitHub grundsätzlich? =====
+Auf meinem Rechner befindet sich zunächst das eigentliche Projekt mit seinen Dateien.
+Git verwaltet die Änderungen an diesen Dateien lokal. Bestimmte Arbeitsstände kann ich als sogenannten **Commit** festhalten.
+Ein GitHub-Repository ist die Online-Gegenstelle zu meinem lokalen Git-Repository. Beide können miteinander verbunden werden.
+Das Grundprinzip kann ich mir zunächst so vorstellen:
+<code>
+Projektdateien auf meinem Rechner
+          ↓
+         Git
+          ↓
+       Commit
+          ↓
+        Push
+          ↓
+       GitHub
+</code>
+{{:rww:infografiken:infografik_git_github_grundprinzip.png|Git & GitHub – Das Grundprinzip}}
+Mit ''push'' übertrage ich meine lokal gespeicherten Änderungen zu GitHub.
+Umgekehrt können Änderungen von GitHub auch wieder auf meinen Rechner übernommen werden. Diesen Weg lerne ich später genauer kennen.
+===== Meine Umgebung =====
+GitHub nutze ich im Zusammenhang mit meiner lokalen Entwicklungsumgebung für TheCruiserBlog.
+Meine derzeitige Umgebung:
+  * **Betriebssystem:** Windows
+  * **Lokale Entwicklungsumgebung:** XAMPP
+  * **Projekt:** TheCruiserBlog
+  * **Lokales Projektverzeichnis:** E:\xampp\htdocs\thecruiserblog
+  * **Versionsverwaltung:** Git
+  * **Online-Plattform:** GitHub
+  * **Hauptbranch:** main
+Das lokale Projekt ist bereits als Git-Repository eingerichtet und mit einem Repository auf GitHub verbunden.
+Änderungen kann ich lokal mit Git erfassen und anschließend zu GitHub übertragen.
+===== Mein erstes Repository =====
+Mein erstes GitHub-Repository gehört zu meinem Projekt **TheCruiserBlog**.
+Das Projekt existiert lokal auf meinem Rechner als Git-Repository und ist mit einem Repository auf GitHub verbunden.
+Damit gibt es zwei Seiten meines Projekts:
+<code>
+Lokales Git-Repository
+E:\xampp\htdocs\thecruiserblog
+        ↕
+   Verbindung über origin
+GitHub-Repository
+</code>
+Für mich ist zunächst wichtig zu verstehen, **wie diese Verbindung eingerichtet ist und wie ich erkennen kann, mit welchem GitHub-Repository mein lokales Projekt verbunden ist**.
+Die vorhandene Konfiguration untersuche ich deshalb Schritt für Schritt direkt mit Git.
+==== Verbindung zu GitHub ====
+Mit folgendem Befehl kann ich prüfen, mit welchem entfernten Repository mein lokales Git-Repository verbunden ist:
+<code>
+git remote -v
+</code>
+Bei TheCruiserBlog wird das GitHub-Repository unter dem Namen ''origin'' geführt.
+Die Ausgabe unterscheidet zwei Verwendungsrichtungen:
+  * ''fetch'' → Änderungen vom entfernten Repository abrufen
+  * ''push'' → eigene Änderungen zum entfernten Repository übertragen
+In meiner aktuellen Konfiguration zeigen beide auf dasselbe GitHub-Repository.
+Der Name ''origin'' ist dabei lediglich der lokale Kurzname für dieses entfernte Repository.
+==== Mein Hauptbranch main ====
+Mein lokales Repository verwendet den Branch ''main''.
+Ein Branch ist vereinfacht gesagt eine Entwicklungslinie innerhalb eines Git-Repositories.
+Für meinen Einstieg arbeite ich zunächst nur mit:
+<code>
+main
+</code>
+''main'' ist die Entwicklungslinie, auf der sich mein aktueller Projektstand befindet.
+Später können weitere Branches sinnvoll werden, beispielsweise um Änderungen zunächst getrennt vom Hauptstand zu entwickeln. Für den Einstieg konzentriere ich mich jedoch bewusst nur auf ''main''.
+===== Mein praktischer Arbeitsablauf =====
+Git und GitHub möchte ich nicht nur theoretisch verstehen. Entscheidend ist für mich, wie beide Werkzeuge in meinen normalen Arbeitsablauf passen.
+Dabei möchte ich Schritt für Schritt nachvollziehen:
+  * welche Dateien Git als geändert erkennt
+  * wie ich Änderungen für einen Commit vorbereite
+  * wie ich einen Arbeitsstand als Commit speichere
+  * wie ich diesen Stand anschließend zu GitHub übertrage
+  * wie ich kontrollieren kann, ob lokales Repository und GitHub auf demselben Stand sind
+Diesen Ablauf dokumentiere ich anhand meiner tatsächlichen Arbeit am Projekt TheCruiserBlog.
+==== Projektstatus prüfen ====
+Bevor ich mit Git weiterarbeite, kann ich zunächst den aktuellen Zustand meines lokalen Repositories prüfen:
+<code>
+git status
+</code>
+Der Befehl verändert nichts, sondern zeigt mir den aktuellen Git-Status.
+Beispiel aus meinem TheCruiserBlog-Repository:
+<code>
+On branch main
+Your branch is up to date with 'origin/main'.
+nothing to commit, working tree clean
+</code>
+Das bedeutet für meinen aktuellen Stand:
+  * Ich arbeite auf dem Branch ''main''.
+  * Mein lokaler Branch hat gegenüber ''origin/main'' keine ausstehenden Commits.
+  * Es gibt momentan nichts zu committen.
+  * Mein Arbeitsverzeichnis ist sauber.
+''git status'' ist damit für mich ein wichtiger Kontrollbefehl: **Erst schauen, was Git sieht – dann handeln.**
+===== Begriffe, die ich verstehen möchte =====
+Bei Git und GitHub begegnen mir viele Begriffe, deren Bedeutung am Anfang nicht selbstverständlich ist.
+Hier sammle ich nur Begriffe, die mir bei meiner eigenen Arbeit tatsächlich begegnet sind. Die Liste wächst deshalb zusammen mit meiner praktischen Erfahrung.
+==== Meine ersten Begriffe ====
+  * **Repository** → ein von Git verwaltetes Projekt mit seiner Versionsgeschichte
+  * **Branch** → eine Entwicklungslinie innerhalb eines Repositories
+  * **main** → der Hauptbranch meines aktuellen Projekts
+  * **Remote** → ein entferntes Repository, mit dem mein lokales Repository verbunden ist
+  * **origin** → der lokale Kurzname für mein verbundenes GitHub-Repository
+  * **Commit** → ein mit Git gespeicherter Arbeitsstand
+  * **Push** → lokale Commits zum entfernten Repository übertragen
+  * **Fetch** → Informationen und Änderungen vom entfernten Repository abrufen
+  * **Working Tree** → die aktuell ausgecheckten Projektdateien, an denen ich lokal arbeite
+===== Probleme & Lösungen =====
+Git und GitHub sind für mich noch neu. Deshalb dokumentiere ich hier Probleme und Stolpersteine, die mir bei der praktischen Arbeit tatsächlich begegnen.
+Für jeden Fall möchte ich möglichst festhalten:
+  * Was wollte ich machen?
+  * Was ist passiert?
+  * Welche Meldung wurde angezeigt?
+  * Was war die Ursache?
+  * Wie habe ich das Problem gelöst?
+Dieser Bereich wächst zusammen mit meiner praktischen Erfahrung.
+<WRAP rww-to-top>
+[[#github|↑]]
+</WRAP>