1. Qu'est-ce que git, qu'est-ce que github ?

GitHub est une plateforme de partage de code, sur laquelle vous pouvez publier des projets dont le code est géré avec le système de contrôle de version Git. Par défaut, le système est open source, ce qui signifie que tout le monde peut consulter le code, l'utiliser pour l'apprendre ou l'améliorer, et collaborer sur des projets. Vous pouvez donc participer à d'autres projets ou, à l'inverse, des personnes peuvent collaborer sur vos projets!
Dans un prochain tuto, nous allons voir comment publier du contenu sur le web en utilisant les "pages GitHub" (aussi appelées gh-pages) qui sont l'une des fonctionnalités de GitHub.

2. Télécharger et installer Git

Par défaut, Git est installé sur Linux et macOS. Cependant, Microsoft Windows n'inclut pas de commande Git. Vous trouverez ci-dessous les étapes à suivre pour installer et utiliser Git et GitHub sur Microsoft Windows.

1. Télécharger Git: Visiter le site officiel de Git , choisissez la version qui correspond à votre système: Windows, Linux, Mac... Et cliquez sur le lien télécharger Git. Le téléchargement devrait démarrer automatiquement.
2. Lancez l'installation : Une fois téléchargé, lancez l'installation depuis le navigateur ou depuis le dossier de téléchargement.
3. Choix des options : Dans la fenêtre Sélectionner les composants, laissez toutes les options par défaut cochées et cochez les autres composants supplémentaires que vous souhaitez installer:
4. Choix de l'éditeur: Ensuite, dans la section Choix de l'éditeur par défaut utilisé par Git, sauf si vous êtes à l’aise avec Vim, nous vous recommandons fortement d'utiliser un éditeur de texte que vous connaissez bien. Si Notepad++ est installé, nous suggérons de l'utiliser comme éditeur:
5. Variable d'environnement PATH : Enfin, dans la section Ajustement de votre variable d'environnement PATH, nous vous recommandons de conserver l'option Utiliser Git par défaut dans l'invite de commande Windows, comme illustré ci-dessous. Cette option vous permettra d'utiliser Git à la fois depuis Git Bash et l'invite de commande Windows:
6. section Utiliser OpenSSH : Nous vous recommandons ensuite de conserver la valeur par défaut sélectionnée dans la section Utiliser OpenSSH.
7. Ensuite, dans la section Choix du moteur HTTPS : laissez la valeur par défaut Utiliser la bibliothèque OpenSSL sélectionnée:

Une fois l'installation terminée, vous pouvez cocher l'option Lancer Git Bash si vous souhaitez ouvrir une ligne de commande Bash. Si vous avez choisi d'utiliser l'invite de commande Windows, vous pourrez exécuter Git directement depuis celle-ci.

Remarque

Nous vous recommandons fortement d'utiliser Git à partir de la ligne de commande et de ne pas utiliser d'interface graphique. Vous n'utiliserez que la ligne de commande de l'interface Git pour gérer les fichiers. L'édition peut toujours être effectuée via un éditeur de texte ou un IDE de votre choix.

3. Créez un compte GitHub et un nouveau dépôt.

GitHub est une plateforme gratuite de partage de code, tout le monde peut créer un compte gratuit : https://github.com/signup.
Après avoir créé votre compte, vous pouvez vous connecter : https://github.com/login et créer un nouveau dépôt : https://github.com/new.
Vous pouvez choisir les options pour votre dépôt : public ou privé, ajouter ou ne pas ajouter un fichier README..., puis cliquez sur le bouton Créer le dépôt pour créer votre premier dépôt:

4. Configurer votre nom et votre email avec Git

Avant d'utiliser Git, vous devez configurer votre nom et votre email afin que Git puisse les associer à vos commits. Exécutez les commandes suivantes dans votre terminal (en remplaçant les informations par les vôtres) :

Configurer votre nom:

Configurer votre email:

Cela permet à Git de savoir qui effectue les modifications dans le dépôt.

5. Initialiser un nouveau dépôt Git local et pousser le vers votre dépôt en ligne

5.1 Initialiser le dépôt local

Dans le terminal, naviguez vers le répertoire de votre projet et initialisez un nouveau dépôt Git avec la commande suivante:

5.2 Vérifier l'état du dépôt

Ensuite, vous pouvez vérifier l'état de votre dépôt pour voir les fichiers non suivis ou modifiés en cours de suivi:

5.3 Ajouter les fichiers

Ajoutez tous les fichiers de votre projet au suivi Git avec la commande suivante:

Cela ajoutera tous les fichiers modifiés, nouveaux ou supprimés à l'index de Git pour les préparer à être commis.

5.4 Faire le premier commit

Maintenant, réalisez le premier commit avec un message décrivant ce que vous avez fait:

5.5 Ajouter le dépôt distant (URL de votre dépôt GitHub)

Ajoutez l'URL de votre dépôt GitHub comme dépôt distant. Remplacez yourusername et myrepository par votre propre nom d'utilisateur et le nom du dépôt:

5.6 Renommer la branche si nécessaire (main est le nom recommandé)

Si vous utilisez une branche principale autre que main (comme master), vous pouvez la renommer. Il est recommandé d'utiliser main:

5.7 Pousser le projet vers GitHub

Enfin, poussez vos modifications vers GitHub sur la branche main. Vous pouvez utiliser la commande suivante pour envoyer vos fichiers au dépôt distant:

La première fois, cela vous demandera vos identifiants GitHub si vous utilisez HTTPS. Si vous utilisez SSH, la connexion se fait automatiquement si votre clé SSH est correctement configurée.

6. Annuler ou supprimer un remote assigné par erreur!

Si vous avez ajouté un remote avec une erreur (mauvaise URL, mauvais nom, etc.), vous pouvez le supprimer et le remplacer par le bon.

6.1 Vérifier les remotes existants

Exécutez la commande suivante pour voir la liste des remotes:

Cela affichera quelque chose comme:

6.2 Supprimer le remote incorrect

Si le remote incorrect est nommé origin, utilisez:

Ou la version alternative:

6.3 Ajouter le bon remote

Ajoutez maintenant le bon dépôt GitHub:

6.4 Vérifier que le nouveau remote est bien pris en compte

Refaites :

Vous devez voir la bonne URL associée à origin:

6.5 Pousser les modifications avec le bon remote

Si tout est bon, vous pouvez maintenant pousser votre code:

(Remplacez main par master si nécessaire).

 

Younes Derfoufi
CRMEF OUJDA