Starter (diff) - 🔧 Meine WackoWikiWerkStatt

Versionsunterschiede von Git / Starter

Statt zip-Dateien von WackoWiki herunterzuladen, möchtest du beginnen, daran zu arbeiten, WackoWiki zu deinem Wiki zu machen? Du möchtest leicht jederzeit neueste Änderungen der Entwickler auf ~~lokal~~ Deinem Rechner ~~finden? Du möchtest mit dem auf dieser Seite dargestellen Wissen~~ finden oder systematisch an ~~selbst~~ eigenen Verbesserungen ~~zur Schaffung deiner eigenen, individuell angepassten WikiSoftware~~ für dein Wiki arbeiten? So starte hier:
**Nachfolgend lernst Du:

Wenn du nur ein Kapitel durcharbeiten möchtest, um mit Git zu beginnen, dann bist du hier richtig.

<!~~markup:2:end~~>
<!~~markup:1:end~~> <!~~markup:2:begin~~>legend="Nachfolgend lernst Du:"}}

Git installieren

Bevor du mit Git loslegen kannst, muss es natürlich zuerst installiert werden. Auch wenn es bereits vorhanden ist, ist es vermutlich eine gute Idee, auf die neueste Version zu aktualisieren.

Installiere ~~Git^[1], z.B.~~ Git mit deinem Linuxsystem ^[2] per Konsole ~~[Strg]+[Alt]+[T]~~ [Strg]+[Alt]+[T], z.B. mit OpenSUSE

 sudo zypper install git

Prüfe, welche Version von Git installiert wurde

 git --version

Ein Projektverzeichnis anlegen

Bevor Du ein Git-Repository auf Deinem Rechner erstellst, musst Du einen Ordner anlegen bzw. einen Speicherort dafür festlegen. Ein Ordner mit dem Namen "Projekt" im Homeverzeichnis /home/⟨username⟩/Projekt hat sich als übergeordneter Aufbewahrungsort in der Praxis bewährt.

Erstelle einen Projektordner für verschiedene Git-Repositorys per Konsole in deinem Homeverzeichnis:

 mkdir /home/⟨username⟩/Projekt

Eine Möglichkeit vielzählige Git-Repositorys strukturiert lokal zu speichern ist, innerhalb deines Projektordners neue Ordner jeweils für verschiedene, ursprünglich entfernte Speicherorte zu erstellen und jene nach diesen zu benennen. Entfernte Speicherorte der Projektdateien von WackoWiki inkl. derselben Versionsgeschichte sind etwa auf den Webseiten von Sourceforge, ~~Codeberg~~ BitBucket und Github zu finden. Um darüber hinaus entfernte Git-Repositorys verschiedener Nutzer z.B. von ~~Codeberg~~ BitBucket auf deinen Rechner zu holen:
Erstelle den Ordner ~~Codeberg~~ BitBucket in Deinem Projektordner

 mkdir <!--markup:1:begin-->/home/⟨username⟩/Projekt/Codeberg

<!~~markup:1:end~~> /home/⟨username⟩/Projekt/BitBucket

<!--markup:2:end-->

Erstelle den Ordner WackoWiki <!--markup:1:begin-->nach der Namenskonvention: //home/⟨username⟩/Projekt/Name_für_entfernte-Git-Hosting-Plattform/Plattform-NutzerName//.

Für<!--markup:1:end--> <!--markup:2:begin-->für<!--markup:2:end--> eine lokale Kopie des Git-Repositorys des <!--markup:1:begin-->Codeberg-Nutzer<!--markup:1:end--> <!--markup:2:begin-->BitBucket-Nutzer<!--markup:2:end--> WackoWiki

(cl) ~~nutze:~~ mkdir <!~~markup:1:begin~~>/home/⟨username⟩/Projekt/Codeberg/WackoWiki

<!--markup:1:end--> <!--markup:2:begin-->/home/⟨username⟩/Projekt/BitBucket/WackoWiki

Übung

Erstelle mit der Konsole in Deinem Projektverzeichnis weitere Ordner für den GitHub-Nutzer WackoWiki.
Erstelle mit der Konsole in Deinem Projektverzeichnis weitere Ordner für entfernte Git-Repositories.

Das aktuellste Entwickler Ein Git-Repository in Dein Deinem Projektverzeichnis <!markup:1:begin>initial holen

<!~~markup:1:end~~> erstellen==
Zwei Möglichkeiten, ein Git-Repository auf deinem Rechner anzulegen.

Du kannst ein lokales Verzeichnis, das sich derzeit nicht unter Versionskontrolle befindet, in ein Git-Repository verwandeln, oder
Du kannst ein bestehendes Git-Repository von einem anderen Ort aus klonen.

Lokales Verzeichnis in ein neues Git-Repository verwandeln

Um jeweils schnell aktuellste Versionen der WackoWiki Softwareentwicklung auf deinen Rechner zu holen, ist diese Variante nicht effektiv.^[3]

Git-Repository clonen

Um nachfolgend eine lokale Kopie aller zum jetzigen Zeitpunkt vorhandenen Projektdateien inkl. der Versionsgeschichte des Nutzers WackoWiki der Git-Hosting Plattform ~~Codeberg~~ BitBucket strukturiert auf deinem Linux Rechner zu speichern:
Wechsele in dein bereits erstelltes Projektverzeichnis:
home/⟨username⟩/Projekt/Name_für_Git-Hosting-Plattform/NutzerName_Git-Hosting-Plattform

 cd <!--markup:1:begin-->/home/⟨username⟩/Projekt/Codeberg/WackoWiki

<!~~markup:1:end~~> /home/⟨username⟩/Projekt/BitBucket/WackoWiki

<!--markup:2:end-->

In dem ausgewählten Ordner führe folgende Git-Anweisung aus:
<!--markup:1:begin-->

(cl) git<!~~markup:1:end~~> <!~~markup:2:begin~~>

git<!--markup:2:end--> clone <!--markup:1:begin-->https://codeberg.org/WackoWiki/wackowiki.git

<!~~markup:1:end~~> <!~~markup:2:begin~~>https://bitbucket.org/wackowiki/wackowiki.git

<!--markup:2:end-->

Das ausgewählte entfernte Git-Repository des Nutzers WackoWiki auf der Webseite <!--markup:1:begin-->codeberg.org<!--markup:1:end--> <!--markup:2:begin-->bitbucket.org<!--markup:2:end--> inkl. der Projektdateien wurde auf deinen Rechner in das Verzeichnis geholt, in dem du dich momentan <!--markup:1:begin-->befindest und dort im - mit git clone erstellten - Ordner /wackowiki gespeichert.<!--markup:1:end--> <!--markup:2:begin-->befindest.<!--markup:2:end--> Überprüfe das Ergebnis per Konsole mit:

(cl) ==https://bitbucket.org/wackowiki/wackowiki.git

===

<!--markup:1:begin-->file:/Git/Starter/git-lokales-repository-angelegt.png

Ohne das .git Verzeichnis fehlen Deinem Arbeitsverzeichnis Git-Repository-Informationen. Du kannst die Repository-Informationen jederzeit löschen und das jeweilige Arbeitsverzeichnis jederzeit wieder in einen Speicherort ohne Git-Funktionalität umwandeln. 

Ein Verzeichnis inkl. Repository-Informationen insgesamt zu löschen ist jedoch für den Start günstiger, da es mit der git clone Anweisung so leicht ist, das jeweils gewünschte entfernte Git-Repository erneut auf Deinen Rechner zu bringen.


=== Jeweils neueste Entwicklungen in dein bestehendes lokales WackoWiki Repository holen==

Nachdem du das WackoWiki Entwicklerrepository in Dein Projektverzeichnis initial mit der Anweisung

(cl) ls -a

 git fetch origin master

(code) git clone https://codeberg.org/WackoWiki/wackowiki.git%% geholt hast, kannst du in dem jeweiligen Arbeitsverzeichnis jederzeit den neuesten Entwicklungsstand wie folgt von der in der .git/config Datei gespeicherten Zugangsadresse im lokalen WackoWiki-Repository aktualisieren:

 git checkout

 git pull origin master

Wenn Du selbst in dem o.g. lokalen WackoWiki-Repository keine Änderungen vorgenommen hast, ist folgende Anweisung problemlos möglich.

tl;dr

Einmalig, initial:
git clone <git_repo_url> <von_dir_bestimmter_verzeichnisname>

Zum Herunterladen der neuesten Änderungen:
im von Dir bestimmten Verzeichnis: git pull oder
git -C <von_dir_bestimmter_verzeichnisname> pull

<!~~markup:1:end~~> "git clone" Anweisung für Fortgeschrittene und Schnelllerner==

Damit
==== WackoWiki Entwickler Repository auf deinen Rechner bringen==
git ##git clone <git_repo_url> <von_dir_bestimmter_verzeichnisname>
du WackoWiki von einem entfernten Git-Repository auf Deinen Rechner holen kannst, benötigst du eine Adresse, von welcher du jene Projektdateien inkl. der Versionsgeschichte auf deinem Rechner speicherst. Zudem kannst du mit der Anweisung

~~z.B. https://codeberg.org/WackoWiki/wackowiki.git~~
<!~~markup:2:begin~~><von_dir_bestimmter_verzeichnisname>## den lokalen Speicherort dafür bestimmen.
Folgende Anweisung klont das ~~- ohne Zugangsbeschränkungen verfügbare -~~ Git-Repository von WackoWiki Git-Repository der Webseite codeberg.org
z.B. ~/Projekt/Codberg/WackoWiki/wackowiki
per https, und nicht etwa per ssh, <https://bitbucket.org/wackowiki/wackowiki.git> mit den neuesten Änderungen der Entwickler in ~~den~~ einen noch nicht erstellten ~~bzw.~~ oder leeren Ordner im
~~git ~~
Homeverzeichnis deines Rechners.

(cl)git<!~~markup:2:end~~> clone <!~~markup:1:begin~~>https://codeberg.org/WackoWiki/wackowiki.git \ /home/⟨username⟩/Projekt/Codeberg/WackoWiki/wackowiki

(cl) git -C /home/⟨username⟩/Projekt/Codeberg/WackoWiki/wackowiki pull
On a Linux System findest Du Hilfe zur Arbeit mit system if/once the git über den Kommandozeilenbefehl client is installed open a terminal and type ##git --help## . Detaillierte Für detaillierte Informationen zum klonen findest du mit der Anweisung: gib ein: ##git clone --help## Nur 
(info type="default" title="Übung | Training und Reflexion")
Erstelle mit der Konsole in Deinem Projektverzeichnis weitere Ordner für entfernte Git-Repositories und deren Nutzer.
Was bewirkt der Punkt am Ende der Anweisung git clone https://codeberg.org/WackoWiki/wackowiki.git.?
Auf einem https://bitbucket.org/wackowiki/wackowiki.git /home/⟨username⟩/Projekt/BitBucket/WackoWiki

 git clone --branch 5.0 <!--markup:1:begin-->https://codeberg.org/WackoWiki/wackowiki.git \
/home/⟨username⟩/Projekt/Codeberg/WackoWiki/5.0

Zweigeweise Klonen

**ToDo<!~~markup:1:end~~> einen Branch clonen
git clone branch <branchname> <remote-repo-url>

---- ---- Wähle den neuen Ordner cd /home/USER/Projekte/BitBucket/YourBitBucketWorkSpaceName/wackowiki In dem neuen Ordner ~/Projekt/BitBucket/YourBitBucketWorkSpaceName: Clone Deinen Fork git clone https://BitBucketUserName@bitbucket.org/YourBitBucketWorkSpaceName/YourBitBucketRepositoryName.git

komprimiertere Information wie z.B. https://www.dokuwiki.org/devel:git<!markup:1:end--> <!~~markup:2:begin~~>https://bitbucket.org/wackowiki/wackowiki.git /home/⟨username⟩/Projekt/BitBucket/WackoWiki/5.0

oder

git clone https://BitBucketUserName@bitb[...]tRepositoryName.git%%
https://git-scm.com/book/en/v2[...]ing-a-Git-Repository / https://git-scm.com/book/de/v2[...]t-Repository-anlegen

Fußnoten:

[1]: Git-Download https://git-scm.com/downloads
[2]: Installation passend zu Deinem Linux: https://git-scm.com/download/linux
[3]: Lies zu einem späteren Zeitpunkt https://git-scm.com/book/de/v2[...]t-Repository-anlegen