GitHub est une plateforme développée par l’entreprise de développement logiciels et de service GitHub. Elle permet l’hébergement et la gestion de développement de logiciels en se basant sur le logiciel de gestion de développement Git. Nous allons voir dans ce tutoriel comment mettre en ligne en quelques étapes simples un projet sur GitHub.

(Source de l'image)

« Wow ! Mais c’est génial ça ! Ça veut dire que je vais pouvoir mettre mes codes en ligne, les organiser comme je veux, les partager à mes amis, faire comme un pro ! »

Mais oui Billy, tu vas pouvoir faire tout ça. Mais d’abord, tu vas apprendre à mettre ton projet en ligne, Billy, il faut commencer doucement pour bien apprendre et comprendre ! Patience Billy… Patience…

1) Créer un compte sur GitHub

Tout d’abord, rendez vous sur le site https://github.com/ et créez un compte. Pour ce faire, remplissez le champ suivant sur la page de connexion ou cliquez, en haut à droite, sur « Sign Up » :

Remplissez tous les champs, vérifiez votre adresse e-mail et ça y est, vous avez un compte ! Facile, non ?

« Mmmmh… Mouais… Mais bon, créer un compte, ça va, je savais faire… »

Très bien Billy, mais n’oublie pas que tout le monde n’est pas toi. Peut-être qu’il y a ici des personnes qui ne savent pas se créer des comptes ou qui apprennent la différence entre Sign In (se connecter) et Sign Up (s’inscrire).

2) Installer Git sur sa machine

Installer Git sur sa machine est plutôt simple. Il suffit de suivre ce qui est écrit sur cette page, en fonction de votre système d’exploitation.

À la suite de l’installation de Git, il vous suffit d’ouvrir votre console (ou votre invite de commandes, ou votre terminal ou le Git Bash, selon votre système d’exploitation) et d’écrire les deux lignes de commande suivantes :

git config --global user.name "Votre nom ou pseudo"
git config --global user.email "Votre@email.com"

Pour vérifier que tout a bien fonctionné, il vous suffit de rouvrir la console et de taper :

git

Si tout fonctionne bien vous devriez voir apparaître un message comme celui-là, détaillant les fonctions de Git :

N’hésitez pas à abuser de cette commande si jamais vous avez un trou de mémoire.

Vous pouvez maintenant vérifier la version de Git installée sur votre machine en tapant :

git –version

comme le montre la première ligne du message précédent. La version de Git que vous utilisez actuellement devrait apparaître de la façon suivante en réponse à votre commande :

« Wow ! Il y a tellement de possibilités avec Git ! Mais je ne comprends rien… Je ne parle pas anglais moi… »

Eh bien c’est dommage, ça, Billy… Mais bon, rien ne t’empêche d’utiliser un traducteur si tu ne comprends rien à la langue de Shakespeare… D’ailleurs, j’en ai un très bon à te recommander, il s’appelle DeepL et fonctionne sur le principe du Deep Learning pour ses traductions. Tu pourras le trouver à l’adresse suivante : https://www.deepl.com/fr/translator

3) Créer le projet sur votre GitHub

Quand vous transférez un projet de votre ordinateur à GitHub, il faut pouvoir le stocker. Pour ce faire, il va vous falloir créer le dossier du projet sur GitHub. Connectez-vous de nouveau à votre compte GitHub et créez un dossier (repository en anglais, souvent appelé repo) en cliquant sur New :

Sur la capture d’écran précédente, je vous ai encadré trois parties importantes de GitHub. En rouge, c’est là où se trouvent tous vos repos, en jaune, c’est le bouton New dont je vous parlais précédemment et en bleu, c’est l’endroit où se trouvent vos équipes de travail.

Lorsque vous cliquez sur New, la fenêtre suivante apparaît :

Dans Owner, vous pouvez choisir qui est le propriétaire de votre nouveau repo, si c’est vous ou une équipe de travail. Le Repository name est le nom que vous allez donner à votre repo. Il doit être plutôt court et facile de s’en souvenir. La Description permet en un ligne de savoir quel est votre projet. Vous pouvez choisir qui peut voir votre repo en cochant soit Public (tout le monde peut le voir, mais tout le monde ne peut pas le modifier, vous choisissez qui le peut plus tard, en donnant des droits) soit Privé (seules les personnes que vous autorisez peuvent voir ou modifier votre projet. Cette possibilité n’est disponible pour tous que depuis Janvier 2019. Auparavant il fallait payer pour avoir accès aux repos privés). Ne cochez pas la case suivante et créez votre repo.

« Mais… Moi, je voulais le créer lors de la création de mon repo, le README… »

Non, Billy, le README.md, tu l'ajouteras après, avec le dossier du projet. D’ailleurs, tu parles du README comme ça, comme si tout le monde savait ce que c'était… Le README (Lisez-moi, en français), c'est le document au format Markdown (.md) qui explique tout ce qu'il y a à savoir sur le projet. Pour écrire au format Markdown, un très bon tutoriel ici et si tu veux apprendre à faire de beaux README, tu trouveras un template complet en anglais ici.

4) Envoyer le projet sur GitHub

Si vous ne vous êtes jamais servi de votre console pour naviguer sur votre ordinateur, voilà quelques commandes indispensables :

cd

permet de naviguer entre les dossiers ;

cd ..

permet de remonter à la racine du dossier actuel :

cd nomdudossier

permet de naviguer jusque dans le dossier spécifié. Ici, l’autocomplétion est très utile. En effet, il vous suffit de taper les premières lettres du nom du dossier, d’appuyer sur la touche tabulation, le nom du dossier se complète seul et il vous suffit d’appuyer sur la touche entrée. Si le nom du dossier auquel vous voulez accéder contient des espaces, vous devrez écrire le nom avec des guillemets, c’est pourquoi on recommande toujours de donner des noms sans espace, ou les mots sont séparés par des – ou des _.

dir

affiche la liste du contenu dans le dossier actuel ainsi que ses spécificités :

mkdir nomdudossier

permet de créer un nouveau dossier nommé nomdudossier.

Pour changer de disque, il vous suffit d’écrire

Lettredudisque:

Naviguez donc jusqu’au répertoire de votre projet. Quand vous y êtes, tapez les commandes suivantes :

git init

pour créer un nouveau repo Git vide ou en réinitialiser un existant sur votre machine à l'emplacement du dossier ;

git add

pour ajouter les fichiers du dossier à l’index du repo ;

git commit -m "nomducommit"

pour effectuer tous les changements (ici le transfert des fichiers dans le repo vide) ;

Retournez ensuite sur la page de votre projet sur GitHub et copiez l’URL de votre repo, qui se trouve ici :

Retournez dans votre console et tapez la commande

git remote add origin liendevotrerepo

afin de créer un lien entre votre repo local et le repo en ligne. Si vous n’êtes pas connectés à GitHub depuis votre console, vos informations de connexion vous seront demandées, complétez-les sans crainte.

Ensuite, il ne vous reste plus qu’à vérifier que le lien est bien établi entre votre machine et le repo en ligne avec la commande :

git remote -v

Et enfin à pusher votre projet, c’est-à-dire, le mettre en ligne, avec la commande :

git push origin master

Et voilà, votre projet est en ligne, vous pouvez vérifier en actualisant la page GitHub !

Vous pouvez ensuite passer votre repo en public ou en privé en allant dans Settings -> Manage access. Vous pouvez aussi depuis cette page ajouter des collaborateurs. N’oubliez pas de leur envoyer le lien de votre repo si vous voulez qu’ils le trouvent facilement !

« Mais c’est génial ça ! J’ai enfin fait mon premier push sur GitHub ! J’y crois pas, c’est trop cool ! Je vais pouvoir le partager à tous mes copains ! Ils vont être verts en voyant que j’ai réussi à faire ça ! »

Eh oui, Billy, tu as réussi ! Néanmoins, tant que tu utilises un compte gratuit, tu ne pourras ajouter que 3 collaborateurs à tes repos GitHub privés. Donc si ton projet doit rester secret pour une raison ou pour une autre, pense à bien choisir tes collaborateurs !

5) Afficher les changements qui ont eu lieu

Pour afficher les changements (logs) qui ont eu lieu dans un repo, plusieurs moyens sont possibles depuis la console, en voici quelques uns :

git log

qui affiche toute la liste des logs ;

git log --pretty=oneline

qui affiche tous les changements sur une seule ligne ;

git log --graph --oneline --decorate --all

qui affiche les changements dans un arbre.

« Et tu vas me dire que tu as fait ce tuto comme ça, à partir de rien, peut-être ? »

Bien sûr que non, Billy, tu peux retrouver mes sources ici, là, ou encore sur cette page ou en cliquant sur ce lien !