Les dépôts d'Inkscape

Inkscape utilise le gestionnaire de versions Git pour gérer les fichiers du projet. Ceci est un guide rapide présentant le fonctionnement de Git et les commandes permettant de débuter.

La plupart des systèmes de gestion de versions utilisent un emplacement partagé pour publier la dernière version du projet (nous partirons du principe que le projet contient le code source d'un programme). Nous appellerons cet emplacement le tronc (trunk). La première chose à faire lorsque l'on travaille sur un projet est de télécharger son code source, ce qu'on appelle la récupération (checkout). Les fichiers de votre récupération sont appelés la copie de travail (working copy). Une récupération contient la copie des fichiers appartenant au projet, dans laquelle vous pouvez faire des modifications. Lorsque vous êtes prêt à envoyer vos changement aux autres, vous les commettez (commit) et ils sont stockés dans l'emplacement partagé pour que les autres les voient. L'état du projet après les changements de quelqu'un est appelé une révision, et à chaque révision dans Git est attribuée une valeur SHA-1. Ce sont des identifiants uniques pour chaque révision. Pour recevoir les derniers changements introduits par les autres, vous mettez à jour votre copie. La mise à jour ne supprime aucun des changements que vous n'avez pas publiés — ceux-ci sont automatiquement fusionnés (merge).

Les commandes suivantes de Git permettent d'effectuer les opérations décrites ci-dessus.

$ git clone project_trunk_url

Cela récupère le code source d'un projet stocké à l'URL spécifiée.

$ git commit -a

Cela empaquète vos changements. Ils sont alors prêts à être envoyés à l'emplacement partagé. Cela va faire apparaitre une fenêtre d'édition, dans laquelle vous devez entrer un résumé de vos modifications. Cette description pourra être visualisée avec la commande git log.

$ git push

Cela envoie vos changements à l'emplacement partagé, de sorte que les autres puissent les voir.

$ git pull

Cela met à jour votre copie de travail à partir de la dernière révision publique.

Commandes utiles de base

$ git add file

Lorsque vous effectuez une modification sur un fichier, son état initial est « non validé », c'est-à-dire qu'il sera ignoré lors de la prochaine commission. Le paramètre -a (pour all) indiqué ci-dessus valide automatiquement les fichiers ; cependant, il est reste nécessaire d'ajouter les fichiers que Git n'a encore jamais vus et cette commande permet de le faire.

$ git rm -f file

Cela supprime un fichier et son contenu de la gestion de versions et le supprime du disque. La prochaine commande commit le supprimera de l'emplacement partagé. Utilisez l'option --cache à la place de -f si vous souhaitez supprimer le fichier sur l'emplacement partagé mais conserver le fichier non versionné dans votre copie de travail.