diff --git a/TUTO_Git_SourceTree.md b/TUTO_Git_SourceTree.md index 2c00bc5..d8db6ca 100644 --- a/TUTO_Git_SourceTree.md +++ b/TUTO_Git_SourceTree.md @@ -4,26 +4,55 @@ Le but de ce tuto est d'expliquer comment faire des commits proprement sur le Gi ## Table des matières - [1. Introduction & Installation](#1-introduction-installation) -- [2. Comment faire un commit proprement](#2-comment-faire-un-commit-proprement) - - [2.1. Creation des branches](#2-1-creation-des-branches) - - [2.1.1. Créer une branche à son pseudo `mon_pseudo` depuis la branche `master`](#2-1-1-créer-une-branche-à-son-pseudo-mon-pseudo-depuis-la-branche-master) - - [2.1.2. Créer Une branche de travail depuis sa branche `mon_pseudo`](#2-1-2-créer-une-branche-de-travail-depuis-sa-branche-mon-pseudo) - - [2.2. Envoi du premier commit](#2-2-envoi-du-premier-commit) + - [1.1. Prérequis :](#1-1-prérequis) + - [1.2. Cloner le dépôt avec SourceTree :](#1-2-cloner-le-dépôt-avec-sourcetree) + - [1.3. Explications rapides des fonctions de SourceTree utilisées dans ce tuto](#1-3-explications-rapides-des-fonctions-de-sourcetree-utilisées-dans-ce-tuto) +- [2. Créer une branche de travail `mon_pseudo-travail` depuis la branche `master`](#2-créer-une-branche-de-travail-mon-pseudo-travail-depuis-la-branche-master) + - [2.1. Méthode n°1 : depuis SourceTree](#2-1-méthode-n-1-depuis-sourcetree) + - [2.2. Méthode n°2 : depuis l'interface web de Gitea](#2-2-méthode-n-2-depuis-l-interface-web-de-gitea) +- [3. Envoi du premier commit](#3-envoi-du-premier-commit) +- [4. Demande de fusion de notre branche `mon_pseudo-travail` avec `master`](#4-demande-de-fusion-de-notre-branche-mon-pseudo-travail-avec-master) ## 1. Introduction & Installation Ce petit tuto va utiliser l'application SourceTree : [https://www.sourcetreeapp.com/](https://www.sourcetreeapp.com/).
J'ai essayer plusieurs clients Git pour windows et macOS, et la seule (parmis celles essayées) offre une interface graphique assez similaire sur ces deux plateformes, et est assez facile d'utilisation. Ce tuto sera donc en partie rédigé pour utiliser cette application. -Vous devrez aussi avoir installé Git pour windows (ou macos) : [https://git-scm.com/downloads](https://git-scm.com/downloads). Ça pourra être nécessaire si on passe par la ligne de commande. +**Ce tuto va donc servir de guide pour contribuer au dépôt avec le moins possible de ligne de commande, voir aucune.** + +### 1.1. Prérequis : + +- Vous devrez aussi avoir installé Git pour windows (ou macos) : [https://git-scm.com/downloads](https://git-scm.com/downloads). Ça pourra être nécessaire si on passe par la ligne de commande. +- Installer SourceTree.
Une fois Git installé, et SourceTree installé, aller dans les options de SourceTree pour vérifier que le Git utilisé est bien celui que vous venez d'installer (en externe du point de vue de SourceTree) :
+[](https://gitea.zoz-serv.org/Zoz/plex_fr_discord_repo/raw/branch/MilesTEG/Tuto-Git-SourceTree/SourceTree-Git-config.png)
+Tous les autres paramètres étant ceux par défaut. + +### 1.2. Cloner le dépôt avec SourceTree : + +[](https://gitea.zoz-serv.org/Zoz/plex_fr_discord_repo/raw/branch/MilesTEG/Tuto-Git-SourceTree/Capture-05.png)
+Une fois le dépôt cloné, on peut commencer à commiter comme un pro :D. +Vous devriez avoir ce genre d'affichage :
+[](https://gitea.zoz-serv.org/Zoz/plex_fr_discord_repo/raw/branch/MilesTEG/Tuto-Git-SourceTree/Capture-06.png)
+ +### 1.3. Explications rapides des fonctions de SourceTree utilisées dans ce tuto + +Dans ce tuto, nous n'allons pas utiliser beaucoup de fonctionnalités de SourceTree, mais voilà les principales : + +- **Bouton Valider** : permet d'afficher l'écran de validation du commit que l'on s'apprête à finaliser. On peut, et on doit, laisser un bref message indiquant sommairement ce que contient ce commit (en termes d'ajout, modification, etc...).
+ En ligne de commande, ce serait : `git commit -m "ma super modif"`. +- **Bouton Récupérer** : C'est le `git pull`, ça permet de récupérer dans la branche en cours le conteneur d'une branche distante : +- **Bouton Envoyer** : C'est le `git push`, ça permet d'envoyer les modifications locales sur le dépôt distant. En général, je préfère utiliser la case à cocher "Envoyer les modifications vers origin/ma-brancheblabla" à l'étape de validation du commit (voir plus bas). +- **Bouton Rapatrier** : Je l'utilise lorsque je suis sur la branche `master` pour récupérer les données et enlever de SourceTree les branches distantes qui ont été supprimées. +- **Bouton Changer de branche** : C'est avec ce bouton que je crée une nouvelle branche depuis la de départ `master`. -## 2. Comment faire un commit proprement +## 2. Créer une branche de travail `mon_pseudo-travail` depuis la branche `master` -### 2.1. Creation des branches +#### 2.1. Méthode n°1 : depuis SourceTree -#### 2.1.1. Créer une branche à son pseudo `mon_pseudo` depuis la branche `master` +#### 2.2. Méthode n°2 : depuis l'interface web de Gitea -#### 2.1.2. Créer Une branche de travail depuis sa branche `mon_pseudo` +## 3. Envoi du premier commit + +## 4. Demande de fusion de notre branche `mon_pseudo-travail` avec `master` -### 2.2. Envoi du premier commit diff --git a/Tuto-Git-SourceTree/Capture-06.png b/Tuto-Git-SourceTree/Capture-06.png index bcbce67..55d5ae0 100644 Binary files a/Tuto-Git-SourceTree/Capture-06.png and b/Tuto-Git-SourceTree/Capture-06.png differ diff --git a/Tuto-Git-SourceTree/Capture-18.png b/Tuto-Git-SourceTree/Capture-18.png new file mode 100644 index 0000000..339c7dc Binary files /dev/null and b/Tuto-Git-SourceTree/Capture-18.png differ diff --git a/Tuto-Git-SourceTree/Capture-19.png b/Tuto-Git-SourceTree/Capture-19.png new file mode 100644 index 0000000..99d2461 Binary files /dev/null and b/Tuto-Git-SourceTree/Capture-19.png differ diff --git a/Tuto-Git-SourceTree/Capture-20.png b/Tuto-Git-SourceTree/Capture-20.png new file mode 100644 index 0000000..8a751ad Binary files /dev/null and b/Tuto-Git-SourceTree/Capture-20.png differ diff --git a/Tuto-Git-SourceTree/Capture-21.png b/Tuto-Git-SourceTree/Capture-21.png new file mode 100644 index 0000000..736137f Binary files /dev/null and b/Tuto-Git-SourceTree/Capture-21.png differ diff --git a/Tuto-Git-SourceTree/Capture-22.png b/Tuto-Git-SourceTree/Capture-22.png new file mode 100644 index 0000000..7947dd0 Binary files /dev/null and b/Tuto-Git-SourceTree/Capture-22.png differ diff --git a/Tuto-Git-SourceTree/Capture-23.png b/Tuto-Git-SourceTree/Capture-23.png new file mode 100644 index 0000000..bb4dada Binary files /dev/null and b/Tuto-Git-SourceTree/Capture-23.png differ diff --git a/Tuto-Git-SourceTree/Capture-24.png b/Tuto-Git-SourceTree/Capture-24.png new file mode 100644 index 0000000..126a24e Binary files /dev/null and b/Tuto-Git-SourceTree/Capture-24.png differ diff --git a/Tuto-Git-SourceTree/Capture-25.png b/Tuto-Git-SourceTree/Capture-25.png new file mode 100644 index 0000000..d150044 Binary files /dev/null and b/Tuto-Git-SourceTree/Capture-25.png differ diff --git a/Tuto-Git-SourceTree/Capture-26.png b/Tuto-Git-SourceTree/Capture-26.png new file mode 100644 index 0000000..899997f Binary files /dev/null and b/Tuto-Git-SourceTree/Capture-26.png differ diff --git a/Tuto-Git-SourceTree/Capture-27.png b/Tuto-Git-SourceTree/Capture-27.png new file mode 100644 index 0000000..d66335b Binary files /dev/null and b/Tuto-Git-SourceTree/Capture-27.png differ diff --git a/Tuto-Git-SourceTree/Capture-28.png b/Tuto-Git-SourceTree/Capture-28.png new file mode 100644 index 0000000..021c5a6 Binary files /dev/null and b/Tuto-Git-SourceTree/Capture-28.png differ