Partagez votre projet sur GitHub

Créations

chris-scientist

il y a 5 ans

INTRODUCTION

Ce tutoriel a pour objectif d'expliquer comment partager son projet sur GitHub. Evidement il existe d'autres plateformes pour partager un projet, pour n'en citez qu'une on peut évoquer GitLab, mais ce tutoriel explique comment partager via GitHub.

Pré-requis :
Être sous Windows (1)

[1] J'expliquerai ultérieurement comment faire sur Linux, mais sachez que seul le client diffère. Pour les produits Apple je ne pourrai pas vous guider car je n'en ai pas sous la main - pensez à moi pour Noël...

CRÉATION DU REPOSITORY

Le repository ? Il s'agit d'un répertoire avec des méta-données qui vous permet de faire le lien entre votre ordinateur et GitHub. En français, on parle de dépôt.

Nous allons voir ici comment créer un repository sur GitHub.

1. Rendez-vous sur votre compte GitHub (après authentification)

2. Allez dans (1) Repositories, puis (2) New (comme le montre la capture ci-dessous)

3. Sur la page suivante complétez les informations suivantes (comme le montre la capture ci-dessous) :

  • (1) Donnez un nom à votre repository.
  • (2) Ajoutez une brève description (facultatif).
  • (3) Choisissez la visibilité de votre repository : public est la meilleure option si vous souhaitez partager votre projet avec le monde entier.
  • (4) Choisissez la licence de votre projet : ici GPL v3.0 (plus de détails un peu plus loin).
  • (5) Enfin, validez la création du repository.

Quelle licence choisir ?
Je ne vais pas vous présenter l'ensemble des licences car il en existe de nombreuse.

Sachez simplement que la GPL v3.0 :

  • Autorise une utilisation commerciale de votre projet.
  • Autorise les modification de votre projet (en dehors de votre repository).
  • Autorise la distribution de votre projet.
  • Etc.

GESTION DES SOURCES

Pour parler avec les serveurs GitHub : récupérer votre repository en local, envoyer vos fichiers sur GitHub, etc ; nous avons besoin pour cela d'un client Git. Il en existe une multitude et j'ai fais le choix d'utiliser git bash (je parle ici d'un client Windows), vous pouvez télécharger git bash en suivant le lien et l'installer.

Récupérer le repository

Dans un premier temps, il vous faut récupérer votre repository sur votre machine, cette étape est à faire une fois à l'initialisation de votre projet.

Dans ce but copiez l'adresse du repository en suivant les étapes indiquées sur la capture ci-dessous :


Dans votre explorateur de fichiers ouvrez git bash via un clic droit (comme le montre la capture ci-dessous) :


Enfin récupérer votre repository en écrivant git clone adresse-du-repository :


Envoyez vos fichiers et répertoires sur GitHub

Dans un second temps, voyons comment envoyer ses fichiers et ses répertoires sur GitHub, cette étape est a répété autant de fois que nécessaire. Exemple d'application : 

  • Vous créer la v1.0 de votre projet.
  • Envoyez la sur GitHub, ceci en suivant cette étape.
  • Vous apportez une modification à votre projet qui est alors en v1.1.
  • Envoyez la v1.1 sur GitHub, ceci en suivant cette étape.

Dans le répertoire que vous venez de récupérer, ajoutez votre projet autrement dit ajoutez votre contenu, ici : j'ai un répertoire nommé Tutoriels et un fichier README.MD.

Retournez dans git bash, déplacez vous dans le repository via cd nom-du-repository (cd signifie "change directory" autrement dit "changer de répertoire") :


Pour envoyer vos fichiers/répertoires sur GitHub il faut suivre plusieurs étapes :

  • git status : permet de visualiser quel est l'état du repository.
  • git add fichiers repertoires : permet d'indiquer que ces fichiers/répertoires doivent être ajouter au repository.
  • git commit -m "Un commentaire" : permet de valider le ou les git add effectué avant.
  • git push : permet d'envoyer vos commits en attentes sur GitHub (demande votre login dans la console puis votre mot de passe dans une fenêtre, voir captures).

Vous pouvez faire un git status après chacune des étapes.


Voici à quoi ressemble la fenêtre demandant votre mot de passe :

Petite astuce : si vous voulez ajouter tous les fichiers en attente vous pouvez tapez git add ..


Revenons sur le fichier README.MD

Il s'agit d'un fichier qu'il est conseillé d'ajouter, en effet ce fichier est sensé décrire votre projet. La syntaxe de ce fichier est en MarkDown.


CONCLUSION

Vous avez désormais le kit de survie pour partager vos projets sur GitHub via git bash (pour Windows).

Voir la création

jicehel

NEW il y a 5 ans

Très clair et ça devrait être ajouté dans les tutos officiels soit définitivement, soit en attendant qu'il y en est un qui soit fait sur le sujet. On voit bien que tout le monde n'est pas à l'aise naturellement sinon sur github même si maintenant avec les créations, on peut aussi tout héberger facilement dedans.

chris-scientist

il y a 5 ans

Merci, et oui ça pourrait être ajouter à l'académie. J'ai fais ce tutoriel suite à une discussion sur discord.

chris-scientist

NEW il y a 5 ans

jicehel jicehel

Merci, et oui ça pourrait être ajouter à l'académie. J'ai fais ce tutoriel suite à une discussion sur discord.

Steph

NEW il y a 5 ans

Merci pour ce tuto chris. Je suis tombé par hasard sur une petite vidéo très pédagogique sur le sujet, qui viendra parfaitement compléter ton tuto pour mettre le pied à l'étrier de ceux qui n'ont pas encore eu le plaisir de travailler avec git et GitHub. Cette vidéo met l'accent sur la trousse à outils minimale nécessaire pour le bon usage de git. Je l'ai trouvée particulièrement pertinente :

Une petite remarque néanmoins, sachez que git est installé par défaut sur les systèmes macOS et Linux ;-)

chris-scientist

il y a 5 ans

Merci @steph pour cette très bonne vidéo ! Ca me fait penser que j'avais envisagé de rédiger d'autre partie à ce tutoriel, notamment sur des notions avancées comme les branches et les tags.

megaman_6

NEW il y a 5 ans

What is this? A Github tutorial?

Sorry, I don't understand French.

Steph

il y a 5 ans

Hello megaman_6,

Yes, it is indeed a tutorial on GitHub. Unfortunately, it is not (yet) possible to translate a comment into both English and French on the site... we hope it will come soon. In any case, if you are looking to learn about git and GitHub, and while waiting for chris-scientist to translate his tutorial into English, I suggest you follow this goood tutorial, written in English, which basically provides the minimum content to get started:

An Intro to Git and GitHub for Beginners

And then, you can easily consult the guides provided by GitHub on the following page:

GitHub Guides

I hope it will help you.

sylvain

NEW il y a 5 ans

Yeah, and a very good one. We'll think about translate it and highlight it in the academy (with other community tutorials), thanks for your work Chris :)

chris-scientist

il y a 5 ans

Thanks for your answer ! I'll try to translate it into English asap.

chris-scientist

NEW il y a 5 ans

sylvain sylvain

Thanks for your answer ! I'll try to translate it into English asap.

chris-scientist

NEW il y a 5 ans

Steph Steph

Merci @steph pour cette très bonne vidéo ! Ca me fait penser que j'avais envisagé de rédiger d'autre partie à ce tutoriel, notamment sur des notions avancées comme les branches et les tags.

Steph

NEW il y a 5 ans

megaman_6 megaman_6

Hello megaman_6,

Yes, it is indeed a tutorial on GitHub. Unfortunately, it is not (yet) possible to translate a comment into both English and French on the site... we hope it will come soon. In any case, if you are looking to learn about git and GitHub, and while waiting for chris-scientist to translate his tutorial into English, I suggest you follow this goood tutorial, written in English, which basically provides the minimum content to get started:

An Intro to Git and GitHub for Beginners

And then, you can easily consult the guides provided by GitHub on the following page:

GitHub Guides

I hope it will help you.

chris-scientist

NEW il y a 5 ans

The english translation is now avialable for this tutorial !