Folien angepasst

GitLokal.adoc

@@ -48,6 +48,88 @@ In seiner aktuellen Fassung (Stand 10.09.2024) verfügt Gitbutler nur über sehr
 image::bilder/GitButler/Neuer Commit.png[]
 
 === SmartGit
+==== Installation
+Smartgit gibt es in unterschiedlichen Varianten (https://www.syntevo.com/register-non-commercial/#academic): eine kostenpflichtige Version, eine kostenlose Education-Version und eine kostenlose
+Privatuser (Hobby-Edition). Für einfache Anwendungen (ohne kollaboratives Arbeiten) reicht die Hobby-Edition. Diese können Schülerinnen und Schüler leicht zu Hause installieren. In der Schule
+empfiehlt sich die Education-Version. Dafür muss die Software mit einer E-Mail-Adresse der Schule registriert werden. Das Lizenzdatei (nach Absprache mit der Firma) darf dann von allen 
+Lehrern und Schülern der Schule benutzt werden.
+
+*Installation unter Windows:*
+Die Software kann als portable Version auf dem Server der Schule abgelegt werden, wenn einige zusätzliche Einstellungen vorgenommen werden:
+
+. Die Datei `smartgit\bin\smartgit.vmoptions` muss so angepasst werden, dass die Settings-Einstellungen im Homeverzeichnis der Schüler gespeichert werden:
++
+[code]
+---
+-Dsmartboot.sourceDirectory=H:\smartgit-settings\updates
+-Dsmartgit.settings=H:\smartgit-settings
+-XX:ErrorFile=%EXE4J_EXEDIR%..\.settings\hs_err_pid%p.log
+---
+. Dieses Verzeichnis muss beim ersten Starten von Smartgit mit den Standardwerten gefüllt werden (insbesondere der Lizenzdatei und den Proxy-Einstellungen).
+Daher führt man Smartgit als Admin einmalig aus und konfiguriert die Lizenzdatei und die Starteinstellungen. Die kompletten Einstellungen werden in dem Verzeichnis 
+`.settings` bzw. `H:\smartgit-settings` (wenn man Punkt 1 schon durchgeführt hat) gespeichert.
++
+Dieses Verzeichnis kopiert man auf dem Server in ein eigenes Verzeichnis z. B. `smartgit-settings-schulexy`.
+
+. Proxy-Einstellungen: Damit der Proxy der Schule benutzt wird, muss man in der Datei `preferences.yml` folgende Zeilen anpassen:
++
+[code]
+---
+proxy: {user: %user%, authenticate: true, host: 10.10.0.1, enabled: true, port: 8080,
+  autoDetect: false}
+---
++
+Die Variable %user% wird später durch ein Skript durch den Usernamen ersetzt.
+
+. Statt direkt smartgit.exe zu starten, muss die Verknüpfung so angelegt werden, dass eine Batch-Datei mit folgendem Inhalt gestartet wird:
++
+[code]
+---
+if exist H:\smartgit-settings\ (
+  echo Settingsverzeichnis schon vorhanden
+) else (
+  mkdir H:\smartgit-settings
+  xcopy P:\informatik\smartgit\smartgit-settings-schulexy H:\smartgit-settings /s /e
+  cscript P:\informatik\smartgit\replaceusername.vbs 
+)
+
+echo starte smartgit
+xcopy H:\smartgit-settings\.gitconfig %USERPROFILE%\ /I /Y
+p:\informatik\smartgit\bin\smartgit.exe
+xcopy %USERPROFILE%\.gitconfig H:\smartgit-settings /Y /I
+---
++
+Der erste Teil kopiert das Settingsverzeichnis, wenn es noch nicht existiert. Der Username wird durch ein vbs-Skript ausgelesen und
+angepasst.
++
+[code]
+---
+Const ForReading = 1    
+Const ForWriting = 2
+
+strFileName = "H:\smartgit-settings\preferences.yml"
+strOldText = "%user%"
+strNewText = CreateObject("WScript.Network").UserName
+
+Set objFSO = CreateObject("Scripting.FileSystemObject")
+Set objFile = objFSO.OpenTextFile(strFileName, ForReading)
+strText = objFile.ReadAll
+objFile.Close
+
+strNewText = Replace(strText, strOldText, strNewText)
+Set objFile = objFSO.OpenTextFile(strFileName, ForWriting)
+objFile.Write strNewText  
+objFile.Close
+---
+
++
+Der zweite Teil ist notwendig, wenn das %USERPROFILE% der Schüler nicht gespeichert wird. In der .gitconfig-Datei werden globale Git-Einstellungen gespeichert. 
+Durch die Befehle wird die in smartgit-settings gesicherte .gitconfig an die richtige Stelle kopiert, dann Smartgit gestartet und
+eventuelle Änderungen nach Beendigung wieder gesichert. Das ist notwendig, um Benutzer und Email-Konfiguration in Git dauerhaft zu 
+speichern.
++
+
+
 
 ==== Repository eröffnen
 Nach der Installation und dem Einstellen der Initialparameter findet sich die Einstellung zum Einbinden eines neuen Repositories oben links.