Git : fonctionnalités de base

Petit mémo rapide sur Git
Dans cette approche basique de git, nous partons du principe simple que vous êtes seul à travailler sur votre projet et que toutes vos modifications seront enregistrées sur la branche principale appelée “master”.

Pour commencer par le plus simple, le mieux est de créer votre projet (appelé dépot) sur une forge comme framagit.org qui contient beaucoup d'autres projets.

Il est absolument nécessaire d'avoir un compte avec un identifiant mémorisé et son mot de passe à saisir (régulièrement pour l'instant). Utiliser le lien “Sign In” en haut à droite puis l'onget Register pour créer votre compte.

Une fois votre compte créé, vous pouvez créer un projet comme “monprojet”. Vous pouvez choisir de rendre ce projet public ou le garder privé (lire les options).

Vous pouvez y ajouter un fichier README.md qui servira de descriptif de présentation de votre projet.
Lorsque vous sauvegardez un fichier dans l'interface, il vous est demandé de compléter un champ “commit” qu'il est utile de personnaliser à chaque modification.
Par exemple : “Corrections ortho” ou “ajout du paragraphe” ou “ajout de telle fonctionnalité”.

Au préalable assurez-vous d'avoir le programme git installé sur votre Linux préféré :

sudo apt install git

Créez un dossier où vous voulez soit avec votre gestionnaire de fichiers, soit avec un terminal (mkdir mondossier) et placez-vous dedans (cd mondossier)

Retournez ensuite dans l'interface graphique de votre dépot et copier le lien du dépot sous le lien “clone” et choisissez de copier l'adresse en https pour l'instant.

Dans votre terminal, lancer la commande en collant (Ctrl+Shift+V) l'adresse de votre depot :

git clone https://framagit.org/monnom/monprojet.git

Patientez et vous devriez récupérez tout le contenu de votre dépot sur votre PC (avec l'historique des modifications)

cd monprojet
ls

Et vérifiez que votre fichier README.md est là avec les autres.

Vous pouvez ensuite modifier tous les fichiers existants ou rajouter des sous-dossiers avec des fichiers qui concernent votre projet.

Lorsque vous voulez sauvegarder l'état de votre projet (appelons-le l'état V1), il va falloir faire un commit.
Au préalable, vous devez indiquer quel fichier a été modifié et doit être pris en compte dans ce commit.
Vous pouvez utiliser la commande

git status

qui ne sert qu'à donner des informations, elle est sans risque
Vous pouvez soit ajouter chaque fichier à la main, soit les ajouter tous en une fois

git add fichiermodifié
git add * # pour les ajouter tous

Refaire un git status pour vérifier leur prise en compte

Lors du premier commit (photographie de votre état V1), git vous demandera des informations d'identification que vous pouvez saisir dès maintenant en remplaçant par les bonnes infos (ceci est juste à titre informatif, vous pouvez mettre ce que vous voulez)

git config --user "Votre nom ou pseudo"
git config --email "Votre email"

Pour effectuer votre commit , lancez :

git commit -m "Votre message de commit comme Version 1 du projet"

Et vous pouvez ensuite continuer de travailler sur vos documents, vous savez que vous pourrez toujours revenir sur cette version à n'importe quel moment (Nous verrons comment une autre fois)

Une fois que vous avez fait vos 25 commits, vous pouvez avoir envie de les stocker sur le dépot distant pour que d'autres puissent les récupérer ou que vous puissiez les récupérer depuis une autre machine par exemple.
Lancer alors un

git push

On vous demandera un login d'identifiant sur la forge : votre login
et un mot de passe : celui utilisé sur la forge

Et après quelques instants vos commits sont envoyés sur la forge

Pour voir l'état actuel de votre travail :

git status

Pour voir l'historique des logs :

git log

A lancer si votre dépôt a été modifié (par quelqu'un d'autre ou par vous depuis la derniére fois)

git pull

Pour indiquer une étape importante du code comme la Version stable V1

git tag "Version stable 1.0"