Setup and Config
Getting and Creating Projects
Basic Snapshotting
Branching and Merging
Sharing and Updating Projects
Inspection and Comparison
Patching
Debugging
External Systems
Server Admin
Guides
- gitattributes
- Command-line interface conventions
- Everyday Git
- Frequently Asked Questions (FAQ)
- Glossary
- Hooks
- gitignore
- gitmodules
- Revisions
- Submodules
- Tutorial
- Workflows
- All guides...
Administration
Plumbing Commands
- 2.47.0 10/06/24
- 2.45.1 → 2.46.2 no changes
- 2.45.0 04/29/24
- 2.44.1 → 2.44.2 no changes
- 2.44.0 02/23/24
- 2.43.1 → 2.43.5 no changes
- 2.43.0 11/20/23
- 2.42.1 → 2.42.3 no changes
- 2.42.0 08/21/23
- 2.38.1 → 2.41.2 no changes
- 2.38.0 10/02/22
- 2.35.1 → 2.37.7 no changes
- 2.35.0 01/24/22
- 2.30.1 → 2.34.8 no changes
- 2.30.0 12/27/20
- 2.29.1 → 2.29.3 no changes
- 2.29.0 10/19/20
- 2.28.1 no changes
- 2.28.0 07/27/20
- 2.27.1 no changes
- 2.27.0 06/01/20
- 2.21.1 → 2.26.3 no changes
- 2.21.0 02/24/19
- 2.13.7 → 2.20.5 no changes
- 2.12.5 09/22/17
- 2.10.5 → 2.11.4 no changes
- 2.9.5 07/30/17
- 2.5.6 → 2.8.6 no changes
- 2.4.12 05/05/17
- 2.3.10 no changes
- 2.2.3 09/04/15
- 2.1.4 no changes
- 2.0.5 12/17/14
SYNOPSIS
git init
[-q
|--quiet
] [--bare
] [--template=
<répertoire-modÚle>] [--separate-git-dir
<répertoire-git>] [--object-format=
<format>] [--ref-format=
<format>] [-b
<nom-de-branche> |--initial-branch=
<nom-de-branche>] [--shared[
=++<permissions>]] [<répertoire>]
DESCRIPTION
Cette commande crée un dépÎt Git vide - essentiellement un répertoire .git
avec des sous-répertoires pour les fichiers objects
, refs/heads
, refs/tags
et les fichiers de modÚle. Une branche initiale sans aucun commit sera créée (voir loption --initial-branch
ci-dessous pour son nom).
Si la variable d’environnement $GIT_DIR
est définie, alors elle spécifie un chemin à utiliser au lieu de ./.git
comme base du dépÎt.
Si le rĂ©pertoire de stockage d’objets est spĂ©cifiĂ© via la variable d’environnement $GIT_OBJECT_DIRECTORY
, alors les répertoires sha1 sont créés dedans ; sinon le répertoire par défaut $GIT_DIR/objects
est utilisé.
Exécuter git init
dans un dĂ©pĂŽt existant est sĂ©curisĂ©. Cela n’Ă©crasera pas des choses qui sont dĂ©jĂ dedans. La raison principale de rĂ©-exĂ©cuter git init
est de récupérer les modÚles récemment ajoutés (ou de déplacer le dépÎt ailleurs si --separate-git-dir
est fourni).
OPTIONS
-
-q
-
--quiet
-
N’afficher que les messages d’erreur et d’alerte ; toutes les autres sorties seront supprimĂ©es.
-
--bare
-
CrĂ©er un dĂ©pĂŽt nu. Si l’environnement
GIT_DIR
n’est pas dĂ©fini, alors il est dĂ©fini au rĂ©pertoire de travail courant. -
--object-format=
<format> -
SpĂ©cifier le <format> d’objet donnĂ© (algorithme d’empreinte) pour le dĂ©pĂŽt. Les valeurs valides sont
sha1
et (si activé)sha256
.sha1
est la valeur par dĂ©faut.NoteâŻ: Ă l’heure actuelle, il n’y a pas d’interopĂ©rabilitĂ© entre les dĂ©pĂŽts SHA-256 et les dĂ©pĂŽts SHA-1.
Historiquement, nous avons averti que les dĂ©pĂŽts SHA-256 pourraient plus tard avoir besoin de changements incompatibles avec les versions prĂ©cĂ©dentes lorsque nous introduirons ces caractĂ©ristiques d’interopĂ©rabilitĂ©. Aujourd’hui, nous nous attendons seulement Ă des changements compatibles. De plus, si de tels changements s’avĂšrent nĂ©cessaires, on peut s’attendre Ă ce que les dĂ©pĂŽts SHA-256 crĂ©Ă©s avec le Git d’aujourd’hui soient utilisables par les versions futures de Git sans perte de donnĂ©es.
-
--ref-format=
<format> -
SpĂ©cifier le <format> de stockage de rĂ©f donnĂ© pour le dĂ©pĂŽt. Les valeurs valides sontâŻ:
-
files
pour des fichiers perdus avec des refs emballés. Valeur par défaut. -
reftable
pour le format reftable. Ce format est expérimental et son fonctionnement interne est sujet à changement.
-
-
--template=
<répertoire-de-modÚles> -
SpĂ©cifier le dossier depuis lequel les modĂšles seront utilisĂ©s (Voyez la section « DOSSIER MODĂLE » ci-dessous.)
-
--separate-git-dir=
<répertoire-git> -
Au lieu d’initialiser le dĂ©pĂŽt en tant que rĂ©pertoire dans soit
$GIT_DIR
soit./.git
, y crĂ©er un fichier texte contenant le chemin du dĂ©pĂŽt rĂ©el. Ce fichier agit comme un lien symbolique Git indĂ©pendant du systĂšme de fichier vers le dĂ©pĂŽt.Si c’est une rĂ©initialisation, le dĂ©pĂŽt sera dĂ©placĂ© vers le chemin spĂ©cifiĂ©.
-
-b
<nom-de-branche> -
--initial-branch=
<nom-de-branche> -
Utiliser <nom-de-branche> pour la branche initiale dans le dĂ©pĂŽt nouvellement crĂ©Ă©. S’il n’est pas spĂ©cifiĂ©, revenir au nom par dĂ©faut (actuellement
master
, mais ceci est susceptible de changer Ă l’avenirâŻ; le nom peut ĂȘtre personnalisĂ© via la variable de configurationinit.defaultBranch
). -
SpĂ©cifier que le dĂ©pĂŽt Git doit ĂȘtre partagĂ© entre plusieurs utilisateurs. Ceci permet Ă des utilisateurs faisant partie du mĂȘme groupe de pousser dans ce dĂ©pĂŽt. Lorsque que cette option est spĂ©cifiĂ©e, la variable de configuration
core.sharedRepository
est définie de telle sorte que les fichiers et les dossiers sous$GIT_DIR
sont crĂ©Ă©s avec les permissions demandĂ©es. Lorsqu’elle n’est pas spĂ©cifiĂ©e, Git utilisera les permissions rapportĂ©es par umask(2).L’option peut avoir les valeurs suivantes, prenant par dĂ©faut la valeur
group
si aucune valeur n’est renseignĂ©eâŻ:-
umask
-
false
-
Utiliser les permissions rapportées par
umask
(2). Valeur par défaut, quand--shared
n’est pas spĂ©cifiĂ©. -
group
-
true
-
Rendre le dépÎt modifiable par groupe (et
g+sx
, puisque le groupe git peut ne pas ĂȘtre le groupe principal de tous les utilisateurs). Ceci est utilisĂ© pour assouplir les permissions d’une valeurumask
(2) par ailleurs sĂ»re. Notez que umask s’applique toujours aux autres bits d’autorisation (par exemple, si umask est dĂ©fini sur0022
, l’utilisation degroup
ne supprime pas les privilĂšges de lecture des autres utilisateurs (non membres du groupe)). Voir0xxx
pour savoir comment spécifier exactement les autorisations du dépÎt. -
all
-
world
-
everybody
-
Comme
group
, mais rendre le dépÎt lisible par tous les utilisateurs. - <perm>
-
<perm>âŻ; est un nombre octal Ă 3 chiffres prĂ©fixĂ© par
0
et chaque fichier aura le mode <perm>. <perm> surchargera la valeurumask
(2) des utilisateurs (en plus d’assouplir les permissions commegroup
etall
le font).0640
créera un dépÎt qui est lisible par groupe, mais pas modifiable par groupe ni accessible aux autres.0660
crĂ©era un dĂ©pĂŽt lisible et modifiable par l’utilisateur et le groupe courants, mais inaccessible aux autres (les rĂ©pertoires et les fichiers exĂ©cutables obtiennent leur bitx
du bitr
pour les classes d’utilisateurs correspondantes).
-
Par dĂ©faut, l’option de configuration receive.denyNonFastForwards
est activée dans les dépÎts partagés, de telle sorte que vous ne pouvez pas forcer une poussée qui ne serait pas en avance rapide.
Si vous renseignez un <dossier>, la commande est exĂ©cutĂ©e Ă l’intĂ©rieur de celui-ci. Si ce dossier n’existe pas, il sera crĂ©Ă©.
DOSSIER MODĂLE
Les fichiers et les dossiers dans le dossier modÚle dont le nom ne commence pas par un point seront copiés dans le $GIT_DIR
aprĂšs qu’il sera crĂ©Ă©.
Le dossier modĂšle sera l’un des suivants (dans l’ordre)Â :
-
l’argument fourni avec l’option
--template
 ; -
le contenu de la variable d’environnement
$GIT_TEMPLATE_DIR
 ; -
la variable de configuration
init.templateDir
 ; ou -
le dossier modÚle par défaut :
/usr/share/git-core/templates
.
Le dossier modĂšle par dĂ©faut inclut une certaine structure de dossier, des "modĂšles d’exclusions" suggĂ©rĂ©s (voir gitignore[5]), et des exemples de fichiers crochet.
Les exemples de crochets sont tous dĂ©sactivĂ©s par dĂ©faut. Pour activer l’un des exemples de crochets, renommez-le en enlevant le suffixe .sample
.
Voir githooks[5] pour des informations plus gĂ©nĂ©rales sur l’exĂ©cution d’un crochet.
EXEMPLES
- Démarrer un nouveau dépÎt Git pour une base de code existante
-
$ cd /chemin/vers/mon/code/de/base $ git init (1) $ git add . (2) $ git commit (3)
-
Créer un dossier
/chemin/vers/mon/code/de/base/.git
. -
Ajouter tous les fichiers existants Ă l’index.
-
Enregistrer l’Ă©tat d’origine comme le premier commit dans l’historique.
-
CONFIGURATION
Warning
|
Missing See original version for this content. |
Warning
|
Missing See original version for this content. |
GIT
Fait partie de la suite git[1]
TRADUCTION
Cette page de manuel a été traduite par Jean-Noël Avila <jn.avila AT free DOT fr> et les membres du projet git-manpages-l10n. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le site https://github.com/jnavila/git-manpages-l10n .