À-propos de Git

Le site officiel de git est git-scm.com.

Documentation à propos de git

Un peu en vrac, mais quand même dans l'ordre du plus utile au plus flou :

• doc.ubuntu-fr.org/git est concis mais est une bonne introduction,
• ce premier tutoriel par l'équipe de Bitbucket (Atlassian) (en anglais),
• ce site de référence GitImmersion.fr.
• www.Atlassian.com/git/ couvre plein de choses. J'aime bien le style (graphique et structurel) de ces explications (en anglais).
• le livre de référence officiel sur git-scm.com,
• le site help.GitHub.com est bien conçu (surtout en anglais),
• ce dernier tutorial (en anglais) sur readwrite.com est très bien rédigé (seconde partie).

Deux documents en PDF à télécharger pour ne pas paniquer quand on est paumé ou qu'on débute :

• Le premier est en français, rédigé par training.GitHub.com,
• Une autre en anglais, faite par Atlassian.

D'autres ressources (moins utiles, mais peuvent aider) :

• fr.wikibooks.org/wiki/Git.
• cet autre tuto non officiel sur git et Bitbucket,
• ce troisième tuto est moche mais peut être utile.
• ce petit livre en français,
• Une page intitulée « Démarrer avec Git » par Robusta Code.

Note

Et comment ça marche, en vrai, sous le capot des jolis sites web et de l'utilisation en lignes de commande ? C'est compliqué (théoriquement) ? :red:`Oui.`

Ma configuration

Pour ces deux fichiers de configurations, (sur Linux), un fichier .gitconfig et .gitignore global peut se trouver dans votre dossier HOME (~/, ou /home/pseudo), et un fichier particulier à chaque dépôt peut aussi être créé.

• .gitconfig permet de configurer le comportement complet de git (inspiré par celui des cranseux).
• .gitignore permet de dire quels fichiers doivent être ignorés (ie. non observés) par git lorsqu'il indique les fichiers non surveillés.

En ligne de commande

Voir mon bash_aliases (aussi sur Bitbucket.org/lbesson/bin). Je définis les alias Bash suivants, qui permettent de voir les fichiers modifiés, supprimés ou ajoutés uniquement :

• alias GitChanged='clear ; git status | grep --color=always '\(modified\|modifié\)' | less -r' pour les fichiers modifiés,
• alias GitDeleted='clear ; git status | grep --color=always '\(deleted\|supprimé\)' | less -r' pour les fichiers supprimés,
• alias GitAdded='clear ; git status | grep --color=always '\(added\|nouveau\)' | less -r' pour les fichiers ajoutés,
• Et alias GitSize='clear; git count-objects -v -H | grep "size-pack" | sed s/"size-pack: "/"La taille du dépôt est "/' permet d'afficher la taille que prend le dépôt courant (e.g. 10.43 MO actuellement pour ce projet web-sphinx).

Ceux là sont de bons raccourcis, qui par défaut lance la compression locale du dépôt juste après chaque opération (en moyenne ça fait gagner du temps) :

• alias Push='clear; git push && git gc' pour téléverser les dernières modifications sur le dépôt mère,
• alias Pull='clear; git pull && git gc' pour télécharger les dernières modifications depuis le dépôt mère,
• alias Commit='clear; git commit -m' pour rapidement valider une modification (on dit alors réaliser un commit),
• alias Add='git add' pour facilement ajouter des fichiers,
• alias Aggressive='git gc --aggressive' lance une compression "agressive",
• alias s='clear ; git status | less -r' est un raccourcis bien pratique pour l'opération git la plus courante : git status.

Et enfin, j'ai défini un alias pratique qui permet de synchroniser le projet courant avec le dépôt mère, et son sous-dossier sur mon site.

• alias Sync='clear; echo -e "Synchronizing (git push, gc, send_zamok)..."; git push; git gc --aggressive; make send_zamok; alert'

Par exemple ce dépôt se trouve ici sur ce site (publis/ansi-colors). Cet autre dépôt se trouve ici sur ce site (publis/Bomberman). Ce troisième dépôt se trouve ici sur ce site (python-demos).

Avec Sublime Text 3

Les greffons suivants permettent une utilisation fluide et facile de git avec Sublime Text 3 :

• Le petit GitGutter permet de visualiser l'état de chaque ligne de chaque fichier par rapport au dépôt git dans lequel il se trouve (visuellement génial pour voir les changements depuis le dernier commit).
• Le plus lourd SublimeGit (installable depuis sublime.wbond.net/packages/SublimeGit). Permet un intégration complète de git via le panneau de contrôle. Il est gratuit, mais vous embêtera régulièrement afin de vous demander d'acheter une (inutile) licence commercial (pour 10$)... Mais ce plugin est vraiment génial, donc vous supporterez son petit défaut !
• GitSavvy semble être une bonne alternative gratuite et libre.

Avec Bitbucket.org

Comme d'autres services d'hébergement, Bitbucket est gratuit, flexible, puissant, opérationnel 24h/24, 7j/7, et permet de publier son code facilement sur Internet.

Note

GitHub propose en gros les mêmes (super) fonctionnalités, gratuitement aussi.

Bitbucket propose en plus des dépôts privés, en nombre illimités. Chaque dépôt est limité à 2GB (il faut vraiment le vouloir pour dépasser!). S'inscrire est rapide, il suffit d'aller sur cette page https://Bitbucket.org/ ! (Notez que Bitbucket peut aussi s'utiliser avec un compte Google, Facebook, GitHub ou même avec OpenID.)

Un fois votre profil créé, il ressemblera au mien, mais en plus vide : Bitbucket.org/lbesson (voir celui là pour un autre exemple Bitbucket.org/jilljenn).

Les dépôts publics sont visibles par tous : Bitbucket.org/lbesson/profile/repositories.

Par exemple, voici plusieurs de mes dépôts :

• Bitbucket.org/lbesson/web-sphinx stocke les sources de ce site, voir par exemple la source de cette page, écrite en reStructuredText (.rst) (→ lien direct sur cette ligne),
• Bitbucket.org/lbesson/bin héberge des douzaines de scripts, surtout en Bash et quelques uns en Python,
• Bitbucket.org/lbesson/web-sphinx-scripts stocke des versions locales de tous les scripts Javascript utilisés par ce site,
• Bitbucket.org/lbesson/cv stocke les sources \(\LaTeX{}\) de mes CV en français et en anglais : cv.fr.tex ou cv.en.tex,
• Bitbucket.org/lbesson/munstrap un tout petit dépôt proposant une traduction en français du thème Munstap, un thème adaptatif et moderne pour Munin.

Plus d'explications sont disponibles ici en.WikiPedia.org/wiki/Bitbucket (en anglais).

Un dernier conseil ?

Comme pour tout logiciel aussi puissant et technique, git demande un certain temps d'adaptation. Soyez persévérant, ça en vaut la peine.

« Je vous souhaite une bonne programmation, et bonne change pour vos projets !

Crédit additionnel

Merci à Vincent Cohen-Addad de m'avoir motivé à m'initier à git, en octobre 2012 pour le projet de programmation réseau de mon Master d'Informatique Fondamentale (le MPRI, cours #1-21) sur lequel nous avions travaillé ensemble.