Совместная работа через GitHub

Владелец: создание и приглашение

1. Войдите в свой аккаунт GitHub и разрешите доступ VNLE в браузере. Это один раз делает каждый участник.
2. Создайте пустой репозиторий на GitHub без README, лицензии и .gitignore. Вернитесь сюда, разрешите доступ VNLE и обновите список. Общий репозиторий создаёт только владелец проекта.
3. Откройте локальную историю и окно команды. Войдите в свой аккаунт GitHub. Выберите создание командного проекта и создайте пустой репозиторий в браузере. Разрешите приложению VNLE доступ, вернитесь в VNLE, обновите список и выберите репозиторий. На шаге 3 укажите имя и почту и подключите историю. Сравните её с версией команды, затем отправьте на GitHub, чтобы другие участники могли скачать её.
4. Пригласите участника отдельно на GitHub: откройте репозиторий → Settings → Collaborators → Add people. Найдите его имя пользователя или почту и отправьте приглашение. Участник должен принять его со своего аккаунта. В репозиториях организации доступом управляет администратор в Collaborators and teams; для отправки изменений нужны права записи.

Участник: принять и скачать

Сначала примите приглашение GitHub. В VNLE откройте загрузку командного проекта на стартовом экране или в меню проекта. Войдите в свой аккаунт и разрешите доступ VNLE. На шаге 2 выберите общий репозиторий. На шаге 3 задайте имя локальной папки и скачайте историю. Второй репозиторий создавать не нужно. Если нужного нет в списке, обновите список и попросите владельца проверить доступ приложения VNLE к этому репозиторию.

Владелец должен разрешить приложению VNLE доступ к репозиторию. Приглашённым участникам нужно также принять приглашение GitHub. Доступ приложения не приглашает людей и не делает репозиторий публичным. Затем обновите список.

GitHub: Владелец: создание и приглашение · GitHub: Войти в GitHub

Описание изменений необязательно. Если оно пустое, при отправке VNLE использует Update.

Вы работаете на своём компьютере, а GitHub хранит общую версию онлайн. Save сохраняет локально. Compare with team проверяет и объединяет изменения команды. Send to GitHub отправляет подготовленную версию. Можно работать без интернета и поделиться результатом позже.

Прежде чем начать

1. Создайте бесплатный аккаунт на github.com. Каждый сотрудник использует свой аккаунт.
2. Версия для Windows включает Git. Вам не нужно устанавливать Git или GitHub Desktop отдельно.
3. Для закрытой истории создайте приватный репозиторий. В нём будет храниться история. Публичную вики держите в другом репозитории.

1 · Войдите в GitHub из VNLE

1. Нажмите название проекта в левом верхнем углу и выберите Set up team или текущий статус команды. Затем выберите Sign in with GitHub.
2. VNLE покажет короткий код и откроет GitHub в браузере. Войдите там в аккаунт, введите код и подтвердите вход.
3. Вернитесь в VNLE. Имя вашей учетной записи появляется после подтверждения. Вы не вводите свой пароль в VNLE.

4. Владелец должен разрешить приложению VNLE доступ к репозиторию. Приглашённым участникам нужно также принять приглашение GitHub. Доступ приложения не приглашает людей и не делает репозиторий публичным. Затем обновите список.

2 · Подключите новый командный проект

1. На GitHub выберите + → New repository в правом верхнем углу. Введите название, например harbour-story, и выберите Private. Не добавляйте README, .gitignore и License в новый репозиторий. Нажмите Create repository.
2. В VNLE выберите репозиторий из списка или вставьте его адрес в GitHub Repository.
3. Введите имя и адрес почты для записей о ваших версиях. Можно использовать адрес noreply из GitHub → Settings → Emails. Нажмите Connect locally.
4. Кратко опишите изменения и выберите Compare with team. VNLE сохранит проект, создаст локальную версию и проверит командную. Затем нажмите Send to GitHub, чтобы отправить работу.
5. Откройте репозиторий в браузере и убедитесь, что появились файл project.vnle.json и папки проекта. Пригласите участников через Settings → Collaborators.

3 · Присоединитесь к существующему проекту

1. Примите приглашение GitHub. На стартовом экране VNLE выберите Download team project и войдите в GitHub.
2. Выберите репозиторий команды и место для локальной рабочей копии. Скачайте проект и откройте его в VNLE.
3. Откройте эту папку в VNLE через Open project. Войдите в GitHub через пункт команды в меню проекта и проверьте доступ к репозиторию.
4. Перед редактированием синхронизируйтесь. Завершив работу над сценой, снова сравните версии и выберите Send to GitHub.

Что означают статусы

Set up team означает, что настройка не завершена. Not sent yet — локальные изменения ещё не отправлены. Team updates available — участники команды отправили обновления. Up to date — при последней проверке версии совпадали. Status not checked — проверить GitHub не удалось, например без интернета. VNLE проверяет настроенные проекты примерно каждые две минуты.

Если вы оба изменили одно и то же

1. Выберите Compare with team. Независимые изменения объединятся. Если один элемент изменён по-разному, VNLE откроет окно проверки.
2. Сравните Your version и Team version. Для каждого затронутого элемента выберите версию, которую нужно сохранить.
3. Нажмите Validate choices and sync. VNLE проверит объединённый проект перед заменой рабочей версии. Затем снова выберите Compare with team, а после — Send to GitHub.
4. Если сомневаетесь, выберите Decide later и обсудите изменения с командой. Сохранённая работа не потеряется.

По возможности договоритесь, кто редактирует каждую сцену. Согласуйте также изменения общих персонажей, переменных и переводов. Применение новой командной версии перезагружает проект и завершает текущий предпросмотр и сеанс отмены действий.

Если синхронизация не удается

Сначала проверьте интернет-соединение. Если срок авторизации истёк, войдите снова. Убедитесь, что приложению VNLE доступен нужный репозиторий, а у аккаунта есть право записи. Если командная версия изменилась во время проверки, получите её заново и повторите синхронизацию. При устранении неполадок сохраняйте папку проекта.