Retravaille en synchronisation de structure ch1-3

Author: jnavila

book/01-introduction/sections/about-version-control.asc

@@ -1,4 +1,4 @@
-== À propos de la gestion de version
+=== À propos de la gestion de version
 
 (((gestion de version)))
 Qu'est-ce que la gestion de version et pourquoi devriez-vous vous en soucier ?
@@ -10,7 +10,7 @@ Il vous permet de ramener un fichier à un état précédent, de ramener le proj
 Utiliser un VCS signifie aussi généralement que si vous vous trompez ou que vous perdez des fichiers, vous pouvez facilement revenir à un état stable.
 De plus, vous obtenez tous ces avantages avec peu de travail additionnel.
 
-=== Les systèmes de gestion de version locaux
+==== Les systèmes de gestion de version locaux
 
 (((gestion de version,locale)))
 La méthode courante pour la gestion de version est généralement de recopier les fichiers dans un autre répertoire (peut-être avec un nom incluant la date dans le meilleur des cas).
@@ -25,7 +25,7 @@ image::images/local.png[Diagramme de gestion de version locale]
 Un des systèmes les plus populaires était RCS, qui est encore distribué avec de nombreux systèmes d'exploitation aujourd'hui.
 Cet outil fonctionne en conservant des ensembles de patchs (c'est-à-dire la différence entre les fichiers) d'une version à l'autre dans un format spécial sur disque ; il peut alors restituer l'état de n'importe quel fichier à n'importe quel instant en ajoutant toutes les différences.
 
-=== Les systèmes de gestion de version centralisés
+==== Les systèmes de gestion de version centralisés
 
 (((gestion de version, centralisée)))
 Le problème majeur que les gens rencontrent est qu'ils ont besoin de collaborer avec des développeurs sur d'autres ordinateurs.
@@ -46,7 +46,7 @@ Si ce serveur est en panne pendant une heure, alors durant cette heure, aucun cl
 Si le disque dur du serveur central se corrompt, et s'il n'y a pas eu de sauvegarde, vous perdez absolument tout de l'historique d'un projet en dehors des sauvegardes locales que les gens auraient pu réaliser sur leurs machines locales.
 Les systèmes de gestion de version locaux souffrent du même problème — dès qu'on a tout l'historique d'un projet sauvegardé à un endroit unique, on prend le risque de tout perdre.
 
-=== Les systèmes de gestion de version distribués
+==== Les systèmes de gestion de version distribués
 
 (((gestion de version, distribuée)))
 C'est à ce moment que les systèmes de gestion de version distribués entrent en jeu (DVCS en anglais pour _Distributed Version Control Systems_).

book/01-introduction/sections/basics.asc

@@ -1,11 +1,11 @@
-== Rudiments de Git
+=== Rudiments de Git
 
 Donc, qu'est-ce que Git en quelques mots ?
 Il est important de bien comprendre cette section, parce que si on comprend la nature de Git et les principes sur lesquels il repose, alors utiliser efficacement Git devient simple.
 Au cours de l'apprentissage de Git, essayez de libérer votre esprit de ce que vous pourriez connaître d'autres VCS, tels que Subversion et Perforce ; ce faisant, vous vous éviterez de petites confusions à l'utilisation de cet outil.
 Git enregistre et gère l'information très différemment des autres systèmes, même si l'interface utilisateur paraît similaire ; comprendre ces différences vous évitera des surprises.(((Subversion)))(((Perforce)))
 
-=== Des instantanés, pas des différences
+==== Des instantanés, pas des différences
 
 La différence majeure entre Git et les autres VCS (Subversion et autres) réside dans la manière dont Git considère les données.
 Au niveau conceptuel, la plupart des autres systèmes gèrent l'information comme une liste de modifications de fichiers.
@@ -20,15 +20,15 @@ Git ne gère pas et ne stocke pas les informations de cette manière.
 Pour être efficace, si les fichiers n'ont pas changé, Git ne stocke pas le fichier à nouveau, juste une référence vers le fichier original qu'il a déjà enregistré.
 Git pense ses données plus à la manière d'un *flux d'instantanés*.
 
-.Git stocke les données comme des instantanés du projet au cours du temps.
+.Stockage des données comme des instantanés du projet au cours du temps.
 image::images/snapshots.png[Git stocke les données comme des instantanés du projet au cours du temps.]
 
 C'est une distinction importante entre Git et quasiment tous les autres VCS.
 Git a reconsidéré quasiment tous les aspects de la gestion de version que la plupart des autres systèmes ont copiés des générations précédentes.
 Git ressemble beaucoup plus à un mini système de fichiers avec des outils incroyablement puissants construits dessus, plutôt qu'à un simple VCS.
 Nous explorerons les bénéfices qu'il y a à penser les données de cette manière quand nous aborderons la gestion de branches dans <<ch03-git-branching#ch03-git-branching>>.
 
-=== Presque toutes les opérations sont locales
+==== Presque toutes les opérations sont locales
 
 La plupart des opérations de Git ne nécessitent que des fichiers et ressources locaux — généralement aucune information venant d'un autre ordinateur du réseau n'est nécessaire.
 Si vous êtes habitué à un CVCS où toutes les opérations sont ralenties par la latence des échanges réseau, cet aspect de Git vous fera penser que les dieux de la vitesse ont octroyé leurs pouvoirs à Git.
@@ -46,7 +46,7 @@ Avec Perforce par exemple, vous ne pouvez pas faire grand-chose tant que vous n'
 Avec Subversion ou CVS, vous pouvez éditer les fichiers, mais vous ne pourrez pas soumettre des modifications à votre base de données (car celle-ci est sur le serveur non accessible).
 Cela peut sembler peu important a priori, mais vous seriez étonné de découvrir quelle grande différence cela peut constituer à l'usage.
 
-=== Git gère l'intégrité
+==== Git gère l'intégrité
 
 Dans Git, tout est vérifié par une somme de contrôle avant d'être stocké et par la suite cette somme de contrôle, signature unique, sert de référence.
 Cela signifie qu'il est impossible de modifier le contenu d'un fichier ou d'un répertoire sans que Git ne s'en aperçoive.
@@ -65,7 +65,7 @@ Une empreinte SHA-1 ressemble à ceci :
 Vous trouverez ces valeurs à peu près partout dans Git car il les utilise pour tout.
 En fait, Git stocke tout non pas avec des noms de fichiers, mais dans la base de données Git indexée par ces valeurs.
 
-=== Généralement, Git ne fait qu'ajouter des données
+==== Généralement, Git ne fait qu'ajouter des données
 
 Quand vous réalisez des actions dans Git, la quasi-totalité d'entre elles ne font qu'ajouter des données dans la base de données de Git.
 Il est très difficile de faire réaliser au système des actions qui ne soient pas réversibles ou de lui faire effacer des données d'une quelconque manière.
@@ -74,18 +74,19 @@ Par contre, comme dans la plupart des systèmes de gestion de version, vous pouv
 Cela fait de l'usage de Git un vrai plaisir, car on peut expérimenter sans danger de casser définitivement son projet.
 Pour une information plus approfondie sur la manière dont Git stocke ses données et comment récupérer des données qui pourraient sembler perdues, référez-vous à <<ch02-git-basics#s_undoing>>.
 
-=== Les trois états
+==== Les trois états
 
 Un peu de concentration maintenant.
 Il est primordial de se souvenir de ce qui suit si vous souhaitez que le reste de votre apprentissage s'effectue sans difficulté.
-Git gère trois états dans lesquels les fichiers peuvent résider : validé, modifié et indexé.
-Validé signifie que les données sont stockées en sécurité dans votre base de données locale.
-Modifié signifie que vous avez modifié le fichier mais qu'il n'a pas encore été validé en base.
-Indexé signifie que vous avez marqué un fichier modifié dans sa version actuelle pour qu'il fasse partie du prochain instantané du projet.
+Git gère trois états dans lesquels les fichiers peuvent résider : _modifié_, _indexé_ et _validé_.
+
+* Modifié signifie que vous avez modifié le fichier mais qu'il n'a pas encore été validé en base.
+* Indexé signifie que vous avez marqué un fichier modifié dans sa version actuelle pour qu'il fasse partie du prochain instantané du projet.
+* Validé signifie que les données sont stockées en sécurité dans votre base de données locale.
 
 Ceci nous mène aux trois sections principales d'un projet Git : le répertoire Git, le répertoire de travail et la zone d'index.
 
-.Répertoire de travail, zone d'index et répertoire Git.
+.Répertoire de travail, zone d'index et répertoire Git
 image::images/areas.png["Répertoire de travail, zone d'index et répertoire Git."]
 
 Le répertoire Git est l'endroit où Git stocke les méta-données et la base de données des objets de votre projet.

book/01-introduction/sections/command-line.asc

@@ -1,4 +1,4 @@
-== La ligne de commande
+=== La ligne de commande
 
 Il existe de nombreuses manières différentes d'utiliser Git.
 Il y a les outils originaux en ligne de commande et il y a de nombreuses interfaces graphiques avec des capacités variables.

book/01-introduction/sections/first-time-setup.asc

@@ -1,27 +1,35 @@
 [[s_first_time]]
-== Paramétrage à la première utilisation de Git
+=== Paramétrage à la première utilisation de Git
 
 Maintenant que vous avez installé Git sur votre système, vous voudrez personnaliser votre environnement Git.
 Vous ne devriez avoir à réaliser ces réglages qu'une seule fois ; ils persisteront lors des mises à jour.
 Vous pouvez aussi les changer à tout instant en relançant les mêmes commandes.
 
-Git contient un outil appelé `git config` pour vous permettre de voir et modifier les variables de configuration qui contrôlent tous les aspects de l'apparence et du comportement de Git.
+Git contient un outil appelé `git config` pour vous permettre de voir et modifier les variables de configuration qui contrôlent tous les aspects de l'apparence et du comportement de Git.(((commandes git, config)))
 Ces variables peuvent être stockées dans trois endroits différents :
 
-*	Fichier `/etc/gitconfig` : Contient les valeurs pour tous les utilisateurs et tous les dépôts du système.
-Si vous passez l'option `--system` à `git config`, il lit et écrit ce fichier spécifiquement.
-*	Fichier `~/.gitconfig` : Spécifique à votre utilisateur.
-Vous pouvez forcer Git à lire et écrire ce fichier en passant l'option `--global`.
-*	Fichier `config` dans le répertoire Git (c'est-à-dire `.git/config`) du dépôt en cours d'utilisation : spécifique au seul dépôt en cours.
+1. `[chemin]/etc/gitconfig` : Contient les valeurs pour tous les utilisateurs et tous les dépôts du système. Si vous passez l'option `--system` à `git config`, il lit et écrit ce fichier spécifiquement. Parce que c'est un fichier de configuration au niveau système, vous aurez besoin de privilèges admnistrateur ou super-utilisateur pour le modifier.
+2. Fichier `~/.gitconfig` : Spécifique à votre utilisateur.
+   Vous pouvez forcer Git à lire et écrire ce fichier en passant l'option `--global` et cela affecte _tous_ les dépôts avec lesquels vous travaillez sur ce système.
+3. Fichier `config` dans le répertoire Git (c'est-à-dire `.git/config`) du dépôt en cours d'utilisation : spécifique au seul dépôt en cours.
+   Vous pouvez forcer Git à lire et écrire dans ce fichier avec l'option `--local``, mais c'est en fait l'option par défaut.
+   Sans surprise, le répertoire courant doit être dans un dépôt Git pour que cette fonctionne correctement.
 
-Chaque niveau surcharge le niveau précédent, donc les valeurs dans `.git/config` surchargent celles de `/etc/gitconfig`.
+Chaque niveau surcharge le niveau précédent, donc les valeurs dans `.git/config` surchargent celles de `[chemin]/etc/gitconfig`.
 
 Sur les systèmes Windows, Git recherche le fichier `.gitconfig` dans le répertoire `$HOME` (`%USERPROFILE%` dans l’environnement natif de Windows) qui est `C:\Documents and Settings\$USER` ou `C:\Users\$USER` la plupart du temps, selon la version (`$USER` devient `%USERNAME%` dans l’environnement de Windows).
 Il recherche tout de même `/etc/gitconfig`, bien qu'il soit relatif à la racine MSys, qui se trouve où vous aurez décidé d'installer Git sur votre système Windows.
 Si vous utilisez une version 2.x ou supérieure de Git pour Windows, il y a aussi un fichier de configuration système à `C:\Documents and Settings\All Users\Application Data\Git\config` sur Windows XP, et dans `C:\ProgramData\Git\config` sur Windows Vista et supérieur.
 Ce fichier de configuration ne peut être modifié qu'avec la commande `git config -f <fichier>` en tant qu'administrateur.
 
-=== Votre identité
+Vous pouvez voir tous vos paramétrages et d'où ils viennent en utilisant :
+
+[source,console]
+----
+$ git config --list --show-origin
+----
+
+==== Votre identité
 
 La première chose à faire après l'installation de Git est de renseigner votre nom et votre adresse de courriel.
 C'est une information importante car toutes les validations dans Git utilisent cette information et elle est indélébile dans toutes les validations que vous pourrez réaliser :
@@ -37,25 +45,54 @@ Si vous souhaitez surcharger ces valeurs avec un nom ou une adresse de courriel
 
 De nombreux outils graphiques vous aideront à le faire la première fois que vous les lancerez.
 
-=== Votre éditeur de texte
+==== Votre éditeur de texte
 
 À présent que votre identité est renseignée, vous pouvez configurer l'éditeur de texte qui sera utilisé quand Git vous demande de saisir un message.
 Par défaut, Git utilise l'éditeur configuré au niveau système, qui est généralement Vi ou Vim.
+
 Si vous souhaitez utiliser un éditeur de texte différent, comme Emacs, vous pouvez entrer ce qui suit :
 
 [source,console]
 ----
 $ git config --global core.editor emacs
 ----
 
+On a Windows system, if you want to use a different text editor, you must specify the full path to its executable file.
+This can be different depending on how your editor is packaged.
+
+In the case of Notepad++, a popular programming editor, you are likely to want to use the 32-bit version, since at the time of writing the 64-bit version doesn't support all plug-ins.
+If you are on a 32-bit Windows system, or you have a 64-bit editor on a 64-bit system, you'll type something like this:
+
+[source,console]
+----
+$ git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"
+----
+
+[NOTE]
+====
+Vim, Emacs et Notepad++ sont des éditeurs de texte populaires chez les développeurs sur les systèmes à base Unix tels que Linux et macOS.
+Si vous utilisez un autre éditeur, ou une version 32-bit, veuillez trouver des instructions spécifiques sur la mise en place de votre éditeur favori avec Git dans <<C-git-commands#ch_core_editor>>.
+====
+
 [WARNING]
 ====
-Vim et Emacs sont des éditeurs de texte populaires chez les développeurs sur les systèmes à base Unix tels que Linux et macOS.
-Si vous n'êtes habitué à aucun de ces deux éditeurs ou utilisez un système Windows, il se peut que vous deviez chercher les instructions pour renseigner votre éditeur favori.
-Si vous ne renseignez pas un éditeur et ne connaissez pas Vim ou Emacs, vous risquez fort d'avoir des surprises lorsqu'ils démarreront.
+Si vous ne renseignez pas un éditeur et ne connaissez pas Vim ou Emacs, vous risquez fort d'avoir des surprises lorsque Git tentera de les démarrera.
+Sous Windows par exemple, l'opération de Git pourrait être terminée prématurément pendant une demande de Git à saisir un texte.
 ====
 
-=== Vérifier vos paramètres
+==== Your default branch name
+
+By default Git will create a branch called _master_ when you create a new repository with `git init`.
+From Git version 2.28 onwards, you can set a different name for the initial branch.
+
+To set _main_ as the default branch name do:
+
+[source,console]
+----
+$ git config --global init.defaultBranch main
+----
+
+==== Vérifier vos paramètres
 
 Si vous souhaitez vérifier vos réglages, vous pouvez utiliser la commande `git config --list` pour lister tous les réglages que Git a pu trouver jusqu'ici :
 
@@ -71,8 +108,8 @@ color.diff=auto
 …
 ----
 
-Vous pourrez voir certains paramètres apparaître plusieurs fois car Git lit les mêmes paramètres depuis plusieurs fichiers (`/etc/gitconfig` et `~/.gitconfig`, par exemple).
-Git utilise la dernière valeur pour chaque paramètre.
+Vous pourrez voir certains paramètres apparaître plusieurs fois car Git lit les mêmes paramètres depuis plusieurs fichiers (`[chemin]/etc/gitconfig` et `~/.gitconfig`, par exemple).
+Git utilise la dernière valeur pour chaque paramètre unique qu'il lit.
 
 Vous pouvez aussi vérifier la valeur effective d'un paramètre particulier en tapant `git config <paramètre>` :(((commandes git, config)))
 
@@ -81,3 +118,15 @@ Vous pouvez aussi vérifier la valeur effective d'un paramètre particulier en t
 $ git config user.name
 John Doe
 ----
+
+[NOTE]
+====
+Since Git might read the same configuration variable value from more than one file, it's possible that you have an unexpected value for one of these values and you don't know why.
+In cases like that, you can query Git as to the _origin_ for that value, and it will tell you which configuration file had the final say in setting that value:
+
+[source,console]
+----
+$ git config --show-origin rerere.autoUpdate
+file:/home/johndoe/.gitconfig	false
+----
+====

book/01-introduction/sections/help.asc

@@ -1,5 +1,5 @@
 [[s_git_help]]
-== Obtenir de l'aide
+=== Obtenir de l'aide
 
 Si vous avez besoin d'aide pour utiliser Git, il y a trois moyens d'obtenir les pages de manuel pour toutes les commandes de Git :
 
@@ -21,3 +21,28 @@ $ git help config
 Ces commandes sont vraiment sympathiques car vous pouvez y accéder depuis partout, y compris hors connexion.
 Si les pages de manuel et ce livre ne sont pas suffisants, vous pouvez essayer les canaux `#git` ou `#github` sur le serveur IRC Freenode (irc.freenode.net).
 Ces canaux sont régulièrement fréquentés par des centaines de personnes qui ont une bonne connaissance de Git et sont souvent prêtes à aider.(((IRC)))
+
+In addition, if you don't need the full-blown manpage help, but just need a quick refresher on the available options for a Git command, you can ask for the more concise "`help`" output with the `-h` option, as in:
+
+[source,console]
+----
+$ git add -h
+usage: git add [<options>] [--] <pathspec>...
+
+    -n, --dry-run         dry run
+    -v, --verbose         be verbose
+
+    -i, --interactive     interactive picking
+    -p, --patch           select hunks interactively
+    -e, --edit            edit current diff and apply
+    -f, --force           allow adding otherwise ignored files
+    -u, --update          update tracked files
+    --renormalize         renormalize EOL of tracked files (implies -u)
+    -N, --intent-to-add   record only the fact that the path will be added later
+    -A, --all             add changes from all tracked and untracked files
+    --ignore-removal      ignore paths removed in the working tree (same as --no-all)
+    --refresh             don't add, only refresh the index
+    --ignore-errors       just skip files which cannot be added because of errors
+    --ignore-missing      check if - even missing - files are ignored in dry run
+    --chmod (+|-)x        override the executable bit of the listed files
+----

book/01-introduction/sections/history.asc

@@ -1,6 +1,7 @@
-== Une rapide histoire de Git
+=== Une rapide histoire de Git
 
 Comme de nombreuses choses extraordinaires de la vie, Git est né avec une dose de destruction créative et de controverse houleuse.
+
 Le noyau Linux est un projet libre de grande envergure.(((Linux)))
 Pour la plus grande partie de sa vie (1991–2002), les modifications étaient transmises sous forme de patchs et d'archives de fichiers.
 En 2002, le projet du noyau Linux commença à utiliser un DVCS propriétaire appelé BitKeeper.(((BitKeeper)))