Créer un nouveau fichier

Pour votre premier commit, vous allez créer un fichier README.md à la racine avec le contenu de votre choix.

$ vi README.md

Commandes vi utiles:

• 'i' pour éditer du texte (mode insertion)
• copier/coller: en mode insertion, utiliser la souris et utilisez le menu édition du terminal.
• touche pour sortir du mode insertion
• ':' pour afficher le prompt de commandes
• 'q' pour quitter
• 'w' pour sauvegarder
• 'x' pour effacer le caractère courant
• 'dd' pour effacer la ligne courante

Regardez l'état du dépot:

$ git status
Sur la branche master

Validation initiale

Fichiers non suivis:
  (utilisez "git add <fichier>..." pour inclure dans ce qui sera validé)

    README.md

aucune modification ajoutée à la validation mais des fichiers non suivis
sont présents (utilisez "git add" pour les suivre)

Vous pouvez à tout moment utiliser cette commande pour voir où vous en êtes. Connaissant l'état courant de vos manipulations, cette commande donne des indications contextualisées sur ce que vous pouvez (ou devez) faire. Ici par exemple, elle vous invite à ajouter ce fichier dans l'index.

Mettre le fichier dans l'index

L'index peut être vu comme une zone de transit en attente de validation.

$ git add README.md
$ git status
Sur la branche master

Validation initiale

Modifications qui seront validées :
  (utilisez "git rm --cached <fichier>..." pour désindexer)

    nouveau fichier : README.md

git status montre ici que le fichier est passé dans l'index. Il est prêt à être validé, ce qui enregistrera dans un dépôt local la version du fichier se trouvant actuellement dans la zone d'index.
Comme il s'agit d'un nouveau fichier, la commande permettant le désindexage (pour sortir le fichier de l'index) est proposée.

Commiter le fichier

Pour valider le nouveau fichier et, ainsi, créer votre premier commit:

$ git commit

L'éditeur de texte qui s'ouvre vous permettra de fournir un commentaire explicatif de ce que vous allez déposer.
Le texte est libre, mais l'usage est de renseigner le titre du commit en première ligne, puis de passer une ligne vide, et ensuite de
mettre un commentaire long.
Sauvegardez le texte et quittez l'éditeur (<esc>:wq avec vi), et le commit est réalisé.

Vérifiez que git status vous dit que plus rien n'est à valider.

A la différence des VCS centralisés tel que SVN, le commit n'est qu'une validation (un enregistrement) local, qui ne nécessite pas de serveur sur le réseau.