Créer, modifier et publier un dépot git
Last updated
Last updated
Remarques : les éléments entre $$, comme $VOTRENOM$ doivent être adapté par vos soins pour votre ordinateur.
Le répertoire sous Windows qui correspond à vos document est le suivant : C:\Users\$VOTRENOM$\Documents\
Dans ce répertoire nous allons créer un dossier "Repository" qui contiendra le dépot git de notre modèle. Attention à la majuscule...
Lancer le logiciel SourceTree qui sert de client graphique pour le programme git. Normalement vous devez déjà avoir configuré le logiciel pour fonctionner avec GitHub. Si ce n'est pas le cas faite d'abord la partie prérequis.
Dans la barre de menu, cliquez sur l'onglet Create qui permet d'initialiser un nouveau depot git vide :
SourceTree va créer un nouveau dépot "monModeleMaps" dans C:\Users\$VOTRENOM$\Documents\Repository\ et le relier à votre compte utilisateur GitHub [Repository Settings] lorsque vous allez appuyer sur le bouton [Créer].
Des informations vous sont demandées, elles serviront à identifier les modifications par la suite.
Après création, voici l'interface de gestion de votre dépot git.
Le dépot git vide apparait en local dans C:\Users\$VOTRENOM$\Documents\Repository\monModeleMaps et en ligne sur github à l'url suivante https://github.com/$VOTRELOGINGITHUB$/monModeleMaps
Comme vous le voyez il n'y a rien.
A nouveau dans SourceTree, cliquez sur le petit + pour ouvrir un nouvel onglet.
A tout moment vous pouvez voir les dépot git en local en cliquant sur l'icone [Local] dans la barre, et les dépot git en ligne en cliquant sur l'icone [Remote]
Nous allons à présent ajouter des fichiers à notre nouveau dépot.
Télécharger le zip suivant , qui contient le modele ants.nlogo, et décompresser le. Faite ensuite glisser les fichiers Ants.nlogo et Ants.png dans notre dépot C:\Users\$VOTRENOM$\Documents\Repository\monModeleMaps
Si vous revenez dans l'onglet monModeleMaps vous verrez que les fichiers sont apparus dans la fenêtre du bas. Comme ce sont de nouveau fichier, SourceTree nous indique qu'il ne sont pas encore indexé par git, ce qui est le comportement par défaut.
Cliquez sur le bouton [ToutIndexer] pour que git commence à suivre les modifications sur ces fichiers. Comme vous le voyez les fichiers passe dans la zone du haut.
Validons ce nouvel état du dépot. Pour cela il suffit de rentrer un message dans la fenetre du bas, qui sert à indiquer aux autres utilisateurs du dépot les modifications que nous avons faites sur le modèle. Dans le cas présent nous avons juste ajouter des fichiers.
Cliquez ensuite sur [valider] (ce qui correspond à la commande commitdans git) pour voir ce qu'il se passe. De nouveau SourceTree qu'il n'y a plus rien à valider. Pour le moment nous avons juste travailler en local, cliquez sur la flèche [envoyer] du bandeau pour envoyer les modifications que nous venons de faire sur GitHub. Une fenetre s'ouvre, cochez la case dans la colonne [Envoyer] puis cliquez sur le bouton [Envoyer]
Si vous retournez voir votre dépot en ligne sur le site GitHub, celle-ci a été mise à jour.
Faisons une modifications dans le fichier Ants.nlogo pour voir ce qu'il se passe dans SourceTree.
Comme vous pouvez le voir sur l'image ci-dessous, git a detecté que j'ai modifié la taille et la couleur des fourmis. En rouge apparait ce qui a été supprimé, et en vert ce qui a été ajouté.
Pour valider ces modifications, il faut à nouveau [indexer] le fichier, puis le [valider] en écrivant un message explicatif.
Si vous cliquez sur la droite sur l'icone [BRANCHES], puis [master] vous pouvez observer l'historique du projet, avec, ce qui est important, la possibilité de visionner les modifications en cliquant sur les différentes lignes. Il est également possible de revenir en arrière, mais nous en parlerons ensuite.
Si nous nous intéressons aux deux lignes suivantes, l'état du dépot local est indiqué par l'icone [master], et l'état du dépot en ligne par l'icone [origin/master].
Comme vous vous en doutiez, l'état local est en effet en avance sur le dépot central, cliquons sur [envoyer] pour synchroniser les deux dépots, comme ci dessous. Vous pouvez regarder en ligne sur github pour vérifier.
Aller sur l'url de votre modèle github https://github.com/$VOTRELOGINGITHUB$/monModeleMaps et cliquez sur le bouton clone or download.
Vous pouvez partager l'url en https qui apparait (https://github.com/$VOTRELOGINGITHUB$/monModeleMaps.git) avec votre voisin qui va à présent tenter de cloner votre dépot sur son ordinateur et d'ajouter un fichier README.md
Dans SourceTree, cliquez sur l'icone [Clone]
Entrez l'adresse git https qui vous a été donné par votre voisin, et indiquez l'endroit ou vous voulez que soit cloner le dépot en ligne sur votre ordinateur. Nous choisissons de le mettre dans le même répertoire Repository, sous le nom modeleDeMonVoisin (Attention, le dossier ne doit pas exister !!)
Appuyez ensuite sur le bouton [Cloner]
Comme vous pouvez le constater, un nouveau dossier est apparu dans votre arborescence :
Nous allons rajouter un fichier README.md à ce dépot modeleDeMonVoisin. Ce fichier est automatiquement affiché en page d'accueil du dépot lorsqu'on se rend sur l'url du site, c'est pratique par exemple pour mettre de la documentation. Ajouter ce texte au fichier README.md :
Revenez dans SourceTree, à l'onglet modeleDeMonVoisin. Comme vu précédemment, [Indexer] le fichier, ajouter un message dans le formulaire en bas, et [Valider].
Nous allons maintenant tenter de recupérer les modifications faites par votre voisin sur votre projet. Pour cela revenez dans l'onglet monModeleMaps et cliquer sur l'icone [Récupérer].
Une fenetre s'ouvre, faite simplement [Ok]
Voilà, nous avons récupérer les modifications faites par votre voisin ! Vous pouvez consulter l'url du dépot sur github pour voir l'affichage du README.md
# Updloader votre modèle sur GitHub
