Руководство VNLE

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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