Wi-bash-noobs

Tutorials for newcommers in the "Wi-bash" association

View project on GitHub

Tutoriel Github et Gitkraken

Prérequis :

Premiers pas sur Github :

Vous venez de créer votre compte github. Vous voulez maintenant créer votre premier projet, n’est-ce pas ? Pour cela, il vous suffit de suivre les étapes suivantes:

  • Cliquez sur votre image de profil en haut a droite, dans la bande noire. vous devriez voir apparaître “Your repositories”: souvenez vous-en: c’est ici que vous pourrez accéder a chacun de vos différents projets.

  • Cliquez sur “New” pour créer votre nouveau projet;

  • Dans le champ “Repository name” rentrez… Oui ! le nom de votre projet !

  • n’oubliez pas de cocher la case “Initialize this repository with a README” avant de cliquer sur “Create repository”

  • BRAVO ! Vous avez créé votre premier projet. Maintenant, vous avez sûrement envie d’y ajouter du contenu.

Gitkraken

  • Vous devriez maintenant être dans l’onglet ”<>Code” de votre projet sur Github. cliquez alors sur le bouton vert “Clone or Download”; puis copiez le lien qui apparait. Il vous permettra par la suite d’accéder a votre projet Github depuis Gitkraken.

  • Dans Gitkraken, cliquez maintenant sur “File” en haut a gauche, puis “Clone repo”;

  • Dans le premier champ, selectionnez le repertoire dans lequel vous placerez vos projets en cliquant sur “Browse”; je vous conseille personnellement d’en créer un nouveau a un endroit pas trop perdu sur votre disque dur, du style “Projets”, afin de reunir tous vos projets Github dedans.

  • Dans le deuxieme champ, collez le lien que vous avez copié sur Github

  • cliquez enfin sur le bouton “Clone the repo!”

  • Bravo ! vous etes maintenant sur votre projet.

atom

  • Ouvrez maintenant Atom !

  • Cliquez Sur “Open a project” dans l’onglet du même nom. Sélectionnez ensuite le dossier du nom de votre projet dans le répertoire que vous avez créé plus haut.

  • Et voila, derniere étape: cliquez sur le “README.md”; a partir de maintenant, c’est a vous de jouer. N’oubliez pas, c’est en markdown que l’on rédige ! mais pas d’inquiétudes, c’est un langage très simple.

Retour sur Gitkraken

  • vous avez terminé vos changements ? N’oubliez pas de sauvegarder sur Atom. (le raccourci CTRL+S est votre ami) Vous pouvez retourner sur Gitkraken.

  • Regardez bien. quelquechose à bougé… Une ligne s’est ajoutée a votre écran. Mais a gauche, l’icone “master” n’est en face que de la première… Eh bien, cette icone indique l’état actuel de votre projet sur github. Vous avez envie de la pousser vers le haut ? ne vous précipitez pas !

  • Cliquez sur cette nouvelle ligne qui représente les changements que vous venez de sauvegarder sur Atom. Puis a droite, cliquez sur “Stage all changes”

  • dans la fenêtre “Commit message”, rentrez un nom, ou court résumé représentatif des changements que vous avez effectué. le “commit message” identifiera le changement, afin de pouvoir le reconnaitre en cas de gaffe.

  • vous commencez a comprendre ! “Commit changes to x files”

  • Wow ! un deuxieme icône “master” ! eh bien, le plus en bas représente votre projet sur le serveur; celui au dessus représente le projet sur votre machine; eh oui ! votre projet n’est pas encore “à jour” sur github !

  • Mais comment fai… “PUSH” !!! en haut, au millieu.

  • Et voila ! maintenant, on retourne sur Github.

Page github

  • Dans l’onglet “Settings”, scrollez vers le bas jusqu’à “GitHub Pages”. selectionnez un thème, puis cliquez sur le lien de votre site. ( “Your site is published at https://…“)

  • et voilà ! partagez le lien avec qui vous voulez.

Bonus

Vous en avez marre de bosser tout seul ? voici donc quelques autres fonctions !

Ajoutez un collabo !

  • Rien de plus simple ! Sur github: onglet “Settings” puis Collaborators. il ne vous reste qu’à taper le pseudonyme de votre esclave / main-d’oeuvre !

La commande Pull !

  • si votre serviteur récemment ajouté a bien travaillé, vous devriez voir sur Gitkraken ses modifications. Il vous suffit d’appuyer sur “Pull” en haut pour récupérer le travail que lui aura “Push” au préalable !

Voilà tout pour maintenant ! a vous de jouer !