Procédure détaillée pour synchroniser un dépôt local avec un dépôt GitHub existant sous Windows

• Auteur : ACOMDIR https://www.facebook.com/acomdir/.

Attention : GitHub propose deux branches (répertoires dépôts) : main ou master. Nos exemples sont construites sur la branche master.

La commande git branch vous permet de lister toutes les branches disponibles et met en évidence la branche active avec un astérisque (*) de votre compte GitHub.

Étape 1 : Démarrer l'IDE CMD en mode administrateur

1. Appuyez sur la touche Windows pour ouvrir le menu démarrer.
2. Tapez cmd dans la barre de recherche.
3. Faites un clic droit sur l'option Invite de commandes et sélectionnez Exécuter en tant qu'administrateur.

Astuce : Vérifiez si votre version de Git est à jour en exécutant cette commande dans l'invite de commandes :

git update-git-for-windows

Étape 2 : Accéder au répertoire de destination local

Une fois l'invite de commandes ouverte, utilisez la commande cd pour naviguer vers le répertoire où vous souhaitez cloner le dépôt GitHub. Par exemple :

cd C:\Users\VotreNomUtilisateur\Documents\MesProjets

Remplacez VotreNomUtilisateur et MesProjets par les noms correspondants sur votre machine.

Étape 3 : Cloner le dépôt GitHub

Si Git n'est pas installé :

1. Téléchargez Git à partir de git-scm.com.
2. Installez Git en suivant les instructions du programme d’installation.
3. Vérifiez l’installation en exécutant :

git --version

Pour cloner le dépôt :

git clone https://github.com/Aranook/Apprendre-GitHub.git

Cette commande crée un dossier local nommé Apprendre-GitHub, contenant tous les fichiers et l'historique du dépôt distant.

Étape 4 : Naviguer dans le dépôt cloné

Une fois le dépôt cloné, entrez dans le répertoire créé :

cd Apprendre-GitHub

Étape 5 : Effectuer des modifications et synchroniser avec GitHub

1. Ajouter des modifications au suivi Git :

git add .

Ou pour un fichier spécifique :

git add nom_du_fichier

2. Créer un commit :

git commit -m "Description de vos modifications"

3. Pousser les modifications vers GitHub :

git push origin main

Remarque : Remplacez main par le nom de votre branche si nécessaire.

Étape 6 : Vérifications supplémentaires

Vérifiez l’état du dépôt local :

git status

Pour synchroniser avec les dernières mises à jour du dépôt distant :

git pull origin main

Remplacez main par le nom de la branche utilisée.

Pourquoi remplacer main par un autre nom de branche ?

Un dépôt peut contenir plusieurs branches. Voici quelques exemples de conventions :

• main : branche principale par défaut récente.
• master : ancien nom par défaut.
• dev : utilisée pour le développement en cours.

Pour connaître la branche active :

git branch

Affiche les branches locales avec un astérisque (*) sur la branche active.

Pour afficher les branches distantes :

git branch -r

Gestion des branches

• Créer une nouvelle branche :

git checkout -b nom_nouvelle_branche

• Pousser une nouvelle branche :

git push origin nom_nouvelle_branche

• Changer de branche :

git checkout nom_branche

Conclusion

Adaptez les commandes Git selon la structure des branches de votre dépôt pour garantir une gestion fluide et éviter les conflits.