# Formation Git : Introduction et Prise en Main 🚀 Bienvenue dans ce tutoriel ! Suivez ces étapes pour apprendre à utiliser Git et contribuer efficacement au projet **Astroport.solo**. 🌟 --- ## Prérequis 📋 ### Installation de Git Sur un système **Linux**, ouvrez un terminal et installez Git : ```bash sudo apt install git ``` Pour les utilisateurs de **Windows**, téléchargez et installez Git depuis [Git for Windows](https://gitforwindows.org/). Vous aurez accès à un terminal Git (Git Bash) pour suivre cette formation. --- ## Connectez-vous à votre compte GitHub 👤 Créez un compte GitHub si ce n’est pas déjà fait : [GitHub.com](https://github.com) Ensuite, connectez-vous à votre compte : ```bash VOTRECOMPTE=<votre-nom-utilisateur-GitHub> ``` --- ## Forker le projet Astroport.solo 🍴 Un "fork" permet de créer une copie personnelle d’un projet sur votre compte GitHub. Allez sur le dépôt officiel et forkez-le : [Astroport.solo](https://github.com/papiche/Astroport.solo) Vous aurez maintenant votre propre version du projet dans `https://github.com/$VOTRECOMPTE/Astroport.solo`. --- ## Configurer les clés SSH 🔐 ### Pourquoi des clés SSH ? Les clés SSH permettent de sécuriser les connexions entre votre ordinateur et GitHub sans avoir à entrer un mot de passe à chaque fois. ### Créez une clé SSH avec chiffrement ED25519 Dans votre terminal : ```bash ssh-keygen -t ed25519 -C 'votre@email' ``` Cela crée une paire de clés privée/publique dans le répertoire `~/.ssh`. Ensuite, affichez votre clé publique : ```bash cat ~/.ssh/id_ed25519.pub ``` ### Ajoutez votre clé publique sur GitHub 1. Connectez-vous à votre compte GitHub. 2. Allez dans **Settings** → **SSH and GPG keys** → **New SSH key**. 3. Copiez le contenu de `id_ed25519.pub` et collez-le dans le champ prévu. Donnez un nom à la clé (ex. : "Mon PC"). 4. Validez en cliquant sur **Add SSH key**. --- ## Cloner le dépôt dans votre espace de travail 🖥️ Créez un dossier pour votre projet : ```bash mkdir ~/workspace cd ~/workspace ``` Clonez votre fork : ```bash git clone git@github.com:$VOTRECOMPTE/Astroport.solo.git ``` Vous aurez maintenant une copie locale du projet dans `~/workspace/Astroport.solo`. --- ## Créez une branche pour vos modifications 🌱 Dans Git, une **branche** permet de travailler sur une nouvelle fonctionnalité ou une correction sans affecter le reste du projet. Créez et passez sur une branche appelée `myaddon` : ```bash cd ~/workspace/Astroport.solo git branch myaddon git checkout myaddon ``` Vous êtes maintenant prêt à modifier le code ! 🎉 --- ## Modifiez le code, puis publiez vos changements ✏️📤 ### Étapes pour publier votre travail : 1. **Ajoutez les fichiers modifiés** : ```bash git add . ``` 2. **Validez les modifications avec un message clair** : ```bash git commit -m 'Ajout de ma fonctionnalité' ``` 3. **Envoyez vos modifications sur GitHub** : ```bash git push ``` Vos changements sont maintenant sur votre fork GitHub. ✅ --- ## Faites une Pull Request (PR) 🔄 Une **Pull Request** permet de proposer vos modifications au projet principal. Pour cela : 1. Allez sur la page de votre dépôt : [https://github.com/$VOTRECOMPTE/Astroport.solo](https://github.com/$VOTRECOMPTE/Astroport.solo) 2. Cliquez sur **Compare & Pull Request**. 3. Rédigez un commentaire clair expliquant vos modifications. 4. Envoyez votre PR au projet principal de `papiche`. **Bravo 🎉** : Vous avez contribué au projet ! --- ## Gardez votre fork à jour avec le dépôt principal 🔄 Pour synchroniser votre fork avec les dernières modifications : 1. Configurez le dépôt principal comme une nouvelle **remote** : ```bash git remote add upstream git@github.com:papiche/Astroport.solo.git ``` 2. Récupérez les modifications : ```bash git fetch upstream git merge upstream/main ``` Ainsi, votre fork sera toujours à jour. 🕊️ --- ## Extra tips 🧙 - Rejoignez la communauté **Astroport.ONE Dragon Swarm** pour collaborer et échanger : [Astroport.ONE](https://github.com/papiche/Astroport.ONE) - Explorez le **Ğ1FabLab** et ses projets innovants si vous travaillez avec la Monnaie Libre. - Si vous utilisez Windows, privilégiez **Git Bash** pour suivre ce guide. --- Prêt pour la suite ? **À vous de jouer !** ✨