Manual do VNLE

Colabore com o GitHub

A descrição da alteração é opcional. Se ficar vazia, o VNLE usa Update ao enviar as alterações.

Você trabalha no seu computador; o GitHub guarda a versão compartilhada online. Save salva localmente. Compare with team verifica e incorpora as alterações da equipe. Send to GitHub compartilha a versão preparada. Você pode escrever offline e enviar seu trabalho depois.

Antes de começar

Crie uma conta gratuita em github.com. Cada colega de equipe usa sua própria conta.
A versão do Windows inclui Git. Você não precisa instalar Git ou GitHub Desktop separadamente.
Para uma história privada, crie um repositório privado. Este repositório mantém sua história. Mantenha a wiki pública em um repositório diferente.

Clique no nome do projeto, no canto superior esquerdo, e escolha Set up team ou o status atual da equipe. Selecione Sign in with GitHub.
O VNLE mostra um código curto e abre o GitHub no navegador. Faça login lá, digite o código e autorize o acesso.
Retorne ao VNLE. Seu nome de conta aparece após a confirmação. Você não digita sua senha no VNLE.
Abra o link de acesso aos repositórios. Escolha Only select repositories e selecione o repositório da história. Confirme com Install ou Save e atualize a lista de repositórios no VNLE.

2 · Compartilhe um novo projeto com a equipe

No GitHub, escolha + → New repository no canto superior direito. Digite um nome como harbour-story e escolha Private. Não adicione README, .gitignore ou License a esse novo repositório. Clique em Create repository.
No VNLE, selecione o repositório na lista ou cole o endereço em GitHub Repository.
Informe o nome e o e-mail que serão associados às suas versões. Você pode usar o endereço noreply de GitHub → Settings → Emails. Clique em Connect locally.
Descreva brevemente as alterações e escolha Compare with team. O VNLE salva, cria uma versão local e verifica a versão da equipe. Depois, clique em Send to GitHub para compartilhar o trabalho.
Abra o repositório no navegador e confira se project.vnle.json e as pastas do projeto aparecem. Convide a equipe em Settings → Collaborators.

3 · Junte-se a um projeto existente

Aceite o convite do GitHub. Na tela inicial do VNLE, escolha Download team project e faça login no GitHub.
Selecione o repositório de equipe e um destino para sua cópia de trabalho local. Baixe o projeto e abra no VNLE.
Abra essa pasta no VNLE com Open project. Faça login no GitHub pela opção de equipe do menu do projeto e confira o acesso ao repositório.
Sincronize antes de editar. Trabalhe na sua cena, compare novamente ao terminar e escolha Send to GitHub.

Entenda os status

Set up team indica uma configuração incompleta. Not sent yet indica trabalho local ainda não enviado. Team updates available significa que a equipe enviou alterações. Up to date indica que tudo coincidia na última verificação. Status not checked significa que não foi possível consultar o GitHub, por exemplo, por estar offline. O VNLE verifica os projetos configurados aproximadamente a cada dois minutos.

Quando duas pessoas alteram o mesmo conteúdo

Escolha Compare with team. Alterações independentes são combinadas. Se o mesmo conteúdo tiver sido alterado de maneiras diferentes, o VNLE abre uma revisão.
Compare Your version e Team version. Escolha qual versão manter para cada item afetado.
Clique em Validate choices and sync. O VNLE valida o projeto combinado antes de substituir sua versão de trabalho. Depois, escolha Compare with team novamente e, em seguida, Send to GitHub.
Na dúvida, escolha Decide later e converse com a equipe. Seu trabalho salvo é preservado.

Sempre que possível, combinem quem edita cada cena. Coordenem também as mudanças em personagens, variáveis e traduções compartilhados. Aplicar uma nova versão da equipe recarrega o projeto e encerra a prévia e o histórico de desfazer atuais.

Se a sincronização falhar

Primeiro, confira a conexão com a internet. Faça login novamente se a autorização tiver expirado. Verifique se o aplicativo VNLE tem acesso ao repositório específico e se sua conta tem permissão de escrita. Se a versão da equipe mudou durante a revisão, busque-a novamente e repita a sincronização. Preserve sua pasta do projeto ao resolver problemas.