Manual de VNLE

Colabora con GitHub

La descripción del cambio es opcional. Si la dejas vacía, VNLE utiliza Update al enviar las modificaciones.

Trabajas en tu equipo. GitHub guarda la versión compartida en línea. Save guarda localmente. Compare with team comprueba e incorpora los cambios del equipo. Send to GitHub comparte la versión que has preparado. Puedes escribir sin conexión y compartir el trabajo más tarde.

Antes de empezar

Crea una cuenta gratuita en github.com. Cada miembro del equipo utiliza su propia cuenta.
La versión para Windows incluye Git. No necesitas instalar Git ni GitHub Desktop por separado.
Para una historia privada, crea un repositorio privado. Ese repositorio contiene tu historia. Mantén la wiki pública en otro repositorio.

Haz clic en el nombre del proyecto, arriba a la izquierda, y elige Set up team o el estado actual del equipo. Selecciona Sign in with GitHub.
VNLE muestra un código corto y abre GitHub en el navegador. Inicia sesión allí, introduce el código y autoriza la conexión.
Vuelve a VNLE. Tras la confirmación, aparece el nombre de tu cuenta. No introduces tu contraseña en VNLE.
Abre el enlace de acceso a los repositorios. Elige Only select repositories y selecciona tu historia. Confirma con Install o Save y actualiza la lista de repositorios en VNLE.

2 · Publicar un nuevo proyecto de equipo

En GitHub, elige + → New repository, arriba a la derecha. Escribe un nombre como harbour-story y selecciona Private. Para este nuevo repositorio, deja README, .gitignore y License vacíos. Pulsa Create repository.
En VNLE, elige el repositorio de la lista o pega su dirección en GitHub Repository.
Introduce el nombre y el correo que se asociarán a tus versiones. Puedes usar tu dirección noreply de GitHub → Settings → Emails. Pulsa Connect locally.
Describe brevemente tus cambios. Elige Compare with team. VNLE guarda, crea una versión local y comprueba la del equipo. Después pulsa Send to GitHub para compartir tu trabajo.
Abre el repositorio en el navegador y comprueba que aparezcan project.vnle.json y las carpetas del proyecto. Invita a tus compañeros en Settings → Collaborators.

3 · Únete a un proyecto existente

Acepta la invitación de GitHub. Elige Download team project en la pantalla de inicio de VNLE e inicia sesión en GitHub.
Selecciona el repositorio del equipo y una ubicación para tu copia de trabajo local. Descarga el proyecto y ábrelo en VNLE.
Abre esa carpeta en VNLE con Open project. Inicia sesión en GitHub desde la opción de equipo del menú del proyecto y comprueba el acceso al repositorio.
Sincroniza antes de editar. Trabaja en tu escena, compara de nuevo al terminar y elige Send to GitHub.

Comprender el estado

Set up team indica que falta completar la configuración. Not sent yet significa que hay trabajo local pendiente de envío. Team updates available indica que otros miembros han enviado cambios. Up to date significa que todo coincidía en la última comprobación. Status not checked indica que no se pudo consultar GitHub, por ejemplo sin conexión. VNLE comprueba los proyectos configurados aproximadamente cada dos minutos.

Cuando ambos cambiaron el mismo contenido

Elige Compare with team. Los cambios independientes se combinan. Si el mismo contenido se ha modificado de formas distintas, VNLE muestra una revisión.
Compara Your version y Team version. Elige qué versión conservar para cada elemento afectado.
Pulsa Validate choices and sync. VNLE comprueba el proyecto combinado antes de sustituir tu versión de trabajo. Después elige de nuevo Compare with team y, a continuación, Send to GitHub.
Si tienes dudas, elige Decide later y habla con tu equipo sobre el contenido. Tu trabajo guardado se conserva.

Siempre que sea posible, acordad quién edita cada escena. Coordinad también los cambios en personajes, variables y traducciones compartidos. Aplicar una nueva versión del equipo recarga el proyecto y finaliza la vista previa y la sesión actual de deshacer.

Si la sincronización falla

Comprueba primero tu conexión a Internet. Inicia sesión de nuevo si ha caducado la autorización. Verifica que la aplicación VNLE tenga acceso a este repositorio y que tu cuenta tenga permiso de escritura. Si la versión del equipo cambió durante la revisión, descárgala de nuevo y repite la sincronización. Conserva la carpeta del proyecto mientras resuelves el problema.