Introduction à Git et GitHub – Partie 2

Git and GitHub part 2

Dans cette deuxième partie du tutoriel d’introduction à Git et GitHub, vous rentrerez dans le vif du sujet en manipulant les différents concepts théoriques expliquées au sein de la partie précédente.

Prérequis

Installation de Git

Dans un premier temps, vous devez installer Git en vous rendant sur la page officielle de téléchargement.

Mission

Téléchargez Git en choisissant la version appropriée à votre OS (Windows, Linux, Mac, …).

Création d’un nouveau repository sur GitHub

Repository mine

Une fois Git installé, la prochaine étape consiste à créer un compte sur la plateforme GitHub. Cela vous permettra de d’initialiser votre premier dépôt (repository).

Mission

Créez un compte GitHub via la page d’inscription.

C’est maintenant que les choses sérieuses vont pouvoir commencer. Je vais d’abord vous montrer pas à pas les différentes étapes à réaliser, puis ce sera à votre tour de les reproduire :

  • Pour commencer, j’appuie sur le bouton “+” situé en haut à gauche de la page. Cela me permet de sélectionner l’option “New repository”.

New repository

  • Je rentre ensuite les différentes détails de mon repository :
    • Son nom : Pour rester dans l’histoire de la partie précédente, je vais l’appeler la “repository-mine”, mais libre à vous de choisir le nom qui vous plaît !

      Attention

      Les espaces ne sont pas autorisés dans le nom du repository : il ne peut seulement contenir des lettres ASCII, des chiffres, ainsi que les caractères “.”, “_”, et “-”.

    • Sa description : Pour détailler en une ligne ou deux en quoi consistera le projet.
    • Sa visibilité : Sur GitHub, vous pouvez choisir de rendre un repository public ou privé. Un repository public sera visible par toute personne consultant votre profil, tandis qu’un repository privé ne sera accessible qu’à vous (ou aux personnes que vous y autorisez). Dans le cadre du tutoriel, je rends le mien public, mais encore une fois, vous êtes libre de choisir l’option qui vous convient.

Repository details

  • Remarquez que je coche également l’option pour ajouter un README à mon repository. Un README est un fichier contenant une présentation du projet et les informations essentielles pour en comprendre l’objectif et l’utilisation. Je rentrerai dans ses détails une autre fois car ce n’est pas le cœur du tutoriel, mais il est fortement conseillé de cocher cette option à chaque création de repository.

  • Enfin, je n’ai plus qu’à appuyer sur “Create repository” et observer mon repository tout neuf !

A setup repository

Mission

Suivez les étapes détaillées ci-dessus afin de créer un repository.

Clonage du repository en local sur votre machine

Local copy
Le chariot est l'équivalent de la copie locale du repository.

Pour le moment votre repository n’est accessible que sur GitHub, il sera plus pratique d’avoir une copie locale sur votre ordinateur pour y ajouter vos fichiers, modifications etc. C’est l’objectif principal de cette section.

Quelque soit votre système d’exploitation, vous pouvez copier le lien GitHub associé à votre repository en cliquant sur Le bouton vert “<> Code” puis sur l’icône “copier”. Vérifiez que le lien copié est bien le lien “HTTPS”.

Copy to clipboard

Comme les étapes suivantes diffèrent selon que vous soyez sur Windows ou Linux/Mac, la suite de cette introduction est séparée en deux sections. Dans chacune d’elles, je vous montre comment cloner repository-mine en local en utilisant le système d’exploitation correspondant. Vous pouvez ainsi suivre la section adaptée à votre environnement.

Cloner un repository sur Windows
  • Sur mon ordinateur, je choisis l’emplacement où cloner le dossier du projet, par exemple dans mon dossier “Documents”. Une fois l’emplacement décidé, je réalise un clic droit dans l’explorateur de fichiers, pour sélectionner “Plus d’options”, puis “Git Bash Here” :

Git Bash Here

  • Après avoir cliqué sur l’option “Git Bash Here”, un terminal s’ouvre, me permettant d’utiliser les commandes Git :
MINGW64:/c/Users/Mowibox/Documents
Mowibox@CHROMA MINGW64 ~/Documents
$
  • La console Git étant lancée, je n’ai plus qu’à exécuter la commande git clone suivie de l’adresse HTTPS copiée précédemment. Dans mon cas, cela donnerait :
MINGW64:/c/Users/Mowibox/Documents
Mowibox@CHROMA MINGW64 ~/Documents
$ git clone https://github.com/Mowibox/repository-mine.git
  • Il ne me reste plus qu’à exécuter la commande pour voir apparaître le dossier dans mon explorateur de fichiers.

Your repository (Windows)

Cloner un repository sur Linux/Mac
  • Sur mon ordinateur, je choisis un emplacement dédié dans l’explorateur de fichiers, par exemple dans mon dossier “Documents”. Avec un clic droit dans l’explorateur, je sélectionne l’option “Open in terminal” ce qui me permet d’avoir un terminal ouvert directement dans l’emplacement “Documents” :

Open in terminal

mowibox@chroma:~/Documents
mowibox@chroma:~/Documents$

Remarque : Il est aussi possible d’ouvrir directement un terminal sans passer par l’explorateur avec le raccourci “Ctrl + Alt + T” (ou “Cmd + Alt + T”), et ensuite se rendre manuellement dans l’emplacement de votre choix via la commande cd.

  • Le terminal ouvert, je n’ai plus qu’à exécuter la commande git clone suivie de l’adresse HTTPS copiée précédemment. Dans mon cas, cela donnerait :
mowibox@chroma:~/Documents
mowibox@chroma:~/Documents$ git clone https://github.com/Mowibox/repository-mine.git
  • Il ne me reste plus qu’à exécuter la commande pour voir apparaître le dossier dans mon explorateur de fichiers.

Your repository (Linux/Mac)

Mission

Clonez votre repository fraîchement créé en local sur votre machine.

Apport de modifications au projet

Creating file A class=

En entrant dans le dossier, vous devriez y apercevoir le fichier “README.md”. C’est à l’intérieur qu’il est possible de créer tous les dossiers ou fichiers dont vous aurez besoin pour votre projet. Dans le mien, je vais créer un simple fichier texte nommé, dans lequel j’écris le texte suivant :

Fichier_A.txt
Hello, World!

Mission

Créez un ou plusieurs fichiers au sein du repository. Faites vous plaisir sur le contenu !

Maintenant que mon fichier est en place, constatez que sur GitHub le fichier n’apparaît pas. En effet il faut exécuter une série de commandes pour l’ajouter au repository distant (sur GitHub).

Pour ce faire j’ouvre un terminal au sein du repository de la même manière qu’expliqué précedemment. Puis, j’exécute ensuite les commandes suivantes :

  • git add .

    La commande git add . permet d’ajouter tous les fichiers créés ou modifiés à la zone de préparation (qu’on appelle staging area). Le . indique à Git d’inclure toutes les modifications présentes dans le dossier courant et ses sous-dossiers.

    Adding file A

  • git commit -m "Message"

    La commande git commit -m "Message" permet d’enregistrer et valider les modifications ajoutées avec git add. De manière générale, on ajoute toujours un message descriptif de la modification grâce au flag -m "Message explicatif". Par exemple :

    git commit -m "Ajout du fichier A"

    Writing file A commit

  • git push

    La commande git push permet d’envoyer les commits sur le repository distant, c’est-à-dire GitHub.

    Push file A

Au bout des différentes étapes illustrées ci-dessus, je peux finalement voir mon fichier “Fichier_A.txt” et son contenu sur GitHub :

Repository after pushing

File A

Mission

Utilisez les commandes add, commit et push pour ajouter vos modifications sur le repository distant. N’oubliez pas de spécifier un message avec -m "Message" lors du commit !

Astuce

Si quelqu’un possède une copie locale de votre repository sur son ordinateur, il pourra récupérer les dernières modifications en utilisant la commande git pull. Lorsque vous ouvrez un repository, lancez toujours cette commande en premier pour être sûr d’avoir la version la plus à jour.

Pull

Suppression de fichiers du projet

Sachez que comme pour l’ajout de fichiers, il est possible de supprimer des fichiers. La commande :

git rm nom_du_fichier

vous permet de supprimer un fichier du projet dont vous aurez spécifié le nom. Comme pour git add, il faut faire suivre la commande par git commit, puis git push.

Voilà un exemple où j’ai supprimé le “Fichier_A.txt” en appliquant les différentes commandes :

Repository after deleting

Mission

Utilisez les commandes rm, commit et push pour supprimer un de vos fichiers du projet. N’oubliez pas le message de commit !

Astuce

Une autre méthode de suppression consiste à supprimer le fichier manuellement, puis d’utiliser la commande git add . : cela revient à ajouter une modification au projet, qui est la suppression du fichier.

Tableau récapitulatif des commandes

Ce tableau récapitule l’ensemble des fonctions vues au cours de ce tutoriel ainsi que leur utilité. N’hésitez pas à le garder sous la main au début pour vous familiariser avec les commandes !

CommandeDescription
git pullRécupère les dernières modifications depuis le repository distant et met à jour votre copie locale.
git addAjoute des fichiers créés ou modifiés à la staging area.
git rmSupprime un fichier du projet et informe Git de cette suppression.
git commitEnregistre les modifications ajoutées avec un message (-m "Message") décrivant l’action effectuée.
git pushEnvoie vos commits vers le repository distant.

Dans la prochaine partie de cette introduction, nous allons explorer plus en profondeur les fonctionnalités offertes par Git et GitHub en nous attaquant à un concept plus complexe mais très pratique lorsque vous travaillez à plusieurs sur un même projet : les branches & les pull requests.


Crédits