VNLE Handbuch

Zusammenarbeiten mit GitHub

Projektbesitzer: erstellen und einladen

Melde dich mit deinem eigenen GitHub-Konto an und autorisiere VNLE im Browser. Das macht jedes Teammitglied einmal.
Erstelle auf GitHub ein leeres Repository ohne README, Lizenz oder .gitignore. Kehre zurück, gib es für VNLE frei und aktualisiere die Liste. Nur der Projektbesitzer erstellt das gemeinsame Repository.
Öffne deine lokale Geschichte und Team. Melde dich mit deinem eigenen GitHub-Konto an. Wähle Neues Teamprojekt erstellen und erstelle im Browser ein leeres Repository. Gib der VNLE-App Zugriff darauf, kehre zu VNLE zurück, aktualisiere die Liste und wähle es aus. Trage in Schritt 3 Namen und E-Mail ein und verbinde die Geschichte. Gleiche sie mit dem Team ab und sende sie an GitHub, damit andere sie herunterladen können.
Lade eine Person separat auf GitHub ein: Repository öffnen → Settings → Collaborators → Add people. Suche ihren GitHub-Namen oder ihre E-Mail-Adresse und sende die Einladung. Sie muss mit dem eigenen Konto angenommen werden. Bei Organisations-Repositories verwaltet ein Administrator den Zugriff unter Collaborators and teams; zum Senden von Änderungen brauchen Mitglieder Schreibrechte.

Teammitglied: annehmen und herunterladen

Nimm zuerst die GitHub-Einladung an. Öffne in VNLE den Teamprojekt-Download über den Startbildschirm oder das Projektmenü. Melde dich mit deinem eigenen GitHub-Konto an und autorisiere VNLE. Wähle in Schritt 2 das gemeinsame Repository. Vergib in Schritt 3 einen lokalen Ordnernamen und lade die Geschichte herunter. Erstelle kein zweites Repository. Fehlt es, aktualisiere die Liste und bitte den Besitzer, den Zugriff der VNLE-App auf genau dieses Repository zu prüfen.

Der Besitzer muss der VNLE-App Zugriff auf dieses Repository erlauben. Eingeladene Mitglieder müssen außerdem die GitHub-Einladung annehmen. Die App-Freigabe lädt keine Personen ein und macht nichts öffentlich. Aktualisiere danach die Liste.

GitHub: Collaborators · GitHub: Apps

Das Feld für deine Änderungsbeschreibung ist freiwillig. Wenn du es leer lässt, verwendet VNLE beim Senden Update.

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.
Die Windows-Ausgabe enthält Git bereits. Du brauchst weder Git noch GitHub Desktop separat zu installieren.
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.
Der Besitzer muss der VNLE-App Zugriff auf dieses Repository erlauben. Eingeladene Mitglieder müssen außerdem die GitHub-Einladung annehmen. Die App-Freigabe lädt keine Personen ein und macht nichts öffentlich. Aktualisiere danach die Liste.

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. Wähle auf der VNLE-Startseite „Teamprojekt herunterladen“ und melde dich bei GitHub an.
Wähle das Team-Repository und einen Zielordner für deine lokale Arbeitskopie. Lade das Projekt herunter und öffne es in VNLE.
Ö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.