Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- microcontrollertechnik:0_hilfsmittel [2024/10/22 00:04] – [0.3 TortoiseGit] mexleadmin
+++ microcontrollertechnik:0_hilfsmittel [2024/10/26 15:17] (aktuell) – mexleadmin
@@ Zeile 102: / Zeile 102: @@
 ====== 0.3 MEXLE GitLab ======
-==== Installation der Software auf Ihrem Rechner ====
+{{page>gitlab_installation&noheader&nofooter}}
-  - Laden Sie Git von folgender Seiter herunter: https://git-scm.com/download/win >> "Standalone Installer"\\ Git bietet die Möglichkeit mit dem GitLab Server der Hochschule oder mit GitHub in Kontakt zu treten
-  - Installieren Sie das Git (alle mit "Ok" bzw "Weiter" bestätigen)
-  - Laden Sie TortoiseGit von folgender Seite herunter: https://tortoisegit.org/download/ \\ totroiseGit bindet den Explorer direkt an die Services des Git an. Damit ist Git direkt in den Explorer eingebunden.
-  - Installieren Sie das TortoiseGit (alle Hinweise mit "Ok" bestätigen)
-==== Vorbereitung des Rechners: Installationen und Ordner ====
-  - Melden Sie sich bei GitLab mit den Hochschul-Credentials an: https://git.mexle.org/
-  - Gehen Sie zu ''User settings'' >> ''Preferences'' >> ''Password'': \\ z.B. über folgenden Link: https://git.mexle.org/-/user_settings/password/edit \\ {{drawio>microcontrollertechnik:UserSettings.svg}}
-  - Geben Sie ein Passwort mit mindestens 16 Zeichen ein und merken Sie sich dieses Passwort. Dieses Passwort ermöglicht die Authentifizierung auf GitLab. \\ Bitte nutzen Sie ein neues Passwort!
-==== Installation der Software auf Ihrem Rechner ====
-<WRAP alert>
-Die Abfolge ist wiefolgt:
-  - Erst müssen Sie sich in GitLab angemeldet habenn
-  - Dann müssen Sie einem Betreuer (Prof. Fischer, Ralf Ziegler) per Mail bescheid geben, damit dieser Sie zum Projekt zuordnet
-  - Erst dann sind die folgenden Punkte durchführbar.
-</WRAP>
-  - Gehen Sie in den (Windows) Explorer und legen Sie einen neuen Ordner für die Vorlesung an, z.B. ''Mikrocontroller'' oder ''Elektronik Labor''
-  - Klicken Sie mit der rechten Maustaste auf den Ordner, um in des Kontextmenu zu kommen. \\ Wählen Sie dort ''Git Clone...'' aus. \\ {{drawio>microcontrollertechnik:KontextmenuGitlab.svg}}
-  - Im erscheinenden GitClone Fenster sollten Sie Folgendes eingeben:
-    - als URL: ''%%https://git.mexle.org/[Fach]/[Semester].git%%'' \\ also z.B. ''%%https://git.mexle.org/mikrocontroller/24ws.git%%'' oder ''%%https://git.mexle.org/elektronik/24ws.git%%'' für das Wintersemester 2024
-    - als Directory sollte der ausgewählte Ordner eingetragen sein
-    - Klicken Sie nun auf ''Ok'' \\ {{drawio>microcontrollertechnik:GitClone.svg}}
-  - Im Anschluss sollten Sie eine Fehlermeldung erhalten, da noch das Passwort fehlt. \\ Hier ist nun das vorher gewählte Passwort einzugeben. \\ Dies müssen Sie auch nur einmalig machen.
-  - Der Download sollte nun klappen und es sollten alle Ordner heruntergeladen werden
-==== Upload / Commit von Dateien ====
-Das Hochladen und Ändern von Dateien bei Git wird als "Commit" bezeichnet. Diese Nomenklatur wird auch im Folgenden genutzt. \\
-Im Folgenden wird ein Upload beschrieben; über einen Commit können aber auch Dateien gelöscht werden.
-  - Rechtsklick auf den übergeordneten Ordner >> ''Git Commit -> "main" ...''\\ {{drawio>microcontrollertechnik:GitCommit.svg}}
-  - Falls eine Fehlermeldung erscheint, siehe nächstes Kapitel
-  - Im folgenden Fenster ist nun einiges einzutragen:
-    - Tragen Sie unbedingt einen Text unter ''Message'' ein, ansonsten ist kein Upload möglich! \\ Schreiben sie einen Text, welcher die Änderungen beschreibt.
-    - Im unteren Teil sind die zu ändernden Dateien zu markieren. \\ Entweder Sie wählen die Dateien einzeln aus, oder Sie wählen z.B. ''All'' .
-    - Zum Commit an den Server wählen Sie am Button unten ''▼'' aus und dort ''Commit & Push'' \\ {{drawio>microcontrollertechnik:GitCommit2.svg}}
-    - Bestätigen Sie nun den Commit über Druck auf den Button ''Commit & Push''
-  - Überprüfen Sie, ob der Commit erfolgreich war durch einen Blick auf die Homepage des Projekts.
-===== Mögliche Fehler =====
-  - ''fatal: detected dubious ownership in repository at [...] is on a filesystem that does not record ownership'' \\ Das Problem ist, das der Ordner auf einem Laufwerk liegt, welches keine Benutzerzuordnung erlaubt (z.B. ein USB-Stick) . \\ Die Lösung wird gleich mitgeliefert:
-    - Rechtsklick im Explorer auf den entsprechenden Ordner (z.B. 24WS) >> ''Open Git Bash here'' >> Es öffnet sich eine Text-Konsole
-    - Fügen Sie Folgendes ein ''git config --global --add safe.directory D:/GitLab/elektronik/24WS'' (ändern Sie ggf. ''elektronik'' in ''mikrocontroller'' und das Semester) und bestätigen Sie mit Return