git*: add French translation (#4619)

pages.fr/common/git-add.md

@@ -5,7 +5,7 @@
 
 - Ajouter un fichier à l'index :
 
-`git add {{path/to/file}}`
+`git add {{chemin/vers/fichier}}`
 
 - Ajouter tous les fichiers (suivis et non-suivis) :
 
@@ -20,5 +20,12 @@
 `git add -f`
 
 - Ajoute des parties de fichiers interactivement :
+`git add -p`
 
-`git add -p {{path/to/file}}`
+- Ajoute interactivement les parties d un fichier specifié :
+ 
+`git add -p {{chemin/vers/fichier}}`
+
+- Ajouter un fichier interactivement :
+
+`git add -i`

pages.fr/common/git-am.md

@@ -0,0 +1,17 @@
+# git am
+
+> Appliaquer des fichiers de path. Utile lorsque l on recoit des comits par email.
+> Voir aussi `git format-patch`, pour generer des ficheirs de patch.
+> Plus d informations: <https://git-scm.com/docs/git-am>.
+
+- Appliquer un fichier de patch :
+
+`git am {{chemin/vers/fichier.patch}}`
+
+- Annuler l'application d un fichier de patch :
+
+`git am --abort`
+
+- Appliquer autant de fichier de correctif que possible, en enregistrant les morceaux échoués pour rejeter le fichier :
+
+`git am --reject {{chemin/vers/fichier.patch}}`

pages.fr/common/git-annex.md

@@ -0,0 +1,29 @@
+# git annex
+
+> Gérez les fichiers avec git, sans archiver leur contenu.
+> Lorsqu'un fichier est annexé, son contenu est déplacé dans un stockage clé-valeur et un lien symbolique est créé qui pointe vers le contenu.
+> Plus d information: <https://git-annex.branchable.com>.
+
+- Aide :
+
+`git annex help`
+
+- Initialize le repo avec git annex :
+
+`git annex init`
+
+- Ajoute un fichier :
+
+`git annex add {{chemin/vers/fichier_ou_repertoire}}`
+
+- Affiche le statut courrand d un fichier ou repertoire :
+
+`git annex status {{chemin/vers/fichier_ou_repertoire}}`
+
+- Synchronise un repository local avec un distant :
+
+`git annex {{distant}}`
+
+- Recupére un ficheir ou un repertoire :
+
+`git annex get {{chemin/vers/fichier_ou_repertoire}}`

pages.fr/common/git-apply.md

@@ -0,0 +1,28 @@
+# git apply
+
+> Applique un correctif a un fichier et/ou a l index.
+> Plus d informations: <https://git-scm.com/docs/git-apply>.
+
+- Afficher les messages a propos des fichiers corrigés :
+
+`git apply --verbose {{chemin/vers/fichier}}`
+
+- Applique le correctif et ajoute les fichiers a l index :
+
+`git apply --index {{chemin/vers/fichier}}`
+
+- Applique un correctif depuis une source distante :
+
+`curl {{https://example.com/file.patch}} | git apply`
+
+- Affiche les differencs resultantes et applique le correctif :
+
+`git apply --stat --apply {{chemin/vers/fichier}}`
+
+- Applique le correctif en ordre inverse :
+
+`git apply --reverse {{chemin/vers/fichier}}`
+
+- Stocke le resultat du correctif dans l index sans modifier la branche courrante :
+
+`git apply --cache {{chemin/vers/fichier}}`

pages.fr/common/git-archive.md

@@ -0,0 +1,28 @@
+# git archive
+
+> Cree une archive de fichiers depuis un branche donée.
+> Plus d informations: <https://git-scm.com/docs/git-archive>.
+
+- Crée une archive .tar avec le contenu de la HEAD et l'affiche sur la sortie stanard :
+
+`git archive --verbose HEAD`
+
+- Crée une archive .zip avec le contenu de la HEAD et l'affiche sur la sortie stanard :
+
+`git archive --verbose --format=zip HEAD`
+
+- Pareil que ci-dessus mais ecrit dans l archive specifiée :
+
+`git archive --verbose --output={{chemin/vers/fichier.zip}} HEAD`
+
+- Crée une archive depuis le dernier commit de la branche spécifiée :
+
+`git archive --output={{chemin/vers/fichier.tar}} {{nom_de_branche}}`
+
+- Crée une archive avec le contenu d un repertoire donné :
+
+`git archive --output={{chemin/vers/fichier.tar}} HEAD:{{chemin/vers/repertoire}}`
+
+- Ajoutez un chemin d'accès à chaque fichier pour l'archiver dans un répertoire spécifique :
+
+`git archive --output={{chemin/vers/fichier.tar}} --prefix={{chemin/vers/cible}}/ HEAD`

pages.fr/common/git-bisect.md

@@ -0,0 +1,21 @@
+# git bisect
+
+> Utiliser une recherche binaire pour trouver le commit qui a introduit un bug.
+> Git saute automatiquement d'avant en arrière dans le graphe de commit pour isoler le commit défectueux.
+> Plus d'informations: <https://git-scm.com/docs/git-bisect>.
+
+- Démarrez une dissection sur une plage de commit délimitée par un bug connu et un commit propre connu (généralement plus ancien) :
+
+`git bisect start {{bad_commit}} {{good_commit}}`
+
+- Pour chaque `git bisect` selectionné, le marquer comme "bad" ou "good" apres l'avoir testé pour le probléme :
+
+`git bisect {{good|bad}}`
+
+- Apres que `git bisect` pointe vers le mauvais commit, terminer la dissection et retourner a la branche précedante :
+
+`git bisect reset`
+
+- Sauter un commit lorrs de la dissection (e.g. celui qui echoue les tests pour une autre raison) :
+
+`git bisect skip`

pages.fr/common/git-blame.md

@@ -0,0 +1,12 @@
+# git blame
+
+> Affiche le hash de commit et le dernier auteur de chaque ligne d un fichier.
+> Plus d'informations: <https://git-scm.com/docs/git-blame>.
+
+- Affiche le hash de commit et le nom de l auteur en face de chaque ligne :
+
+`git blame {{file}}`
+
+- Affiche le hash de commit le nom et l email de l auteur en face de chaque ligne :
+
+`git blame -e {{file}}`

pages.fr/common/git-branch.md

@@ -0,0 +1,36 @@
+# git branch
+
+> Commande git principale pour travailler avec des branches.
+> Plus d'informations: <https://git-scm.com/docs/git-branch>.
+
+- Liste les branches locale, prefixe la branche courrante avec `*` :
+
+`git branch`
+
+- Liste toutes les branches (locale et distantes) :
+
+`git branch -a`
+
+- Affiche le nom de la branche courrante :
+
+`git branch --show-current`
+
+- Crée une nouvelle branche depuis le commit courrant :
+
+`git branch {{nom_de_branche}}`
+
+- Crée une nouvelle branche depuis un commit en particulier :
+
+`git branch {{nom_de_branche}} {{commit_hash}}`
+
+- Renommer une branche (ne pas se trouver sur la branche pour le faire) :
+
+`git branch -m {{ancien_nom_de_branche}} {{nouveau_nom_de_branche}}`
+
+- Supprimer un branche locale (ne pas se trouver sur la branche pour le faire) :
+
+`git branch -d {{nom_de_branche}}`
+
+- Supprimer une branche distante :
+
+`git push {{nom_distant}} --delete {{nom_de_branche_distante}}`

pages.fr/common/git-bundle.md

@@ -0,0 +1,32 @@
+# git bundle
+
+> Empaquetez des objets et des références dans une archive.
+> Plus d'informations: <https://git-scm.com/docs/git-bundle>.
+
+- Empaquetez tout les objets et les refferences d'une branche spécifiée :
+
+`git bundle create {{chemin/vers/fichier.bundle}} {{nom_de_branche}}`
+
+- Crée un empaquetage de tout les fichiers de toutes les branches :
+
+`git bundle create {{chemin/vers/fichier.bundle}} --all`
+
+- Crée un empaquetage des 5 derniers commits de la branche courrante :
+
+`git bundle create {{chemin/vers/fichier.bundle}} -{{5}} {{HEAD}}`
+
+- Crée un empaquetage des 7 derniers jours :
+
+`git bundle create {{chemin/vers/fichier.bundle}} --since={{7.days}} {{HEAD}}`
+
+- Verifie qu'un empaquetage est valide et peut étre appliquer à la branche courrante :
+
+`git bundle verify {{chemin/vers/fichier.bundle}}`
+
+- Affiche sur la sortie standard la liste des réfferences contenues dans un empaquetage :
+
+`git bundle unbundle {{chemin/vers/fichier.bundle}}`
+
+- Extraire une branche spécifique d'un fichier de bundle dans le référentiel actuel :
+
+`git pull {{chemin/vers/fichier.bundle}} {{nom_de_branche}}`

pages.fr/common/git-cat-file.md

@@ -0,0 +1,16 @@
+# git cat-file
+
+> Fournir des informations sur le contenu ou le type et la taille des objets du référentiel git.
+> Plus d'informations: <https://git-scm.com/docs/git-cat-file>.
+
+- Obtenir la taill [s] du commit HEAD en octets :
+
+`git cat-file -s HEAD`
+
+- Obtenir le type [t] (blob, tree, commit, tag) d'un objet git spécifié :
+
+`git cat-file -t {{8c442dc3}}`
+
+- Affiche le contenu [p] d'un objet git basé sur son type :
+
+`git cat-file -p {{HEAD~2}}`

pages.fr/common/git-check-ignore.md

@@ -0,0 +1,24 @@
+# git check-ignore
+
+> Analyser et déboguer les fichiers ignorés / exclus (".gitignore") de Git.
+> Plus d'informations: <https://git-scm.com/docs/git-check-ignore>.
+
+- Verifie qu'un fichier ou repertoire est ignoré :
+
+`git check-ignore {{chemin/vers/fichier_ou_repertoire}}`
+
+- Verifie que plusieurs fichiers ou repertoires sont ignorés :
+
+`git check-ignore {{chemin/vers/fichier}} {{chemin/vers/repertoire}}`
+
+- Utilisez des chemins d'accès, un par ligne, de `stdin` :
+
+`git check-ignore --stdin < {{chemin/vers/fichier_annexe}}`
+
+- Ne pas vérifier l'index (utilisé pour déboguer pourquoi les chemins ont été suivis et non ignorés) :
+
+`git check-ignore --no-index {{chemin/vers/fichiers_ou_repertoires}}`
+
+- Inclure les details pour chaque occurence dans le chemin :
+
+`git check-ignore --verbose {{chemin/vers/fichiers_ou_repertoires}}`

pages.fr/common/git-checkout.md

@@ -0,0 +1,36 @@
+# git checkout
+
+> Extraire une branche ou des chemins vers l'arborescence de travail.
+> Plus d'informations: <https://git-scm.com/docs/git-checkout>.
+
+- Créer une branche et basculer dessus :
+
+`git checkout -b {{nom_de_branche}}`
+
+- Créer une branche depuis une reférence spçifiaue et basculer dessus (par exemple, branche locales/distantes, tag, commit) :
+
+`git checkout -b {{nom_de_branche}} {{reference}}`
+
+- Basculer sur une branche locale existante :
+
+`git checkout {{nom_de_branche}}`
+
+- Basculer sur la branche précedante :
+
+`git checkout -`
+
+- Basculer sur une brnche distante existante :
+
+`git checkout --track {{nom_distant}}/{{nom_de_branche}}`
+
+- Annule tout les changements dans le repertoire courrant (voir `git reset` pour plus de commandes d'annulation) :
+
+`git checkout .`
+
+- Annule tout les changements dans le fichier spécifié :
+
+`git checkout {{filename}}`
+
+- Remplace un fichier par sa version d'une autre branche :
+
+`git checkout {{nom_de_branche}} -- {{filename}}`

pages.fr/common/git-cherry-pick.md

@@ -0,0 +1,21 @@
+# git cherry-pick
+
+> Appliquer les modifications introduites par les commits existants à la branche actuelle.
+> Pour appliquer les changements a une autre branche, utiliser d'abord `git checkout` pour basculer sur la branche désirée.
+> Plus d'informations: <https://git-scm.com/docs/git-cherry-pick>.
+
+- Applique un commit à la branche courrante :
+
+`git cherry-pick {{commit}}`
+
+- Appliquer une plage de commits à la branche courrante (voir aussi `git rebase --onto`) :
+
+`git cherry-pick {{start_commit}}~..{{end_commit}}`
+
+- Appliquer plusieurs commits non sequentiels à la branche courrante :
+
+`git cherry-pick {{commit_1}} {{commit_2}}`
+
+- Appliquer les changements d'un commit a la branche courrante sans créer de commit :
+
+`git cherry-pick -n {{commit}}`

pages.fr/common/git-cherry.md

@@ -0,0 +1,16 @@
+# git cherry
+
+> Rechercher des commits qui n'ont pas encore été appliqués en amont.
+> Plus d'informations: <https://git-scm.com/docs/git-cherry>.
+
+- Afficher les commits (et leurs messages) avec des commits équivalents en amont :
+
+`git cherry -v`
+
+- Spécifiez une branche amont et une branche de rubrique différentes :
+
+`git cherry {{origin}} {{topic}}`
+
+- Limiter les commits a ceux dans la limite donnée :
+
+`git cherry {{origin}} {{topic}} {{base}}`

pages.fr/common/git-clean.md

@@ -0,0 +1,28 @@
+# git clean
+
+> Supprimer les fichiers non suivis du repertoire.
+> Plus d'informations: <https://git-scm.com/docs/git-clean>.
+
+- Supprimer les fichiers non suivis par git :
+
+`git clean`
+
+- Supprimer les fichiers non suivis par git de manière interactive :
+
+`git clean -i`
+
+- Affiche les fichiers non suivis qui peuvent étre suprimmés :
+
+`git clean --dry-run`
+
+- Nettoyage forcé des fichiers non suivis par git :
+
+`git clean -f`
+
+- Nettoyage forcé des repertoires non suivis par git :
+
+`git clean -fd`
+
+- Supprime tout les fichiers suivis, incluant ceux repertoriés par `.gitignore` et `.git/info/exclude` :
+
+`git clean -x`

pages.fr/common/git-clone.md

@@ -5,11 +5,11 @@
 
 - Clone un dépôt existant :
 
-`git clone {{remote_repository_location}}`
+`git clone {{location_du_depot_distant}}`
 
 - Clone un dépôt existant et ses sous-modules :
 
-`git clone --recursive {{remote_repository_location}}`
+`git clone --recursive {{location_du_depot_distant}}`
 
 - Clone un dépôt local :
 
@@ -21,4 +21,4 @@
 
 - Clone un dépôt existant en ne récupérant que les 10 commits les plus récents sur la branche par défaut (plus rapide) :
 
-`git clone --depth {{10}} {{remote_repository_location}}`
+`git clone --depth {{10}} {{location_du_depot_distant}}`

pages.fr/common/git-commit.md

@@ -9,7 +9,7 @@
 
 - Commit tous les fichiers modifiés avec un message :
 
-`git commit -a -m {{message}}`
+`git commit -am {{message}}`
 
 - Mets à jour le dernier commit avec les modifications en stage :
 
@@ -17,4 +17,4 @@
 
 - Commit seulement les fichiers spécifiés (qui sont déjà en stage) :
 
-`git commit {{path/to/my/file1}} {{path/to/my/file2}}`
+`git commit {{chemin/vers/mon/fichier1}} {{chemin/vers/mon/fichier2}}`

pages.fr/common/git-config.md

@@ -0,0 +1,37 @@
+# git config
+
+> Gérer les options de configuration personnalisées pour les référentiels git.
+> Ces configurations peuvent étre locales (pour le réferentiel courrant) ou globales (pour l utilisateur).
+> Plus d'informations: <https://git-scm.com/docs/git-config>.
+
+- Liste les entrés de configurations locales (stockés dans `.git/config` du repertoire courrant) :
+
+`git config --list --local`
+
+- Liste les entrés de conffigurations globales (stoqués dans `~/.gitconfig`) :
+
+`git config --list --global`
+
+- Liste toutes les entrés de conffiguration, globales et locales :
+
+`git config --list`
+
+- Recupére la valeure d'une entrée de configurations :
+
+`git config alias.unstage`
+
+- Attribue la valeur d'une entree de configuration :
+
+`git config --global alias.unstage "reset HEAD --"`
+
+- Restore la valeur d'une entree de configuration globale a sa valeur par défaut :
+
+`git config --global --unset alias.unstage`
+
+- Édite le fichier de configuration du référentiel courrant dans l'éditeur par défaut :
+
+`git config --edit`
+
+- Édite le fichier de configuration globale dans l'éditeur par défaut :
+
+`git config --global --edit`

pages.fr/common/git-describe.md

@@ -7,7 +7,7 @@
 
 `git describe`
 
-- Créer un nom avec un hash de commit de 4 lettres :
+- Créer un nom avec un hash de commit de 4 carctéres :
 
 `git describe --abbrev={{4}}`
 
@@ -15,10 +15,10 @@
 
 `git describe --all`
 
-- Décrire un tag :
+- Décrire un tag git :
 
 `git describe {{v1.0.0}}`
 
 - Créer un nom pour le dernier commit d'une branche donnée :
 
-`git describe {{branch_name}}`
+`git describe {{nom_de_branche}}`

pages.fr/common/git-diff.md

@@ -0,0 +1,36 @@
+# git diff
+
+> Afficher les changements sur les fichiers suivis.
+> Plus d'informations: <https://git-scm.com/docs/git-diff>.
+
+- Afficher les changements sur les fichiers suvis :
+
+`git diff`
+
+- Afficher tout les changements sur les fichiers par rapport a la téte de branche :
+
+`git diff HEAD`
+
+- Afficher tout les changements sur les fichiers ajoutés mais pas encore commités :
+
+`git diff --staged`
+
+- Afficher les changements de tout les commits a partir d une date/heure donnée (expression de dates, ex: "1 week 2 days" ou une date ISO) :
+
+`git diff 'HEAD@{3 months|weeks|days|hours|seconds ago}'`
+
+- Afficher seulement les noms des fichiers modifiés depuis un commit donné :
+
+`git diff --name-only {{commit}}`
+
+- Afficher un resumé des creation de fichiers, renomages ou changements de droits depuis un commit :
+
+`git diff --summary {{commit}}`
+
+- Comparer un ficheir entre deux branches ou commits :
+
+`git diff {{branche_1}}..{{branche_2}} [--] {{chemin/vers/fichier}}`
+
+- Comparer plusieurs fichiers de la branche courrante avec une autre branche :
+
+`git diff {{branche}}:{{chemin/vers/fichier2}} {{chemin/vers/fichier}}`

pages.fr/common/git-difftool.md

@@ -0,0 +1,20 @@
+# git difftool
+
+> Afficher les modifications apportées aux fichiers à l'aide d'outils de comparaison externes. Accepte les mêmes options et arguments que git diff.
+> Plus d'informations: <https://git-scm.com/docs/git-difftool>.
+
+- Lister les outils de coparaison disponnible :
+
+`git difftool --tool-help`
+
+- Configurer Meld comme outil de comparaison par defaut :
+
+`git config --global diff.tool "{{meld}}"`
+
+- Utiliser l'outil de comparaison par defaut pour afficher les fichiers modifiés :
+
+`git difftool --staged`
+
+- Utiliser un outil de comparaison spécifique (opendiff) pour afficher les changements depuis un commit :
+
+`git difftool --tool={{opendiff}} {{commit}}`

pages.fr/common/git-fetch.md

@@ -0,0 +1,24 @@
+# git fetch
+
+> Cherche les objets et réferences depuis un registre distant.
+> Plus d'informations: <https://git-scm.com/docs/git-fetch>.
+
+- Cherche les dernières modifications du référentiel amont distant par défaut (si configuré) :
+
+`git fetch`
+
+- Cherche les nouvelles branches depuis un registre distant :
+
+`git fetch {{nom_distant}}`
+
+- Cherche les nouvelles branches depuis tout les registres distant :
+
+`git fetch --all`
+
+- Recherche egalement les tags depuis le registre courrant :
+
+`git fetch --tags`
+
+- Supprime les références locales de branches ayant été supprimés du registre distant :
+
+`git fetch --prune`

pages.fr/common/git-flow.md

@@ -0,0 +1,24 @@
+# git flow
+
+> Une colletion d'extentions git pour procurer des opperation de registre supplementaires
+> Plus d'informations: <https://github.com/nvie/gitflow>.
+
+- Initialiser dans un registre git existant :
+
+`git flow init`
+
+- Commencer le travail sur une fonctionnalité basé sur la branche `develop` :
+
+`git flow feature start {{feature}}`
+
+- Terminer le travail sur une branche de fonctionnalité, le merger dans la branche `develop` puis suprimmer :
+
+`git flow feature finish {{feature}}`
+
+- Publier une fonctionalité sur le serveur distant :
+
+`git flow feature publish {{feature}}`
+
+- Recupérer un fonctionalité publiée par un autre utilisateur :
+
+`git flow feature pull origin {{feature}}`

pages.fr/common/git-format-patch.md

@@ -0,0 +1,17 @@
+# git format-patch
+
+> Preparer des ficchiers de correctifs, utiles pour les envoyer par email.
+> Voir egalement `git am`, qui peut appliquer des fichiers de correctifs genérés.
+> Plus d'informations: <https://git-scm.com/docs/git-format-patch>.
+
+-Créer un fichier de correctif .patch nommé automatiquement pour tout les commits non poussés :
+
+`git format-patch {{origin}}`
+
+- Crér un fichier correctif .patch pour les changements entre 2 révisions :
+
+`git format-patch {{revision_1}}..{{revision_2}}`
+
+- Créer un fichier correctif .patch pour les 3 derniers commits :
+
+`git format-patch -{{3}}`

pages.fr/common/git-fsck.md

@@ -0,0 +1,17 @@
+# git fsck
+
+> Vérifier la validité et la connectivité des nœuds dans un réferentiel Git.
+> N'applique ucune modification. Voir `git gc` pour nettoyer.
+> Plus d'informations: <https://git-scm.com/docs/git-fsck>.
+
+- Verifier le registre courrant :
+
+`git fsck`
+
+- Lister tout les tags trouvés :
+
+`git fsck --tags`
+
+- Lister tout les noeuds racine trouvés :
+
+`git fsck --root`

pages.fr/common/git-gc.md

@@ -0,0 +1,24 @@
+# git gc
+
+> Optimise le registre local en nettoyant les fichiers inutiles.
+> Plus d'informations: <https://git-scm.com/docs/git-gc>.
+
+- Optimise le registrey :
+
+`git gc`
+
+- Optimise le registre plus agressivement, plus long :
+
+`git gc --aggressive`
+
+- Afficher les objets a supprimer :
+
+`git gc --no-prune`
+
+- Supprime tout les objets trouvés sans l'afficher sur la sortie standart :
+
+`git gc --quiet`
+
+- Afficher le manuel :
+
+`git gc --help`

pages.fr/common/git-grep.md

@@ -0,0 +1,25 @@
+# git-grep
+
+> Rechercher une occurence de texte nomport ou dans l historique d un repository.
+> Comprends la plus-part des arguments que le `grep` classique.
+> Plus d'informations: <https://git-scm.com/docs/git-grep>.
+
+- Rechercher une occrence dans les fichiers suivis :
+
+`git grep {{chaine_recherché}}`
+
+- Rechercher une occrence dans les fichiers suivis d'appres un pattern de fichiers :
+
+`git grep {{chaine_recherché}} -- {{file_glob_pattern}}`
+
+- Rechercher une occrence dans les fichiers suivis et les sous-modules :
+
+`git grep --recurse-submodules {{chaine_recherché}}`
+
+- Rechercher une occurence à partir d un point spécifique dans l'historique :
+
+`git grep {{chaine_recherché}} {{HEAD~2}}`
+
+- Rechercher une occurence dans toutes les branches :
+
+`git grep {{chaine_recherché}} $(git rev-list --all)`

pages.fr/common/git-help.md

@@ -0,0 +1,24 @@
+# git help
+
+> Afficher le manuel de git.
+> Plus d'informations: <https://git-scm.com/docs/git-help>.
+
+- Afficher le manuel d'une sous commande :
+
+`git help {{subcommand}}`
+
+- Méme chose dans un navigateur :
+
+`git help --web {{subcommand}}`
+
+- Afficher la liste des sous commandes disponnibles :
+
+`git help --all`
+
+- Lister les manuels disponnibles :
+
+`git help --guide`
+
+- Lister toutes les variables de configuration disponnibles :
+
+`git help --config`

pages.fr/common/git-ignore.md

@@ -1,12 +1,12 @@
 # git ignore
 
-> Génère des fichiers .gitignore à partir de gabarits prédéfinis.
+> Génerer le fichier .gitignore depuis des templates prédéfinis.
 > Plus d'informations: <https://docs.gitignore.io/install/command-line>.
 
-- Liste les gabarits disponibles :
+- Lister les templates disponnibles :
 
 `git ignore list`
 
-- Génère un gabarit .gitignore :
+- Genénerer un template .gitignore :
 
 `git ignore {{item_a,item_b,item_n}}`

pages.fr/common/git-imerge.md

@@ -0,0 +1,29 @@
+# git-imerge
+
+> Génerer un merge ou un rebase entre deux branches de maniére incrémentale.
+> Les conflits entre les branches sont suivis en paires de commits individuels, pour simplifier la résolution des conflits.
+> Plus d'informations: <https://github.com/mhagger/git-imerge>.
+
+- Démarrer un i-merge rebase (se placer dans la branche a rebaser d'abord) :
+
+`git imerge rebase {{branche_sur_laquelle_rebaser}}`
+
+- Démarrer imerge merge (se placer dans la branche depuis laquelle merger d'abord) :
+
+`git imerge merge {{branche_a_merger}}`
+
+- Afficher le diagramme ASCII du merge ou rebase en cours :
+
+`git imerge diagram`
+
+- Continuer l opperation après une résolution de conflit (d'abord `git add` les fichiers en conflits) :
+
+`git imerge continue --no-edit`
+
+- Terminer l'opperation i-merge après la resolution de tout les conflits :
+
+`git imerge finish`
+
+- Annuler l'opperation et retourner à la branche précédante :
+
+`git-imerge remove && git checkout {{previous_branch}}`

pages.fr/common/git-init.md

@@ -0,0 +1,12 @@
+# git init
+
+> Initialise un nouveau registre git.
+> Plus d'informations: <https://git-scm.com/docs/git-init>.
+
+- Initialise un nouveau registre git local :
+
+`git init`
+
+- Initialiser un référentiel barebones, adapté à une utilisation distante via ssh :
+
+`git init --bare`

pages.fr/common/git-instaweb.md

@@ -0,0 +1,32 @@
+# git instaweb
+
+> Outil pour le lancemend d'un serveur gitweb.
+> Plus d'informations: <https://git-scm.com/docs/git-instaweb>.
+
+- Démare un serveur gitweb depuis le repository courrant :
+
+`git instaweb --start`
+
+- Écoute uniquement sur le port localhost :
+
+`git instaweb --start --local`
+
+- Écoute sur un port spécifique :
+
+`git instaweb --start --port {{1234}}`
+
+- Utiliser un daemon http spécifique :
+
+`git instaweb --start --httpd {{lighttpd|apache2|mongoose|plackup|webrick}}`
+
+- Lancer en méme temps qu un navigateur web :
+
+`git instaweb --start --browser`
+
+- Stoppe le serveur :
+
+`git instaweb --stop`
+
+- Redémarre le serveur :
+
+`git instaweb --restart`

pages.fr/common/git-lfs.md

@@ -0,0 +1,36 @@
+# git lfs
+
+> Travailler dans un registre git avec des fichiers volumineux.
+> Plus d'informations: <https://git-lfs.github.com>.
+
+- Initialise le Git LFS :
+
+`git lfs install`
+
+- Suivre des fichiers correspondant à un pattern :
+
+`git lfs track '{{*.bin}}'`
+
+- Changer l'URL du point de terminaison Git LFS (utile si le serveur LFS est séparé du serveur Git) :
+
+`git config -f .lfsconfig lfs.url {{lfs_endpoint_url}}`
+
+- Lister les pattern de fichiers suivis :
+
+`git lfs track`
+
+- Lister les fichiers suivis ayant été commité :
+
+`git lfs ls-files`
+
+- Pousser tout les objets LFS vers le serveur distant :
+
+`git lfs push --all {{nom_distant}} {{nom_de_branche}}`
+
+- Chercher tout les objets LFS :
+
+`git lfs fetch`
+
+- Charger tout les objets LFS :
+
+`git lfs checkout`

pages.fr/common/git-log.md

@@ -0,0 +1,36 @@
+# git log
+
+> Afficher un historique de commits.
+> Plus d'informations: <https://git-scm.com/docs/git-log>.
+
+- Afficher la séquence de commits à partir de l'actuel, dans l'ordre chronologique inverse du dépôt git dans le répertoire de travail actuel :
+
+`git log`
+
+- Afficher l'historique de fichiers ou repertoires en particulier :
+
+`git log -p {{chemin/vers/fichier_ou_repertoire}}`
+
+- Afficher la liste des fichiers modifiés pour chaque commit :
+
+`git log --stat`
+
+- Afficher un graphique des commits dans la branche actuelle en utilisant uniquement la première ligne de chaque message de commit :
+
+`git log --oneline --graph`
+
+- Afficher un graphique de tout les commits, tags et branches dans le dépot entier :
+
+`git log --oneline --decorate --all --graph`
+
+- Afficher uniqueent les commits dont le message contient la chaine (non sensible à la case) :
+
+`git log -i --grep {{chaine_recherché}}`
+
+- Afficher les N derniers commits d'un utilisateur :
+
+`git log -n {{number}} --author={{author}}`
+
+- Afficher les commits entre deux dates :
+
+`git log --before={{date}} --after={{date}}`

pages.fr/common/git-ls-remote.md

@@ -0,0 +1,25 @@
+# git ls-remote
+
+> Commande Git pour répertorier les références dans un dépot distant en fonction du nom ou de l'URL.
+> Si aucun nom ou URL n'est donné, alors la branche amont configurée sera utilisée, ou l'origine distante si la première n'est pas configurée.
+> Plus d'informations: <https://git-scm.com/docs/git-ls-remote.html>.
+
+- Afficher les références du dépot configuré par défaut :
+
+`git ls-remote`
+
+- Afficher uniquement les références HEAD du dépot configuré par défaut :
+
+`git ls-remote --heads`
+
+- Afficher uniquement les tags du dépot configuré par défaut :
+
+`git ls-remote --tags`
+
+- Afficher les références du dépot précisé :
+
+`git ls-remote {{repositiory-url}}`
+
+- Afficher les références du dépot précisé filtrés par un pattern :
+
+`git ls-remote {{repositiory-name}} "{{pattern}}"`

pages.fr/common/git-ls-tree.md

@@ -0,0 +1,16 @@
+# git ls-tree
+
+> Lister le contenu d'un arbre.
+> Plus d'informations: <https://git-scm.com/docs/git-ls-tree>.
+
+- Lister le contenu de l'arbre dans la branche :
+
+`git ls-tree {{nom_de_branche}}`
+
+- Lister le contenu de l'arbre dans le commit, recursif avec les sous-arbres :
+
+`git ls-tree -r {{commit_hash}}`
+
+- Lister uniquement les moms de fichiers de l'arbre dans un commit :
+
+`git ls-tree --name-only {{commit_hash}}`

pages.fr/common/git-merge.md

@@ -0,0 +1,24 @@
+# git merge
+
+> Merge branches.
+> Plus d'informations: <https://git-scm.com/docs/git-merge>.
+
+- Merge une branche dans votre branche courrante :
+
+`git merge {{nom_de_branche}}`
+
+- Editer le message de merge :
+
+`git merge -e {{nom_de_branche}}`
+
+- Merge une branche et créer un commit de merge :
+
+`git merge --no-ff {{nom_de_branche}}`
+
+- Annuler un merge en cas de conflit :
+
+`git merge --abort`
+
+- Continuer un merge apreés une résolution de conflit :
+
+`git merge --continue`

pages.fr/common/git-mergetool.md

@@ -0,0 +1,28 @@
+# git mergetool
+
+> Executer un utilitaire de différences pour resoudre les conflits de merge.
+> Plus d'informations: <https://git-scm.com/docs/git-mergetool>.
+
+- Démarrer l'outil de différences par défaut :
+
+`git mergetool`
+
+- Lister les outils de différences valides :
+
+`git mergetool --tool-help`
+
+- Démarrer l'outil de différences en précisant son nom :
+
+`git mergetool --tool {{tool_name}}`
+
+- Démarer l'outil de difféerences sans dialogues :
+
+`git mergetool --no-prompt`
+
+- Utiliser explicitement l'outil de différences graphique (voir la variable de config `merge.guitool`) :
+
+`git mergetool --gui`
+
+- tiliser explicitement l'outil de différences clasique (voir la variable de config `merge.tool`) :
+
+`git mergetool --no-gui`

pages.fr/common/git-mv.md

@@ -0,0 +1,16 @@
+# git mv
+
+> Déplacer ou renomer des fichiers inscrits dans l'index.
+> Plus d'informations: <https://git-scm.com/docs/git-mv>.
+
+- Déplace les fichiers dans l'index git, valide au prochain commit :
+
+`git mv {{chemin/vers/fichier}} {{new/path/to/file}}`
+
+- Renome un fichier et met a jour l'index, valide au prochain commit :
+
+`git mv {{filename}} {{new_filename}}`
+
+- Force l'écrasement d'un fichier :
+
+`git mv --force {{file}} {{cible}}`

pages.fr/common/git-notes.md

@@ -0,0 +1,36 @@
+# git notes
+
+> Ajoute ou inspecte des notes d'objets.
+> Plus d'informations: <https://git-scm.com/docs/git-notes>.
+
+- Lister toutes les notes et leurs objets rattachés :
+
+`git notes list`
+
+- Lister toutes les notes attaches a un objet donné :
+
+`git notes list [{{object}}]`
+
+- Afficher les notes attachés a un objet donné :
+
+`git notes show [{{object}}]`
+
+- Ajoute une note à un objet donné :
+
+`git notes append {{object}}`
+
+- Ajoute une note à un objet donné, en spécifiant le message :
+
+`git notes append --message="{{message_text}}"`
+
+- Edite une note éxistante :
+
+`git notes edit [{{object}}]`
+
+- Copy la note d'un objet vers un autre :
+
+`git notes copy {{source_object}} {{objet_cible}}`
+
+- Supprime toutes les notes d'un objet spécifié :
+
+`git notes remove {{object}}`

pages.fr/common/git-pr.md

@@ -0,0 +1,19 @@
+# git pr
+
+> Récupére les pull-request github localement.
+
+- Récupére une pull-request spécifique :
+
+`git pr {{pr_number}}`
+
+- Récupére une pull-request d un dépot spécifique :
+
+`git pr {{pr_number}} {{distant}}`
+
+- Récupére une pull-request depuis sont url :
+
+`git pr {{url}}`
+
+- Nettoie les branches de pull-request terminés :
+
+`git pr clean`

pages.fr/common/git-pull.md

@@ -13,4 +13,4 @@
 
 - Télécharge les changements depuis un serveur et une branche distante, puis fusionne les dans HEAD :
 
-`git pull {{remote_name}} {{branch}}`
+`git pull {{nom_distant}} {{branche}}`

pages.fr/common/git-push.md

@@ -9,23 +9,23 @@
 
 - Envoie les changements locaux d'une branche spécifique vers sa contrepartie distante :
 
-`git push {{remote_name}} {{local_branch}}`
+`git push {{nom_distant}} {{local_branch}}`
 
 - Publie la branche courante vers un dépôt distant, crée le nom de la branche distante :
 
-`git push {{remote_name}} -u {{remote_branch}}`
+`git push {{nom_distant}} -u {{branche_distante}}`
 
 - Envoi les changements locaux sur toutes les branches locales vers leur contrepartie sur le dépôt distant :
 
-`git push --all {{remote_name}}`
+`git push --all {{nom_distant}}`
 
 - Supprime une branche dans un dépôt distant :
 
-`git push {{remote_name}} --delete {{remote_branch}}`
+`git push {{nom_distant}} --delete {{branche_distante}}`
 
 - Supprime les branches distantes qui n'ont pas de contrepartie locale :
 
-`git push --prune {{remote_name}}`
+`git push --prune {{nom_distant}}`
 
 - Publie les tags qui ne sont pas sur le dépôt distant :
 

pages.fr/common/git-rebase.md

@@ -0,0 +1,37 @@
+# git rebase
+
+> Rejoue les commits d'une branche par dessus une autre.
+> Communément utilisé pour dupliquer les commits d'une branche dans une autre, en créant de nouveaux commits dans la branche de destination.
+> Plus d'informations: <https://git-scm.com/docs/git-rebase>.
+
+- Rejouer les commits de la branche courrante sur la branche master :
+
+`git rebase {{master}}`
+
+- Rejouer les comits interactivement, ce qui permet aux commits d'éte re-arrangés, exclus, combimés ou modifiés :
+
+`git rebase -i {{branche_de_base_ou_commit}}`
+
+- Continuer le re-jeu des commits apres la resolution d'un conflit :
+
+`git rebase --continue`
+
+- Continuer le re-jeu des commits en sautant la résolution d'un conflit :
+
+`git rebase --skip`
+
+- Annule l'operation (ex: en cas de conflict) :
+
+`git rebase --abort`
+
+- Déplacez une partie de la branche actuelle sur une nouvelle base, fournissant l'ancienne base à partir de laquelle commencer :
+
+`git rebase --onto {{new_base}} {{old_base}}`
+
+- Rejoue les 5 derniers commits, ce qui permet aux commits d'éte re-arrangés, exclus, combimés ou modifiés :
+
+`git rebase -i {{HEAD~5}}`
+
+- Resoudre automatiquement les conflits en precisant la version a conserver (`theirs` signifie la version des fichiers a privilégier) :
+
+`git rebase -X theirs {{master}}`

pages.fr/common/git-reflog.md

@@ -0,0 +1,16 @@
+# git reflog
+
+> Affiche un log des changements locaux comme HEAD, tags et branches.
+> Plus d'informations: <https://git-scm.com/docs/git-reflog>.
+
+- Afficher le reflog de HEAD :
+
+`git reflog`
+
+- Affiche le reflog d'une branche spécifique :
+
+`git reflog {{nom_de_branche}}`
+
+- Affiche les 5 dérniéres entrés dans le reflog :
+
+`git reflog -n {{5}}`

pages.fr/common/git-remote.md

@@ -0,0 +1,28 @@
+# git remote
+
+> Organisation des dépots suivis ("remotes").
+> Plus d'informations: <https://git-scm.com/docs/git-remote>.
+
+- Affiche les dépots existants, leur nom et url :
+
+`git remote -v`
+
+- Affiche les informations a propos d'un dépot :
+
+`git remote show {{nom_distant}}`
+
+- Ajoute un dépot :
+
+`git remote add {{nom_distant}} {{url_distant}}`
+
+- Change l'url d'un dépot (ajouter `--add` pour conserver l'url existante) :
+
+`git remote set-url {{nom_distant}} {{new_url}}`
+
+- Suprime un dṕot :
+
+`git remote remove {{nom_distant}}`
+
+- Renome un dépot :
+
+`git remote rename {{old_name}} {{new_name}}`

pages.fr/common/git-repack.md

@@ -0,0 +1,12 @@
+# git repack
+
+> Empaqueter les objets décompressés dans un dépot git.
+> Plus d'informations: <https://git-scm.com/docs/git-repack>.
+
+- Empaqueter les objets décompressés dans le dépot courrant :
+
+`git repack`
+
+- Egalement suprime les objets redondants après empaquetage :
+
+`git repack -d`

pages.fr/common/git-request-pull.md

@@ -0,0 +1,12 @@
+# git request-pull
+
+> Générer une requête demandant au projet en amont d'inclure les modifications dans son arborescence.
+> Plus d'informations: <https://git-scm.com/docs/git-request-pull>.
+
+- Produire une requête résumant les changements entre la version v1.1 et le master :
+
+`git request-pull {{v1.1}} {{https://example.com/project}} {{master}}`
+
+- Produire une requête résumant les changements entre la version v1.1 sur la branche master et la branche locale foo :
+
+`git request-pull {{v0.1}} {{https://example.com/project}} {{master:foo}}`

pages.fr/common/git-reset.md

@@ -11,11 +11,11 @@
 
 - Enlever des fichiers spécifiques de la *zone de stage* :
 
-`git reset {{path/to/file(s)}}`
+`git reset {{chemin/vers/fichier(s)}}`
 
 - Enlever une portion d'un fichier de la *zone de stage* :
 
-`git reset -p {{path/to/file}}`
+`git reset -p {{chemin/vers/fichier}}`
 
 - Annuler le dernier *commit*, mais garder les chagements éffectués dans votre système de fichier :
 

pages.fr/common/git-restore.md

@@ -0,0 +1,17 @@
+# git restore
+
+> Restaurez les fichiers de l'arborescence de travail. Nécessite la version 2.23+ de git.
+> Voir aussi `git checkout`.
+> Plus d'informations: <https://git-scm.com/docs/git-restore/>.
+
+- Restaurer un fichier supprimé à partir du contenu du commit actuel (HEAD) :
+
+`git restore {{chemin/vers/fichier}}`
+
+- Restaurer un fichier a la version d'un commit spécifié :
+
+`git restore --source {{commit}} {{chemin/vers/fichier}}`
+
+- Annulez toutes les modifications non validées des fichiers suivis, en revenant au HEAD :
+
+`git restore .`

pages.fr/common/git-rev-list.md

@@ -0,0 +1,16 @@
+# git rev-list
+
+> Liste les révisionts (commits) dans l'ordre chronologique inverse.
+> Plus d'informations: <https://git-scm.com/docs/git-rev-list>.
+
+- Lister tout les commits dans la branche courrante :
+
+`git rev-list {{HEAD}}`
+
+- Lister tout les commits plus récents qu'une date spécifique, sur une branche spécifique :
+
+`git rev-list --since={{'2019-12-01 00:00:00'}} {{master}}`
+
+- Lister tout les commits de merge depuis un commit spécifique :
+
+`git rev-list --merges {{commit}}`

pages.fr/common/git-rev-parse.md

@@ -0,0 +1,16 @@
+# git rev-parse
+
+> Afficher les métadonnées liées à des révisions spécifiques.
+> Plus d'informations: <https://git-scm.com/docs/git-rev-parse>.
+
+- Afficher le hash de commit de la branche courrante :
+
+`git rev-parse {{nom_de_branche}}`
+
+- Affiche le nom de la branche courrante :
+
+`git rev-parse --abbrev-ref {{HEAD}}`
+
+- Obtenir le chamin absolu du repertoire racine :
+
+`git rev-parse --show-toplevel`

pages.fr/common/git-revert.md

@@ -0,0 +1,20 @@
+# git revert
+
+> Créer un nouveau commit qui efface les changements du précedant.
+> Plus d'informations: <https://git-scm.com/docs/git-revert>.
+
+- Crée un commit qui annule les changements du dernier commit :
+
+`git revert {{@}}`
+
+- Crée un commit qui annule les changements des 5 dernier commit :
+
+`git revert HEAD~{{4}}`
+
+- Crée un commit qui annule les changements de plusieurs commit :
+
+`git revert {{master~5..master~2}}`
+
+- Ne pas créer de nouveau commit, remplacer uniquement dans l'arbre courrant :
+
+`git revert -n {{0c01a9..9a1743}}`

pages.fr/common/git-rm.md

@@ -0,0 +1,16 @@
+# git rm
+
+> Supprimer des fichiers de l'index, du dépot et du systéme de fichiers.
+> Plus d'informations: <https://git-scm.com/docs/git-rm>.
+
+- Supprimer un fichiers de l'index, du dépot et du systéme de fichiers :
+
+`git rm {{file}}`
+
+- Supprimer un répertoire de l'index, du dépot et du systéme de fichiers :
+
+`git rm -r {{directory}}`
+
+- Supprimer un fichiers de l'index, du dépot mais le conserve sur le systéme de fichiers :
+
+`git rm --cached {{file}}`

pages.fr/common/git-send-email.md

@@ -0,0 +1,25 @@
+# git send-email
+
+> Envoyer une collection de correctifs par email.
+> Les correctifs peuvent être spécifiés sous forme de fichiers, de directions ou de liste de révisions.
+> Plus d'informations: <https://git-scm.com/docs/git-send-email>.
+
+- Envoyer le dernier commit de la branche courrante :
+
+`git send-email -1`
+
+- envoyer un commit spécifiaue :
+
+`git send-email -1 {{commit}}`
+
+- envoyer de multiples commits de la branche courrante (ici: 10) :
+
+`git send-email {{-10}}`
+
+- Envoyez un e-mail de présentation de la série de correctifs :
+
+`git send-email -{{number of commits}} --compose`
+
+- Consultez et modifiez l'e-mail de chaque patch que vous êtes sur le point d'envoyer :
+
+`git send-email -{{number of commits}} --annotate`

pages.fr/common/git-shortlog.md

@@ -0,0 +1,28 @@
+# git shortlog
+
+> Récapitule la sortie de `git log`.
+> Plus d'informations: <https://git-scm.com/docs/git-shortlog>.
+
+- Afficher un résumé de tous les commits effectués, regroupés par ordre alphabétique par nom d'auteur :
+
+`git shortlog`
+
+- Afficher un résumé de tous les commits effectués, regroupés par le nombre de commits effectués :
+
+`git shortlog -n`
+
+- Afficher un résumé de tous les commits effectués, regroupés par le nom et l'email de l'utilisateur :
+
+`git shortlog -c`
+
+- fficher un résumé des 5 derniers commits effectués :
+
+`git shortlog HEAD~{{5}}..HEAD`
+
+- Afficher tout les utilisateurs, emails et le nombre de commits dans la branche :
+
+`git shortlog -sne`
+
+- Afficher tout les utilisateurs, emails et le nombre de commits dans toutes les branches :
+
+`git shortlog -sne --all`

pages.fr/common/git-show-branch.md

@@ -0,0 +1,36 @@
+# git show-branch
+
+> Affiche les branches et leurs commits.
+> Plus d'informations: <https://git-scm.com/docs/git-show-branch>.
+
+- Affiche un resumé du dernier commit dans la branche :
+
+`git show-branch {{nom_de_branche}}|ref|commit}}`
+
+- Comparer des commits avec plusieurs commits ou branches :
+
+`git show-branch {{nom_de_branche}}|ref|commit}}`
+
+- Comparer toutes les branches distantes :
+
+`git show-branch --remotes`
+
+- Comparer le branche locale avec la branche distante :
+
+`git show-branch --all`
+
+- Lister les derniers commits sur toutes les branches :
+
+`git show-branch --all --list`
+
+- Compareer une branche spécifique a la branche courante :
+
+`git show-branch --current {{commit|branch_name|ref}}`
+
+- Afficher le nom du commit au lieu du nom relatif :
+
+`git show-branch --sha1-name --current {{current|branch_name|ref}}`
+
+- Continuez l'affichage d'un certain nombre de commits au-delà de l'ancêtre commun :
+
+`git show-branch --more {{5}} {{commit|branch_name|ref}} {{commit|branch_name|ref}} {{...}}`

pages.fr/common/git-show-ref.md

@@ -0,0 +1,20 @@
+# git show-ref
+
+> commande git pour lister les références.
+> Plus d'informations: <https://git-scm.com/docs/git-show-ref>.
+
+- Affiche toutes les références dans le dépot :
+
+`git show-ref`
+
+- Affiche seulement les références des tétes de branches :
+
+`git show-ref --heads`
+
+- Affiche seulement les références de tags :
+
+`git show-ref --tags`
+
+- Verifier l'existence d'une référence :
+
+`git show-ref --verify {{chemin/vers/reference}}`

pages.fr/common/git-show.md

@@ -0,0 +1,32 @@
+# git show
+
+> Affiche différents types d'objets git (commits, tags, etc.).
+> Plus d'informations: <https://git-scm.com/docs/git-show>.
+
+- Afficher des informations sur le dernier commit (hachage, message, modifications et autres métadonnées) :
+
+`git show`
+
+- Affiche les informations du dernier commit :
+
+`git show {{commit}}`
+
+- Affiche les informations associés au tag spécifié :
+
+`git show {{etiquette}}`
+
+- Affiche les informations a propos du 3éme commit en partant du sommet de la branche :
+
+`git show {{branche}}~{{3}}`
+
+- Afficher le message d'un commit sur une seule ligne, en supprimant la sortie diff :
+
+`git show --oneline -s {{commit}}`
+
+- Affiche uniquement la liste des fichiers changés dans un commit :
+
+`git show --stat {{commit}}`
+
+- Afficher le contenu d'un fichier tel qu'il était à une révision donnée (par exemple, branche, tag ou commit) :
+
+`git show {{revision}}:{{chemin/vers/fichier}}`

pages.fr/common/git-sizer.md

@@ -0,0 +1,16 @@
+# git sizer
+
+> Calcule diverses métriques de taille de dépot Git et vous alerte de tout ce qui pourrait causer des problèmes ou des inconvénients.
+> Plus d'informations: <https://github.com/github/git-sizer>.
+
+- Signaler uniquement les statistiques dont le niveau de préoccupation est supérieur à 0 :
+
+`git sizer`
+
+- Signaler toutes les statistiques :
+
+`git sizer -v`
+
+- Afficher les options additionelles :
+
+`git sizer -h`

pages.fr/common/git-stage.md

@@ -0,0 +1,33 @@
+# git stage
+
+> Ajouter le contenu du fichier à la zone de préparation.
+> Synonym of `git add`.
+> Plus d'informations: <https://git-scm.com/docs/git-stage>.
+
+- Ajouter un fichier à l'index :
+
+`git stage {{chemin/vers/fichier}}`
+
+- Ajoute tout les fichiers à l'index (suivis et non suivis) :
+
+`git stage -A`
+
+- Ajout uniquement des fichiers déja suivis :
+
+`git stage -u`
+
+- Ajout egalement des fichiers ignorés :
+
+`git stage -f`
+
+- Ajout des fichiers par parties, interactivement :
+
+`git stage -p`
+
+- Ajout d'un fichier par parties, interactivement :
+
+`git stage -p {{chemin/vers/fichier}}`
+
+- Ajout d'un fichier, interactivement :
+
+`git stage -i`

pages.fr/common/git-stash.md

@@ -1,36 +1,36 @@
 # git stash
 
-> Mettre les changements locaux de Git dans un endroit temporaire (Le stash).
+> Stocker les modifications Git locales dans une zone temporaire.
 > Plus d'informations: <https://git-scm.com/docs/git-stash>.
 
-- Mettre les changements courants (sauf ceux provenant de fichiers qui ne sont pas suivi) dans un *stash*:
+- Stocker les changements courrants, sauf les fichiers non suivis :
 
-`git stash [push -m {{message_optionnel_pour_le_stash}}]`
+`git stash [push -m {{nom_de_stash_optionel}}]`
 
-- Mettre les changements courants (incluant les fichiers qui ne sont pas suivi) dans un *stash*:
+- Stocker les changements courrants, incluant le sfichiers non suivis :
 
 `git stash -u`
 
-- Selectionner interactivement les parties des fichiers changer à mettre dans un *stash*:
+- Stocker les parties d'un fichier interactivement :
 
 `git stash -p`
 
-- Lister tout les *stash* (Montre le nom du *stash*, la branche reliée et le message):
+- Lister tout les stash (saffiche leurs noms, les branches relatives et messages) :
 
 `git stash list`
 
-- Appliquer un *stash* à la tête git (le dernier stash est celui choisi par défaut, aussi appellé `stash@{0}`):
+- Applique un stash (par défaut, le dernier, nommé stash@{0}) :
 
-`git stash apply {{nom_du_stash_ciblé_optionnellement}}`
+`git stash apply {{nom_de_stash_ou_de_commit_optionel}}`
 
-- Appliquer un *stash* (le dernier *stash* est celui choisi par défaut), et l'enlever de la liste s'il n'y a pas de conflits:
+- Applique un stash (par défaut le dernier, stash@{0}), et le suprimmer de la liste des stash si il n'y a pas de conflits :
 
-`git stash pop {{message_optionnel_pour_le_stash}}`
+`git stash pop {{nom_de_stash_optionel}}`
 
-- Détruire un *stash* (le dernier *stash* est celui choisi par défaut):
+- Suprime un stash (par défaut le dernier, stash@{0}) :
 
-`git stash drop {{message_optionnel_pour_le_stash}}`
+`git stash drop {{nom_de_stash_optionel}}`
 
-- Détruire tout les *stash*:
+- Suprime tout les stash :
 
 `git stash clear`

pages.fr/common/git-status.md

@@ -1,21 +1,21 @@
 # git status
 
-> Afficher les changements aux fichier d'un dépôt Git.
+> Affiche les changements sur les fichiers dans la branche courrante.
-> Les fichiers changés, ajoutés et supprimés seront comparés au commit où se situe la tête.
+> Affiche les fichiers édités, deplacés, renomés, ajoutés, suprimés par rapport a la référence de la branche courrante.
 > Plus d'informations: <https://git-scm.com/docs/git-status>.
 
-- Afficher les fichiers changés qui n'ont pas été ajouté dans le *stage*:
+- Affiche les fichiers mofifiés qui n ont pas encore été ajoutés pour le commit :
 
 `git status`
 
-- Afficher le résultat de façon conci[s]e:
+- Affiche les fichiers mofifiés (version courte) :
 
 `git status -s`
 
-- Afficher seulement les changements de fichiers suivi:
+- Affiche les fichiers mofifiés, sans tenir des comptes des fichiers non suivis :
 
 `git status --untracked-files=no`
 
-- Montrer le résultat de façon conci[s]e avec de l'information sur la [b]ranche:
+- Affiche les fichiers mofifiés (version courte) avec les informations de branche :
 
 `git status -sb`

pages.fr/common/git-submodule.md

@@ -0,0 +1,20 @@
+# git submodule
+
+> Inspecter, metre a jour et manager des sous modules.
+> Plus d'informations: <https://git-scm.com/docs/git-submodule>.
+
+- Installer un submodule depuis le dépot courrant :
+
+`git submodule update --init --recursive`
+
+- Ajout d'un dépot git en tant que sous module :
+
+`git submodule add {{repository_url}}`
+
+- Ajout d'un dépot git en tant que sous module a répertoire donné :
+
+`git submodule add {{repository_url}} {{chemin/vers/repertoire}}`
+
+- Metre à jour tout les sous modules à leurs derniers commit :
+
+`git submodule foreach git pull`

pages.fr/common/git-subtree.md

@@ -0,0 +1,24 @@
+# git subtree
+
+> Outil pour gérer les dépendances de projet en tant que sous-projets.
+> Plus d'informations: <https://manpages.debian.org/testing/git-man/git-subtree.1.en.html>.
+
+- Ajout d'un dépot git en tant que sous arbre :
+
+`git subtree add --prefix={{chemin/vers/repertoire/}} --squash {{repository_url}} {{master}}`
+
+- Metre a jour le sous arbre avec son dernier commit :
+
+`git subtree pull --prefix={{chemin/vers/repertoire/}} {{repository_url}} {{master}}`
+
+- Merge le dépot d'un sous arbre dans la branche master :
+
+`git subtree merge --prefix={{chemin/vers/repertoire/}} --squash {{repository_url}} {{master}}`
+
+- Pousser les commits vers le dépot d'un sous arbre :
+
+`git subtree push --prefix={{chemin/vers/repertoire/}} {{repository_url}} {{master}}`
+
+- Extraire un nouvel historique de projet de l'historique d'un sous-arbre :
+
+`git subtree split --prefix={{chemin/vers/repertoire/}} {{repository_url}} -b {{nom_de_branche}}`

pages.fr/common/git-svn.md

@@ -0,0 +1,24 @@
+# git svn
+
+> Opération bidirectionnelle entre un référentiel Subversion et Git.
+> Plus d'informations: <https://git-scm.com/docs/git-svn>.
+
+- Cloner un dépot SVN :
+
+`git svn clone {{https://example.com/subversion_repo}} {{local_dir}}`
+
+- Cloner un dépot SVN a partir d'une révision donnée :
+
+`git svn clone -r{{1234}}:HEAD {{https://svn.example.net/subversion/repo}} {{local_dir}}`
+
+- Metre a jourr le clone local a partir du depot SVN distant :
+
+`git svn rebase`
+
+- Chercher les changements distants dans le dépot SVN dans les appliquer sur le HEAD :
+
+`git svn fetch`
+
+- Commiter sur le SVN :
+
+`git svn dcommit`

pages.fr/common/git-switch.md

@@ -0,0 +1,29 @@
+# git switch
+
+> Basculez entre les branches git. Nécessite la version 2.23+ de git.
+> Voir egalement `git checkout`.
+> Plus d'informations: <https://git-scm.com/docs/git-switch/>.
+
+- Baculer sur une branche existante :
+
+`git switch {{nom_de_branche}}`
+
+- Créer une nouvelle branche et basculer dessus :
+
+`git switch --create {{nom_de_branche}}`
+
+- Créer une nouvelle branche en partant d'un commit donné et basculer dessus :
+
+`git switch --create {{nom_de_branche}} {{commit}}`
+
+- Basculer sur la branche précedante :
+
+`git switch -`
+
+- Basculer vers une branche et mettre à jour tous les sous-modules pour qu'ils correspondent :
+
+`git switch --recurse-submodules {{nom_de_branche}}`
+
+- Basculer vers une branche et fusionner automatiquement la branche actuelle et toutes les modifications non validées dedans :
+
+`git switch --merge {{nom_de_branche}}`

pages.fr/common/git-tag.md

@@ -0,0 +1,33 @@
+# git tag
+
+> Créer, lister, verifier et suprimer des tags.
+> Un tag est une reférence statique vers un commit.
+> Plus d'informations: <https://git-scm.com/docs/git-tag>.
+
+- Lister tout les tags :
+
+`git tag`
+
+- Créer un tag avec le nom donné pointant vers le commit actuel :
+
+`git tag {{nom_d_etiquette}}`
+
+- Créer un tag avec le nom donné pointant vers un commit spécifié :
+
+`git tag {{nom_d_etiquette}} {{commit}}`
+
+- Créer un tag annoté avec le message spécifié :
+
+`git tag {{nom_d_etiquette}} -m {{message_d_etiquette}}`
+
+- Suprimer le tag avec le nom spécifié :
+
+`git tag -d {{nom_d_etiquette}}`
+
+- Metre a jour les tags depuis l'origine :
+
+`git fetch --tags`
+
+- Liste toutes les tags dont les ancêtres incluent un commit donné :
+
+`git tag --contains {{commit}}`

pages.fr/common/git-update-index.md

@@ -0,0 +1,8 @@
+# git update-index
+
+> Commande git pour manipuler l'index.
+> Plus d'informations: <https://git-scm.com/docs/git-update-index>.
+
+- Prétendre qu'un fichier modifié est inchangé (`git status` ne l'affichera pas comme modifié) :
+
+`git update-index --skip-worktree {{chemin/vers/fichier_modifié}}`

pages.fr/common/git-update-ref.md

@@ -0,0 +1,12 @@
+# git update-ref
+
+> Commande Git pour créer, mettre à jour et supprimer des références git.
+> Plus d'informations: <https://git-scm.com/docs/git-update-ref>.
+
+- Supprimer une référence, utile pour la réinitialisation du premier commit :
+
+`git update-ref -d {{HEAD}}`
+
+- Mettre a jour une référence avec un message :
+
+`git update-ref -m {{message}} {{HEAD}} {{4e95e05}}`

pages.fr/common/git-worktree.md

@@ -0,0 +1,20 @@
+# git worktree
+
+> Gérez plusieurs arborescences de travail attachées au même dépot.
+> Plus d'informations: <https://git-scm.com/docs/git-worktree>.
+
+- Créer un nouveau sous arbre avec la branche spécifiée extraite dedans :
+
+`git worktree add {{chemin/vers/repertoire}} {{branche}}`
+
+- Créer un nouveau sous arbre branche extraite dedans :
+
+`git worktree add {{chemin/vers/repertoire}} -b {{nouvelle_branche}}`
+
+- Répertoriez tous les sous arbres attachés à ce dépot :
+
+`git worktree list`
+
+- Suprime les sous arbres (apres avoir suprimé les repertoires de travail) :
+
+`git worktree prune`

pages/common/git-show.md

@@ -15,7 +15,7 @@
 
 `git show {{tag}}`
 
-- Show information about the 3rd commit from the tip of a branch:
+- Show information about the 3rd commit from the HEAD of a branch:
 
 `git show {{branch}}~{{3}}`