Podręcznik VNLE

Współpraca przez GitHub

Właściciel: tworzenie i zapraszanie

Zaloguj się na własne konto GitHub i autoryzuj VNLE w przeglądarce. Każdy członek zespołu robi to raz.
Utwórz puste repozytorium na GitHub, bez README, licencji i .gitignore. Wróć tutaj, przyznaj dostęp VNLE i odśwież listę. Wspólne repozytorium tworzy tylko właściciel projektu.
Otwórz lokalną historię i okno zespołu. Zaloguj się na własne konto GitHub. Wybierz Utwórz projekt zespołowy i utwórz puste repozytorium w przeglądarce. Przyznaj dostęp aplikacji VNLE, wróć do niej, odśwież listę i wybierz repozytorium. W kroku 3 wpisz imię i adres e-mail, a następnie połącz historię. Porównaj ją z wersją zespołu i wyślij na GitHub, aby inni mogli ją pobrać.
Zaproś osobę osobno na GitHub: otwórz repozytorium → Settings → Collaborators → Add people. Znajdź jej nazwę użytkownika lub adres e-mail i wyślij zaproszenie. Musi je przyjąć ze swojego konta. W repozytoriach organizacji administrator zarządza dostępem w Collaborators and teams; wysyłanie zmian wymaga uprawnień do zapisu.

Członek zespołu: przyjmowanie i pobieranie

Najpierw przyjmij zaproszenie GitHub. W VNLE otwórz pobieranie projektu zespołowego z ekranu startowego lub menu projektu. Zaloguj się na własne konto i autoryzuj VNLE. W kroku 2 wybierz wspólne repozytorium. W kroku 3 podaj nazwę lokalnego folderu i pobierz historię. Nie twórz drugiego repozytorium. Jeśli go nie widać, odśwież listę i poproś właściciela o sprawdzenie dostępu aplikacji VNLE do tego repozytorium.

Właściciel musi zezwolić aplikacji VNLE na dostęp do repozytorium. Zaproszeni członkowie muszą też przyjąć zaproszenie GitHub. Dostęp aplikacji nie zaprasza osób ani nie upublicznia repozytorium. Następnie odśwież listę.

GitHub: Właściciel: tworzenie i zapraszanie · GitHub: Zaloguj się do 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.
Właściciel musi zezwolić aplikacji VNLE na dostęp do repozytorium. Zaproszeni członkowie muszą też przyjąć zaproszenie GitHub. Dostęp aplikacji nie zaprasza osób ani nie upublicznia repozytorium. Następnie odśwież listę.

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.