Utiliser GitHub sous Windows

Comment mettre en ligne un projet quand on programme sous Windows. Une expérience.

GitHub est devenu le site d'hébergement de projet le plus populaire grâce aux facilités offertes pour permettre les contributions au code d'un logiciel. Ce n'est pas le seul hébergeur gratuit basé sur le logiciel de contributions partagées Git, créé initialement pour Linux, mais c'est ici que sont mis en ligne la plupart des projets.

Il était difficile il y a encore peu de temps d'utiliser GitHub avec un poste local sous Windows, mais c'est maintenant une époque révolue, et à condition de connaître exactement la marche à suivre, la création d'un dépôt et l'envoi du code sont devenus très aisés.

Tout se passe en trois étapes...

1) Créer un compte

Aller sur github.org et créer un compte. Vous pouvez aussi créer un "repository" avec le nom de votre projet, mais ce n'est pas nécessaire.

2) Créer le projet

On suppose que le code est déjà écrit, et qu'il se trouve dans le répertoire "monprogamme".

Télécharger le logiciel à interface graphique GitHub for Windows. Ce logiciel va se charger de transformer votre répertoire contenant votre code-source en projet prêt à télécharger.

Entrez le nom de votre compte sur GitHub et votre mot de passe. Ces données sont conservées et chaque fois que lancerez le progamme, vous serez connecté automatiquement.

Comme on le voit ci-dessous, l'interface propose de glisser/déposer le répertoire contenant vos sources...

C'est tout ce qu'il y a à faire pour créer le projet. Ceci une fois accompli, je recommande d'abandonner ce logiciel. Il permet théoriquement aussi de mettre les fichiers en ligne, mais cela ne fonctionne jamais et on ne peut jamais savoir pourquoi.

Avant de continuer, il faut aussi aller dans le répertoire de votre projet et supprimer le fichier automatiquement généré .gitignore, car il peut contenir des limitations qui ne correspondant pas à votre liste de fichiers.

3) Mettre le code en ligne dans le repository

Pour mettre le code en ligne, le Shell de commande est le meilleur outil. C'est une fenêtre Powershell créée par le même programme destiné à Windows.

Ouvrir donc le Git Shell, et entrez dans le répertoire de votre projet. Alors, la ligne suivante s'affiche:

c:\monprogramme [master]>

Par défaut, votre projet est la branche maîtresse. Nous ne discuterons pas la création de branches multiples dans cet article.

Pour mettre le code en ligne la première fois:

git add .
git commit -m "infos"
git push origin master

Remplacer "infos" par le texte que vous voulez voir afficher sur le site GitHub et qui décrit le "commit", autrement dit cette version du projet.

Vérifier sur le site GitHub que le projet est bien créé et que la liste des fichiers y figure.

Pour supprimer des fichiers:

Effacer les fichiers dans le répertoire local du projet, puis tapez:

git add -u
git commit -m "Update"
git push origin master

Remplacez "Update" par le texte informatif de votre choix.

Pour ajouter des fichiers ou remplacer des fichiers existants:

git add -A
git commit -m "Update"
git push origin master 

Ces commandes suffisent à créer une image en ligne du projet et la mettre à jour après chaque modification du code source.

Après avoir vérifié sur le dépôt que tous les fichiers sont présents, et nécessaires au projet, vous pouvez encore ajouter un fichier spéficique, utilisez la commande:

git add nom-de-fichier

et:

git rm nom-de-fichier

pour en supprimer un...

Tweet