Podręcznik VNLE

Współpraca przez GitHub

Opis zmiany jest opcjonalny. Jeśli pozostawisz go pusty, VNLE użyje Update podczas wysyłania zmian.

Pracujesz na swoim komputerze. GitHub przechowuje wspólną wersję online. Save zapisuje lokalnie. Compare with team sprawdza i dołącza zmiany zespołu. Send to GitHub udostępnia przygotowaną wersję. Możesz pisać offline i wysłać pracę później.

Zanim zaczniesz

Utwórz bezpłatne konto na github.com. Każda osoba w zespole korzysta z własnego konta.
Wersja dla Windows zawiera Git. Nie musisz osobno instalować Git ani GitHub Desktop.
Jeśli historia ma być prywatna, utwórz prywatne repozytorium. To w nim będzie przechowywana. Publiczne wiki trzymaj w osobnym repozytorium.

Kliknij nazwę projektu w lewym górnym rogu i wybierz Set up team lub bieżący status zespołu. Wybierz Sign in with GitHub.
VNLE pokaże krótki kod i otworzy GitHub w przeglądarce. Zaloguj się tam, wpisz kod i zatwierdź logowanie.
Wróć do VNLE. Po potwierdzeniu pojawi się nazwa Twojego konta. Hasła nie wpisujesz w VNLE.
Otwórz link dostępu do repozytoriów. Wybierz Only select repositories i wskaż repozytorium historii. Potwierdź przez Install lub Save, a potem odśwież listę repozytoriów w VNLE.

2 · Opublikuj nowy projekt zespołu

Na GitHub wybierz + → New repository w prawym górnym rogu. Wpisz nazwę, np. harbour-story, i wybierz Private. Nie dodawaj README, .gitignore ani License do nowego repozytorium. Kliknij Create repository.
W VNLE wybierz repozytorium z listy lub wklej jego adres w GitHub Repository.
Podaj nazwę i e-mail przypisywane do zapisanych wersji. Możesz użyć adresu noreply z GitHub → Settings → Emails. Kliknij Connect locally.
Krótko opisz zmiany. Wybierz Compare with team. VNLE zapisze pracę, utworzy lokalną wersję i sprawdzi wersję zespołu. Następnie kliknij Send to GitHub, aby udostępnić zmiany.
Otwórz repozytorium w przeglądarce i sprawdź obecność project.vnle.json oraz folderów projektu. Zaproś członków zespołu przez Settings → Collaborators.

3 · Dołącz do istniejącego projektu

Przyjmij zaproszenie na GitHub. Na ekranie startowym VNLE wybierz Download team project i zaloguj się do GitHub.
Wybierz repozytorium zespołu i miejsce na lokalną kopię roboczą. Pobierz projekt i otwórz go w VNLE.
Otwórz ten folder w VNLE przez Open project. Zaloguj się do GitHub przez pozycję zespołu w menu projektu i sprawdź dostęp do repozytorium.
Zsynchronizuj projekt przed edycją. Pracuj nad swoją sceną, po zakończeniu porównaj zmiany ponownie, a następnie wybierz Send to GitHub.

Co oznaczają statusy

Set up team oznacza nieukończoną konfigurację. Not sent yet — lokalne zmiany czekają na wysłanie. Team updates available — inne osoby przesłały zmiany. Up to date — wersje były zgodne podczas ostatniego sprawdzenia. Status not checked — nie udało się sprawdzić GitHub, np. z powodu braku internetu. VNLE sprawdza skonfigurowane projekty mniej więcej co dwie minuty.

Gdy zmienicie tę samą treść

Wybierz Compare with team. Niezależne zmiany zostaną połączone. Jeśli ta sama treść została zmieniona na różne sposoby, VNLE pokaże ekran porównania.
Porównaj Your version i Team version. Dla każdego konfliktu wybierz wersję, którą chcesz zachować.
Kliknij Validate choices and sync. VNLE sprawdzi połączony projekt przed zastąpieniem kopii roboczej. Następnie ponownie wybierz Compare with team, a potem Send to GitHub.
Jeśli nie masz pewności, wybierz Decide later i omów treść z zespołem. Zapisana praca zostanie zachowana.

W miarę możliwości ustalcie, kto edytuje poszczególne sceny. Koordynujcie też zmiany wspólnych postaci, zmiennych i tłumaczeń. Zastosowanie nowej wersji zespołu ponownie wczytuje projekt oraz kończy bieżący podgląd i sesję cofania zmian.

Jeśli synchronizacja się nie powiedzie

Najpierw sprawdź połączenie z internetem. Jeśli autoryzacja wygasła, zaloguj się ponownie. Sprawdź, czy aplikacja VNLE ma dostęp do tego konkretnego repozytorium, a Twoje konto — uprawnienie do zapisu. Jeśli wersja zespołu zmieniła się podczas przeglądania, pobierz ją ponownie i powtórz synchronizację. Podczas rozwiązywania problemów zachowaj folder projektu.