Utiliser Git/Github

Débuter Git et GitHub :

Les projets arrivent à grand pas, il est donc nécessaire d’apprendre a travailler a plusieurs. Le mieux c’est de regarder la documentation officielle donnée par github.

Qu’est-ce que Git et GitHub ?

Git est un système de contrôle de version qui permet de suivre les modifications apportées à des fichiers et de collaborer avec d’autres développeurs sur des projets. GitHub, quant à lui, est une plateforme web qui héberge des dépôts Git et facilite la collaboration, le suivi des problèmes, la gestion des tâches et bien plus encore.

Voir le vocabulaire liée a Git

Étapes pour utiliser Git et GitHub :

1. Installation de Git :
   • Téléchargez et installez Git à partir du site officiel : git-scm.com.
   • Suivez les instructions d’installation pour votre système d’exploitation.
2. Configuration initiale :

   • Ouvrez un terminal (ou une invite de commande) et configurez votre nom d’utilisateur et votre adresse e-mail :

     git config --global user.name "Votre Nom"
     git config --global user.email "votre@email.com"
     

3. Création d’un compte GitHub :
   • Rendez-vous sur GitHub et créez un compte si vous n’en avez pas déjà un.
4. Création d’un nouveau dépôt sur GitHub :
   • Cliquez sur le bouton “New” sur la page d’accueil de GitHub pour créer un nouveau dépôt.
   • Donnez-lui un nom, une description et choisissez les options de visibilité (public ou privé).
   • Cliquez sur “Create repository” pour créer le dépôt.
5. Clonage du dépôt :
   • Copiez l’URL du dépôt que vous venez de créer sur GitHub.

   • Dans votre terminal, utilisez la commande git clone suivie de l’URL du dépôt :

     git clone <URL_du_dépôt>
     

6. Ajout de fichiers :
   • Placez les fichiers que vous souhaitez suivre dans le dépôt cloné.

   • Utilisez git add pour ajouter des fichiers au suivi :

     git add nom_du_fichier
     

7. Validation des modifications :

   • Utilisez git commit pour valider les modifications :

     git commit -m "Message de validation des modifications"
     

8. Pousser les modifications sur GitHub :

   • Utilisez git push pour pousser vos modifications vers GitHub :

     git push origin master
     

   Remplacez master par le nom de votre branche si vous utilisez une branche différente.

9. Mise à jour locale :

   • Si d’autres contributeurs ont apporté des modifications au dépôt distant, vous pouvez les récupérer en utilisant git pull :

     git pull origin master
     

10. Création de branches et fusion :

    • Utilisez git branch pour créer une nouvelle branche :

      git branch nom_de_la_branche
      

    • Utilisez git checkout pour basculer vers une branche :

      git checkout nom_de_la_branche
      

    • Une fois que vous avez terminé votre travail sur une branche, fusionnez-la avec la branche principale :

      git merge nom_de_la_branche
      

C’est un guide de démarrage rapide pour utiliser Git et GitHub. Avec ces bases, vous devriez être en mesure de commencer à travailler sur des projets et à collaborer avec d’autres développeurs.

N’oubliez pas de consulter la documentation officielle de Git et GitHub pour en savoir plus sur les fonctionnalités avancées.

Définitions associées à Git :

1. Git : Un système de contrôle de version distribué qui permet de suivre les modifications apportées aux fichiers et de coordonner le travail entre plusieurs personnes sur un projet.

2. Dépôt (Repository) : Un endroit où Git stocke les métadonnées et les objets de base de données pour votre projet. Il peut être local sur votre machine ou distant sur un serveur.

3. Commit : Une validation ou un enregistrement d’un ensemble de modifications dans un dépôt Git. Chaque commit est accompagné d’un message descriptif pour expliquer les modifications apportées.

4. Branche (Branch) : Une version parallèle de votre projet. Les branches permettent de travailler sur des fonctionnalités ou des correctifs sans perturber la branche principale (généralement appelée “master” ou “main”).

5. Pousser (Push) : L’action de transférer les commits locaux vers un dépôt distant, mettant ainsi à jour les branches correspondantes sur le dépôt distant.

6. Tirer (Pull) : L’action de récupérer les commits d’un dépôt distant et de les fusionner dans votre dépôt local. Cela met à jour votre branche locale avec les dernières modifications du dépôt distant.

7. Fusionner (Merge) : L’action de combiner les modifications de deux branches différentes. Lorsque vous fusionnez une branche dans une autre, Git combine les modifications de chaque branche de manière à préserver autant de travail que possible.

8. Cloner (Clone) : L’action de créer une copie locale d’un dépôt distant. Cela crée une copie de travail complète du dépôt, y compris toutes les branches et les commits.

9. Stash : L’action de stocker temporairement des modifications non validées afin de les récupérer plus tard. Cela permet de travailler sur une autre tâche sans commettre les modifications en cours.

10. État (Status) : L’action de vérifier l’état actuel de votre répertoire de travail par rapport au dépôt Git. Cela montre les fichiers modifiés, les fichiers ajoutés et les fichiers non suivis.

11. Démarquer (Unstage) : L’action d’enlever des fichiers de la zone de staging (zone de préparation). Cela signifie que les fichiers ne seront pas inclus dans le prochain commit.

12. Zone de staging (Staging Area) : Une zone intermédiaire où les fichiers modifiés sont préparés pour être inclus dans le prochain commit. Les fichiers ajoutés à la zone de staging seront inclus dans le prochain commit.

Ces termes sont fondamentaux pour comprendre et utiliser Git efficacement dans le développement de logiciels.

Utilisation de Git avec VSCode/Codium (version la plus simple) :

1. Installation de l’extension Git :
   • Ouvrez Visual Studio Code.
   • Allez dans l’onglet des extensions en cliquant sur l’icône en forme de carré dans la barre latérale ou en utilisant le raccourci Ctrl+Shift+X.
   • Recherchez “Git” dans la barre de recherche.
   • Installez l’extension proposée par GitHub.
2. Interface Git intégrée :
   • Une fois l’extension installée, vous verrez une nouvelle icône en forme de branche dans la barre latérale de VSCode.
   • Cliquez sur cette icône pour accéder à l’interface Git intégrée de VSCode, où vous pouvez effectuer des opérations telles que l’ajout, la validation et la poussée de vos modifications.
3. Utilisation de l’onglet Source Control :
   • VSCode dispose également d’un onglet “Source Control” (Contrôle de Source) situé dans la barre latérale.
   • Cliquez sur l’onglet “Source Control” pour afficher les fichiers modifiés dans votre dépôt Git.
   • Vous pouvez voir les modifications apportées à chaque fichier, les étapes de suivi, les commits non poussés, etc.
   • Pour effectuer des actions telles que l’ajout, la validation et la poussée de vos modifications, utilisez les options disponibles dans cet onglet.
   • Vous pouvez également voir les branches actuelles, créer de nouvelles branches et basculer entre elles à partir de cet onglet.

L’onglet “Source Control” de VSCode offre une interface conviviale pour gérer vos modifications Git directement depuis l’éditeur, ce qui simplifie le processus de suivi, de validation et de poussée des modifications vers votre dépôt GitHub.

Utilisation des fichiers README.md et LICENSE :

1. README.md :
   • Le fichier README.md est un document au format Markdown qui se trouve généralement à la racine de votre dépôt GitHub.
   • Pour voir comment écrire en Markdown voir la documentation
   • Il sert à fournir des informations sur votre projet aux autres développeurs, comme des instructions d’installation, des exemples d’utilisation, des informations sur la contribution, etc.
   • Vous pouvez utiliser Markdown pour formater le texte, ajouter des images, des liens et même des extraits de code.
   • Assurez-vous d’inclure des sections importantes telles que “Installation”, “Utilisation”, “Contribuer”, “Licence”, etc.
2. LICENSE :
   • Le fichier LICENSE est un fichier texte qui spécifie les conditions de distribution et d’utilisation de votre projet.
   • Il est crucial d’inclure une licence pour définir clairement les droits et les restrictions associés à votre projet.
   • GitHub propose plusieurs modèles de licences courantes que vous pouvez choisir en fonction de vos besoins.
   • Pour ajouter une licence, créez un fichier nommé LICENSE à la racine de votre dépôt et copiez-y le texte de la licence choisie.

En incluant un README.md informatif et en choisissant une licence appropriée, vous rendez votre projet plus accessible et vous établissez les règles pour sa distribution et son utilisation.

Tutoriel GitHub Pages : Création et Déploiement d’un Site Web Statique

Vous avez besoin de montrer votre projet ? Vous avez une documentation a héberger (ex: Génération de documentation avec doxygen) ? github le fait pour vous !

1. Création du Répertoire GitHub :
   • Connectez-vous à votre compte GitHub sur github.com.
   • Cliquez sur le bouton “New” pour créer un nouveau dépôt.
   • Nommez votre dépôt selon vos préférences. Par exemple, mon-projet.
   • Choisissez la visibilité (public ou privé) et cliquez sur “Create repository”.

Attention si votre dépôt est privé, il faut avoir l’abonnement github pro pour que cela fonctionne. Il est gratuit pour les étudiant avec le student pack.

1. Création du Site Web :
   • Créez ou utilisez un projet existant contenant vos fichiers HTML, CSS, JavaScript, etc. pour votre site web statique.
   • Assurez-vous que votre projet contient un fichier index.html, car GitHub Pages utilisera ce fichier comme page d’accueil par défaut.

Vous pouvez aussi utiliser des outils tel que jekyll ce site web a été créer de cette manière et est hébergé par GitHub

1. Ajout et Commit des Fichiers :
   • Dans votre projet local, initialisez un dépôt Git avec la commande git init si ce n’est pas déjà fait.
   • Ajoutez tous vos fichiers au suivi avec la commande git add ..
   • Validez les modifications avec la commande git commit -m "Initial commit".
2. Lier le Répertoire Local au Répertoire GitHub :
   • Copiez l’URL du dépôt GitHub que vous avez créé à l’étape 1.
   • Liez votre répertoire local à votre répertoire GitHub avec la commande :

     git remote add origin <URL_du_dépôt>
     

3. Pousser les Modifications vers GitHub :
   • Pousser vos modifications locales vers GitHub avec la commande :

     git push -u origin master
     

4. Activation de GitHub Pages :
   • Accédez aux paramètres de votre dépôt GitHub.
   • Faites défiler jusqu’à la section “GitHub Pages”.
   • Sélectionnez “master branch” comme source.
   • Cliquez sur “Save” pour enregistrer les modifications. GitHub Pages sera maintenant activé pour votre dépôt.
5. Accès à Votre Site Web :
   • Une fois GitHub Pages activé, votre site web sera accessible à l’adresse suivante : https://username.github.io/mon-projet, où username est votre nom d’utilisateur GitHub et mon-projet est le nom de votre dépôt.
6. Mise à Jour de Votre Site Web :
   • Chaque fois que vous apportez des modifications à votre site web, ajoutez, validez et poussez ces modifications vers votre dépôt GitHub comme décrit aux étapes 3 à 5.

C’est tout ! Vous avez maintenant un site web statique hébergé gratuitement sur GitHub Pages.

GitHub Student Developer Pack

Le GitHub Student Developer Pack est un programme proposé par GitHub qui offre gratuitement (jsuis chokbar de la gratuité carrément) un ensemble d’outils et de ressources aux étudiants pour les aider dans leur développement de logiciels. Voici quelques informations importantes à savoir à propos du Student Developer Pack :

1. Eligibilité :
   • Le Student Developer Pack est disponible pour les étudiants âgés d’au moins 13 ans qui sont inscrits dans un établissement d’enseignement primaire, secondaire, supérieur ou professionnel agréé.
2. Avantages :
   • Le Pack comprend une variété d’outils et de services gratuits, y compris des outils de développement, des crédits cloud, des services de collaboration, des cours en ligne et bien plus encore.
   • Parmi les avantages, on trouve des crédits AWS, des abonnements gratuits à des services tels que Canva, Namecheap (noms de domaines), Microsoft Azure, et bien d’autres encore.
3. Demande :
   • Les étudiants éligibles peuvent demander le Student Developer Pack en se connectant à GitHub et en remplissant le formulaire de demande sur la page dédiée au programme.
   • Une fois la demande soumise, elle est généralement traitée dans les quelques jours suivant la vérification de l’éligibilité de l’étudiant.
4. Renouvellement :
   • Le Student Developer Pack est valide pendant une période limitée, généralement d’un an. Cependant, les étudiants peuvent renouveler leur adhésion une fois par an tant qu’ils restent éligibles en tant qu’étudiants.
5. Utilisation Responsable :
   • Il est important de noter que les ressources et les crédits offerts dans le cadre du Student Developer Pack doivent être utilisés de manière responsable et conforme aux conditions d’utilisation de chaque service.

Le GitHub Student Developer Pack est une excellente opportunité pour les étudiants d’accéder à des outils et des ressources de qualité professionnelle pour développer leurs compétences et leurs projets. Il offre une valeur significative aux étudiants qui cherchent à se lancer dans le développement de logiciels tout en étant encore à l’école.

cliquer ici pour le découvrir GitHub Student Developer Pack