VNLE Handbuch

Zusammenarbeiten mit GitHub

Du arbeitest auf deinem Rechner. GitHub hält den gemeinsamen Stand im Internet. Speichern sichert lokal. Mit Team abgleichen prüft und übernimmt Teamänderungen. Erst An GitHub senden teilt deinen vorbereiteten Stand. Du kannst ohne Internet schreiben und deine Arbeit später teilen.

Vorbereitung

Lege ein kostenloses GitHub-Konto auf github.com an. Jedes Teammitglied verwendet ein eigenes Konto.
Installiere Git von git-scm.com/downloads, falls es noch nicht installiert ist. Starte VNLE danach neu.
Für eine private Geschichte erstelle ein privates Repository. Dieses Repository enthält eure Geschichte. Das öffentliche Wiki gehört in ein anderes Repository.

Klicke oben links auf den Projektnamen und wähle „Team einrichten“ beziehungsweise den angezeigten Teamstatus. Wähle „Mit GitHub anmelden“.
VNLE zeigt einen kurzen Code und öffnet GitHub im Browser. Melde dich dort an, gib den Code ein und bestätige die Anmeldung.
Kehre zu VNLE zurück. Dein Kontoname erscheint nach der Bestätigung. Dein Passwort wird nicht in VNLE eingegeben.
Öffne den Link zum Freigeben von Repositories. Wähle Only select repositories und deine Story. Bestätige Install beziehungsweise Save. Lade danach die Repository-Liste in VNLE neu.

2 · Ein neues Teamprojekt veröffentlichen

Auf GitHub: oben rechts + → New repository. Gib einen Namen ein, etwa harbour-story. Wähle Private. Lass README, .gitignore und License für dieses neue Repository leer. Klicke Create repository.
In VNLE: Wähle das Repository aus der Liste oder kopiere seine Adresse in GitHub Repository.
Trage deinen Namen und die E-Mail für Versionsangaben ein. Du kannst die noreply-Adresse aus GitHub → Settings → Emails verwenden. Klicke „Lokal verbinden“.
Schreibe kurz, was du geändert hast. Wähle „Mit Team abgleichen“. VNLE speichert, erstellt eine lokale Version und prüft den Teamstand. Klicke danach „An GitHub senden“, um deinen Stand zu teilen.
Öffne das Repository im Browser und prüfe, ob project.vnle.json und die Projektordner sichtbar sind. Lade Teammitglieder unter Settings → Collaborators ein.

3 · Einem vorhandenen Projekt beitreten

Nimm die GitHub-Einladung an. Installiere GitHub Desktop von desktop.github.com und melde dich an.
Wähle File → Clone repository, dann das Team-Repository und einen leeren Zielordner. Klicke Clone. Das erstellt deine eigene lokale Arbeitskopie.
Öffne diesen Ordner in VNLE über „Projekt öffnen“. Öffne den Teamstatus im Projektmenü, melde dich bei GitHub an und prüfe den Repository-Zugriff.
Gleiche vor dem Bearbeiten mit dem Team ab. Bearbeite anschließend deine Szene, gleiche zum Abschluss erneut ab und sende deinen Stand mit „An GitHub senden“.

Den Status verstehen

„Team einrichten“: noch nicht eingerichtet. Not sent yet: lokale Arbeit wartet auf Übertragung. Team updates available: andere haben neue Änderungen hochgeladen. Up to date: beim letzten Abruf war alles abgeglichen. Status not checked: GitHub konnte nicht geprüft werden, etwa ohne Internet. VNLE prüft eingerichtete Projekte etwa alle zwei Minuten.

Wenn ihr dieselbe Stelle geändert habt

Wähle „Mit Team abgleichen“. Unabhängige Änderungen werden zusammengeführt. Wenn dieselbe Stelle unterschiedlich geändert wurde, zeigt VNLE eine Auswahl.
Vergleiche „Deine Fassung“ und „Teamfassung“. Wähle für jede betroffene Stelle die gewünschte Fassung.
Klicke „Auswahl prüfen und abgleichen“. VNLE prüft das zusammengeführte Projekt, bevor es deinen Projektstand ersetzt. Klicke danach erneut „Mit Team abgleichen“ und anschließend „An GitHub senden“.
Wenn du unsicher bist, wähle „Später entscheiden“. Besprich die Stelle mit deinem Team. Deine gespeicherte Arbeit bleibt erhalten.

Vereinbart möglichst, wer welche Szene bearbeitet. Sprecht Änderungen an gemeinsamen Figuren, Variablen und Übersetzungen ebenfalls ab. Beim Übernehmen eines neuen Teamstands wird das Projekt neu geladen; die aktuelle Vorschau und Rückgängig-Sitzung enden.

Wenn der Abgleich nicht klappt

Prüfe zuerst deine Internetverbindung. Melde dich erneut an, wenn die Anmeldung abgelaufen ist. Prüfe auf GitHub, ob die VNLE-App Zugriff auf genau dieses Repository hat und dein Konto Schreibrechte besitzt. Wenn sich der Teamstand während deiner Auswahl geändert hat, rufe ihn erneut ab und wiederhole den Abgleich. Lösche bei Problemen nicht deinen Projektordner.