Starter (diff) - 🔧 Meine WackoWikiWerkStatt

Versionsunterschiede von Git / Starter

1	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 lokal auf Deinem Rechner finden? Du möchtest mit dem auf dieser Seite dargestellen Wissen systematisch selbst an Verbesserungen zur Schaffung deiner eigenen, individuell angepassten WikiSoftware arbeiten? So starte hier:	1	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 Deinem Rechner finden oder systematisch an eigenen Verbesserungen für dein Wiki arbeiten?
2		2
3	~~Nachfolgend lernst Du:~~	3	Wenn du nur ein Kapitel durcharbeiten möchtest, um mit Git zu beginnen, dann bist du hier richtig.
4		4
5	{{toc nomark=1}}	5	%%(wacko wrapper=shade)
6		6	{{toc legend="Nachfolgend lernst Du:"}}
		7	%%
7		8
8	=== Git installieren====	9	=== Git installieren====
9		10
10	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.	11	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.
11		12
12	Installiere Git~~[[^ Git-Download https://git-scm.com/downloads]], z.B. per Konsole [Strg]+[Alt]+[T]~~	13	Installiere Git mit deinem Linuxsystem [[^ Installation passend zu Deinem Linux: https://git-scm.com/download/linux]] per Konsole [Strg]+[Alt]+[T], z.B. mit OpenSUSE
13	%%(cl) sudo zypper install git%%	14	%%(cl) sudo zypper install git%%
14		15
15	Prüfe, welche Version von Git installiert wurde	16	Prüfe, welche Version von Git installiert wurde
16	%%(cl) git --version%%	17	%%(cl) git --version%%
17		18
18	=== Ein Projektverzeichnis anlegen====	19	=== Ein Projektverzeichnis anlegen====
19
20	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.	20	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.
21		21
22		22
…	…	…	…
24		24
25	%%(cl) mkdir /home/⟨username⟩/Projekt%%	25	%%(cl) mkdir /home/⟨username⟩/Projekt%%
26		26
27	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 und Github zu finden. Um entfernte Git-Repositorys verschiedener Nutzer z.B. von Codeberg~~ auf deinen Rechner zu holen:	27	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, BitBucket und Github zu finden. Um darüber hinaus entfernte Git-Repositorys verschiedener Nutzer z.B. von BitBucket auf deinen Rechner zu holen:
28		28
29	Erstelle den Ordner ~~Codeberg~~ in Deinem Projektordner	29	Erstelle den Ordner BitBucket in Deinem Projektordner
30	%%(cl) mkdir /home/⟨username⟩/Projekt/~~Codeberg~~%%	30	%%(cl) mkdir /home/⟨username⟩/Projekt/BitBucket%%
31		31
32	Erstelle den Ordner WackoWiki nach der Namenskonvention: //home/⟨username⟩/Projekt/Name_für_entfernte-Git-Hosting-Plattform/Plattform-NutzerName//.	32	Erstelle den Ordner WackoWiki für eine lokale Kopie des Git-Repositorys des BitBucket-Nutzer WackoWiki
33		33	%%(cl) mkdir /home/⟨username⟩/Projekt/BitBucket/WackoWiki%%
34	Für eine lokale Kopie des Git-Repositorys des Codeberg-Nutzer WackoWiki nutze:
35	%%(cl) mkdir /home/⟨username⟩/Projekt/Codeberg/WackoWiki%%
36		34
37		35
38	=== Das aktuellste Entwickler Git-Repository in Dein Projektverzeichnis initial holen==	36	%%(info type="default" title="Übung")Erstelle mit der Konsole in Deinem Projektverzeichnis weitere Ordner für den GitHub-Nutzer WackoWiki.%%
39
40	Um nachfolgend eine lokale Kopie aller zum jetzigen Zeitpunkt vorhandenen Projektdateien inkl. der Versionsgeschichte des Nutzers WackoWiki der Git-Hosting Plattform Codeberg strukturiert auf deinem Linux Rechner zu speichern:
41
42	Wechsele in dein bereits erstelltes Projektverzeichnis:
43	%%(cl) cd /home/⟨username⟩/Projekt/Codeberg/WackoWiki%%
44
45	In dem ausgewählten Ordner führe folgende Git-Anweisung aus:
46	%%(cl) git clone https://codeberg.org/WackoWiki/wackowiki.git%%
47
48	Das ausgewählte entfernte Git-Repository des Nutzers WackoWiki auf der Webseite codeberg.org inkl. der Projektdateien wurde auf deinen Rechner in das Verzeichnis geholt, in dem du dich momentan befindest und dort im - mit git clone erstellten - Ordner /wackowiki gespeichert. Überprüfe das Ergebnis per Konsole mit:
49	%%(cl) ls -a%%
50
51	file:/Git/Starter/git-lokales-repository-angelegt.png
52
53	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.
54
55	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.
56		37
57		38
58	=== Jeweils neueste Entwicklungen in dein bestehendes lokales WackoWiki Repository holen==	39	=== Ein Git-Repository in Deinem Projektverzeichnis erstellen==
		40	====Ein Git Repository erstellen - Lokales Verzeichnis in ein Git-Repository verwandeln==
		41	Zwei Möglichkeiten, ein Git-Repository auf deinem Rechner anzulegen.
59		42
60	Nachdem du das WackoWiki Entwicklerrepository in Dein Projektverzeichnis initial mit der Anweisung %%(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:	43	* Sie können ein lokales Verzeichnis, das sich derzeit nicht unter Versionskontrolle befindet, in ein Git-Repository verwandeln, oder
		44	* Sie können ein bestehendes Git-Repository von einem anderen Ort aus klonen.
61		45
62	%%(cl) git fetch origin master%%	46	====Ein Git Repository erstellen - Git-Repository clonen==
63	%%(cl) git checkout%%	47	https://git-scm.com/book/de/v2/Git-Grundlagen-Ein-Git-Repository-anlegen
64
65	Wenn Du selbst in dem o.g. lokalen WackoWiki-Repository keine Änderungen vorgenommen hast, ist folgende Anweisung problemlos möglich.
66
67	%%(cl) git pull origin master%%
68		48
69		49
70		50
		51	Um nachfolgend eine lokale Kopie aller zum jetzigen Zeitpunkt vorhandenen Projektdateien inkl. der Versionsgeschichte des Nutzers WackoWiki der Git-Hosting Plattform BitBucket strukturiert auf deinem Linux Rechner zu speichern:
		52
		53	Wechsele in dein bereits erstelltes Projektverzeichnis:
		54	##home/⟨username⟩/Projekt/Name_für_Git-Hosting-Plattform/NutzerName_Git-Hosting-Plattform##
		55
		56	%%(cl) cd /home/⟨username⟩/Projekt/BitBucket/WackoWiki%%
		57
		58	In dem ausgewählten Ordner führe folgende Git-Anweisung aus:
		59	%%(cl)git clone https://bitbucket.org/wackowiki/wackowiki.git%%
		60
		61	Das ausgewählte entfernte Git-Repository des Nutzers WackoWiki auf der Webseite bitbucket.org inkl. der Projektdateien wurde auf deinen Rechner in das Verzeichnis geholt, in dem du dich momentan befindest. Überprüfe das Ergebnis per Konsole mit:
		62	%%(cl) ls -a%%
		63
		64
71	=== "git clone" Anweisung für Fortgeschrittene und Schnelllerner==	65	=== "git clone" Anweisung für Fortgeschrittene und Schnelllerner==
72	==== WackoWiki Entwickler Repository auf deinen Rechner bringen==	66	Damit 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 ##git clone <git_repo_url> <von_dir_bestimmter_verzeichnisname>## den lokalen Speicherort dafür bestimmen.
73	%%(info type="note" title="tl;dr")
74	__Einmalig, initial:__
75	##git clone <git_repo_url> <von_dir_bestimmter_verzeichnisname>##
76		67
77	__Zum Herunterladen der neuesten Änderungen:__	68	Folgende Anweisung klont das Git-Repository von WackoWiki mit den neuesten Änderungen der Entwickler in einen noch nicht erstellten oder leeren Ordner deines Rechners.
78	im von Dir bestimmten Verzeichnis: git pull oder
79	##git -C <von_dir_bestimmter_verzeichnisname> pull##
80	%%
81		69
82	Damit 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	70	%%(cl)git clone https://bitbucket.org/wackowiki/wackowiki.git /home/⟨username⟩/Projekt/BitBucket/WackoWiki%%
83	%%(code)git clone <git_repo_url> <von_dir_bestimmter_verzeichnisname>%% den lokalen Speicherort dafür bestimmen.
84
85	Folgende Anweisung klont das - ohne Zugangsbeschränkungen verfügbare - WackoWiki Git-Repository der Webseite codeberg.org %%(code) z.B. https://codeberg.org/WackoWiki/wackowiki.git%% per https, und nicht etwa per ssh, mit den neuesten Änderungen der Entwickler in den noch nicht erstellten bzw. leeren Ordner %%(code) z.B. ~/Projekt/Codberg/WackoWiki/wackowiki%% im Homeverzeichnis deines Rechners.
86
87	%%(cl) git clone https://codeberg.org/WackoWiki/wackowiki.git \
88	/home/⟨username⟩/Projekt/Codeberg/WackoWiki/wackowiki %%
89
90	%%(cl) git -C /home/⟨username⟩/Projekt/Codeberg/WackoWiki/wackowiki pull%%
91
92	%%(info type="default" title="Übung \| Training und Reflexion")
93	Erstelle mit der Konsole in Deinem Projektverzeichnis weitere Ordner für entfernte Git-Repositories und deren Nutzer.
94	Was bewirkt der Punkt am Ende der Anweisung ##git clone ~https://codeberg.org/WackoWiki/wackowiki.git.##?
95	Auf einem Linux System findest Du Hilfe zur Arbeit mit git über den Kommandozeilenbefehl ##git --help## . Detaillierte Informationen zum klonen findest du mit der Anweisung: ##git clone --help## %%
96
97	==== Zweigeweise Klonen ==
98
99	ToDo
100	* Nur einen Branch clonen
101	git clone --branch <branchname> <remote-repo-url>
102
103	%%(cl) git clone --branch 5.0 https://codeberg.org/WackoWiki/wackowiki.git \
104	/home/⟨username⟩/Projekt/Codeberg/WackoWiki/5.0%%
105	* komprimiertere Information wie z.B. https://www.dokuwiki.org/devel:git
106		71
107		72
108		73
		74
		75
		76
		77
		78
		79
		80
		81
		82
		83	----
		84
		85	Wähle den neuen Ordner
		86	cd /home/USER/Projekte/BitBucket/YourBitBucketWorkSpaceName/wackowiki
		87
		88	In dem neuen Ordner ~/Projekt/BitBucket/YourBitBucketWorkSpaceName: Clone Deinen Fork
		89	git clone https://BitBucketUserName@bitbucket.org/YourBitBucketWorkSpaceName/YourBitBucketRepositoryName.git%%
		90
		91	oder
		92
		93	git clone https://BitBucketUserName@bitbucket.org/YourBitBucketWorkSpaceName/YourBitBucketRepositoryName.git%%
		94
		95
		96
		97
		98
		99	On a Linux system if/once the git client is installed open a terminal and type ##git --help## .
		100	Für detaillierte Informationen zum klonen gib ein: ##git clone --help##
		101
		102
		103	https://git-scm.com/book/en/v2/Git-Basics-Getting-a-Git-Repository / https://git-scm.com/book/de/v2/Git-Grundlagen-Ein-Git-Repository-anlegen