Documentation git

Git est un gestionnaire de versions décentralisé.
Source Wikipédia

• Manual
• Livre Pro-Git
• Git Gitlab doc
• Git Github doc
• Git Bitbucket doc

Démarrage

Un dépôt git doit contenir 3 fichiers :

• un fichier readme.md qui introduit et explique votre projet :

  • https://www.makeareadme.com/
  • https://readme.so/fr
  • https://github.com/matiassingers/awesome-readme

• un fichier .gitignore qui permet de spécifier les fichiers,dossiers à ne pas suivre:

  • https://gitignore.io
  • https://github.com/github/gitignore

• fichier LICENSE.md qui définit la licence d'utilisattion de votre projet:

  • Licence logiciel
  • Licence juridique
  • Pourquoi vous devriez vous intéresser aux licences de vos logiciels ?
  • Licence Creative Commons

Configurer git

La configuration suivante se fait au niveau global de la machine , on peut également faire cette configuration au niveau local c'est à dire pour le dépôt dans lequel on se trouve.

Donner un nom à l'utilisateur de git sur sa machine:
git config --global user.name "nom_prenom"

Donner une adresse email à l'utilisateur de git sur sa machine:
git config --global user.email "une_adresse_email"

Définir main comme branche principale d'un dépot:
git config --global init.defaultBranch main

Indiquer à git d'utiliser une fusion (merge) classique plutôt qu'une réorganisation (rebase) quand vous faites git pull:
git config --global pull.rebase false

Permet d'utiliser VSCode comme éditeur avec git:
git config --global core.editor "code --wait"

Créer un nouveau dépôt en ligne de commande

touch README.md LICENCE.md .gitignore
git init
git add *
git commit -m "Debut du prjet initialisation"
git branch -M main (renommer branche principale si besoin)
git remote add origin https://github.com/user/nom-depot.git
git push -u origin main

Envoyer(push) un dépôt existant en ligne de commande

git init
git remote add origin https://github.com/user/nom-depot.git
git branch -M main (renommer branche principale si besoin)
git push -u origin main

Travail avec git au quotidien

• git pull Importer le travail du dépôt distant
• git status Vérifier l'état de votre dépôt
• git add fichier(s) ou git add * Ajouter les fichiers modifiés pour être prêt à être suivis
• git commit ou git commit -m "Sujet du commit" Enregistrer vos modifications
• git push Envoyer votre travail sur le dépôt distant

Commits

• Conventional commits format
• Git : pourquoi écrire des commits atomiques ?
• Qu'est ce qu'un bon commit ?

Méthode de travail avec git

• Comparing Git Workflows: What You Should Know
• Workflow Gitflow
• Développement basé sur le tronc
• About collaborative development models

Articles relatifs à git

• The Best Git Tutorials
• Git Best Practices – How to Write Meaningful Commits, Effective Pull Requests, and Code Reviews
• Git Best Practices – A Guide to Version Control for Beginners

Configuration SSH

Docuemntation Github

Documentation Gitlab

Setting up SSH-Agent in Windows for Passwordless Git Authentication

Cli

On peut gérer ses comptes github et gitlab en ligne de commande:

• gh
• glab