Manuel VNLE

Collaborer avec GitHub

La description des modifications est facultative. Si elle reste vide, VNLE utilise Update lors de l’envoi.

Vous travaillez sur votre ordinateur. GitHub conserve la version partagée en ligne. Save enregistre localement. Compare with team vérifie et intègre les modifications de l’équipe. Send to GitHub partage votre version préparée. Vous pouvez écrire hors ligne et partager votre travail plus tard.

Avant de commencer

Créez un compte gratuit sur github.com. Chaque coéquipier utilise son propre compte.
La version Windows inclut Git. Vous n'avez pas besoin d'installer Git ou GitHub Desktop séparément.
Pour une histoire privée, créez un dépôt privé. Ce dépôt contient votre histoire. Gardez le wiki public dans un dépôt différent.

Cliquez sur le nom du projet en haut à gauche et choisissez Set up team ou l’état actuel de l’équipe. Sélectionnez Sign in with GitHub.
VNLE affiche un code court et ouvre GitHub dans votre navigateur. Connectez-vous, saisissez le code et autorisez la connexion.
Revenez dans VNLE. Votre nom de compte apparaît après confirmation. Vous ne saisissez pas votre mot de passe dans VNLE.
Ouvrez le lien d’accès aux dépôts. Choisissez Only select repositories et sélectionnez votre histoire. Confirmez avec Install ou Save, puis actualisez la liste des dépôts dans VNLE.

2 · Publier un nouveau projet d'équipe

Dans GitHub, choisissez + → New repository en haut à droite. Saisissez un nom tel que harbour-story et choisissez Private. Pour ce nouveau dépôt, laissez README, .gitignore et License vides. Cliquez sur Create repository.
Dans VNLE, sélectionnez le dépôt dans la liste ou collez son adresse dans GitHub Repository.
Saisissez le nom et l’adresse e-mail à associer à vos versions. Vous pouvez utiliser votre adresse noreply indiquée dans GitHub → Settings → Emails. Cliquez sur Connect locally.
Décrivez brièvement vos modifications. Choisissez Compare with team. VNLE enregistre, crée une version locale et vérifie celle de l’équipe. Cliquez ensuite sur Send to GitHub pour partager votre travail.
Ouvrez le dépôt dans votre navigateur et vérifiez la présence de project.vnle.json et des dossiers du projet. Invitez vos coéquipiers dans Settings → Collaborators.

3 · Rejoindre un projet existant

Acceptez l’invitation GitHub. Sur l’écran d’accueil de VNLE, choisissez Download team project et connectez-vous à GitHub.
Sélectionnez le dépôt d'équipe et une destination pour votre copie de travail locale. Téléchargez le projet et ouvrez-le dans VNLE.
Ouvrez ce dossier dans VNLE avec Open project. Connectez-vous à GitHub depuis l’entrée consacrée à l’équipe dans le menu du projet et vérifiez l’accès au dépôt.
Synchronisez avant de commencer à modifier. Travaillez sur votre scène, comparez de nouveau une fois terminé, puis choisissez Send to GitHub.

Comprendre le statut

Set up team signifie que la configuration est incomplète. Not sent yet indique que des modifications locales attendent d’être envoyées. Team updates available indique que des coéquipiers ont envoyé des modifications. Up to date signifie que les versions concordaient lors de la dernière vérification. Status not checked indique que GitHub n’a pas pu être vérifié, par exemple hors ligne. VNLE vérifie les projets configurés environ toutes les deux minutes.

Lorsque vous avez tous deux changé le même contenu

Choisissez Compare with team. Les modifications indépendantes sont combinées. Si un même contenu a été modifié de deux façons différentes, VNLE vous propose de les examiner.
Comparez Your version et Team version. Choisissez la version à conserver pour chaque élément concerné.
Cliquez sur Validate choices and sync. VNLE vérifie le projet combiné avant de remplacer votre version de travail. Choisissez ensuite à nouveau Compare with team, puis Send to GitHub.
En cas de doute, choisissez Decide later et discutez-en avec votre équipe. Votre travail enregistré est conservé.

Convenez autant que possible de la personne qui modifie chaque scène. Coordonnez aussi les changements apportés aux personnages, variables et traductions partagés. Appliquer une nouvelle version de l’équipe recharge le projet et met fin à l’aperçu et à la session d’annulation en cours.

Si la synchronisation échoue

Vérifiez d'abord votre connexion Internet. Connectez-vous à nouveau si votre autorisation a expiré. Vérifiez que l'application VNLE a accès à ce dépôt spécifique et que votre compte a la permission d'écrire. Si la version de l'équipe a changé pendant que vous revoyiez, allez la chercher à nouveau et répétez la synchronisation. Gardez votre dossier de projet lors du dépannage.