alainericgauthier.com

construire une présence sur le web

Utilisez votre terminal pour développer un projet sur github et avoir l'air d'un hacker

  By Andersson18824 (Own work) [CC BY-SA 4.0 (http://creativecommons.org/licenses/by-sa/4.0)], via Wikimedia Commons

github, c'est quoi?

C'est un site web ou vous pouvez entreposer votre projet open source. Cela n'a pas besoin d'être un programme. Ça pourrait être une simple page web ou même un livre.

L'avantage d'utiliser github c'est que vous utiliserez un outil pour faire du contrôle de version. Chaque fois que vous le voulez, vous créer une photographie de l'état actuel de votre projet et vous pouvez ensuite revenir en arrière si vous faites une erreur ou si vous changez d'idée.

La première étape consiste donc à vous ouvrir un compte sur github pour créer un "repo" (du mot anglais repository).

Assurez-vous que la logiciel git est installé sur votre ordinateur. Si ce n'est pas le cas, vous avez les ressources ici.

Les commandes

Ouvrez votre terminal

  • Sur Mac, vous allez and Applications -> Utilitaires -> Terminal.
  • Sous Windows, vous tapez cmd dans le champ de recherche du menu Démarrer.

cd

Cette commande vous permet de changer de dossier (de l'anglais Change Directory). Par exemple, si vous voulez entrer dans le dossier test, tapez la commande :

cd test

Si vous voulez remonter d'un niveau dans la hiérarchie, tapez la commande :

cd ../

ls (dir sous Windows)

Avec cette commande vous pouvez afficher le contenu d'un dossier sous forme de liste. Pour afficher le contenu du dossier dans lequel vous vous trouvez, tapez :

ls

Et si vous voulez afficher le contenu d'un dossier sans vous déplacer tapez ls suivi du nom du dossier et /. Par exemple, si vous êtes dans votre dossier d'utilisateur et que vous voulez voir le contenu du dossier documents :

ls Documents/

La ligne de commande pour git

Une fois que git est installé, vous pouvez l'utiliser dans le terminal.  Lorsque vous créez un projet sur github, vous verrez un bouton "Clone or download". Lorsque vous cliquez dessus, vous avez accès à une url.

Copiez là.

Cloner le repo

Vous ne ferez cette étape qu'une seule fois. Cloner un repo vous permet de créer une copie exacte sur votre ordinateur du dossier qui se trouve sur github.

git clone [adresse_github]

Par exemple, pour télécharger le projet HTML5 boilerplate, la commande sera la suivante :

git clone https://github.com/h5bp/html5-boilerplate.git

Dès que vous avez accès à votre nouveau repo, vous pouvez commencer à créer ou modifier des fichiers. À un certains moments, vous sauvegarderez vos changements et vous voudrez probablement les ramener sur github.

Avant de transférer vos changements, vous devrez les sauvegarder dans git sur votre ordinateur.

git status

Cette commande vous permet de voir l'état des changements que vous avez faits. Par exemple, si vous avez créé un nouveau fichier, la commande vous indiquera que celui-ci fait partie des fichiers "untracked". Ce qui veut dire que git n'inclue pas encore ces fichiers dans son archive. Pour l'ajouter, vous utiliserez la commande git add ainsi que le nom du fichier.

Les fichiers "tracked" qui ont été modifiés apparaîtront sous "Changes to be committed:". Les fichiers qui sont listés dans cette partie pourront être sauvegardés dans git via la commande git commit.

git add

C'est ici que vous ajoutez les nouveaux fichiers que vous voulez sauvegarder et suivre avec git. Par exemple, si votre projet contient un fichier test.txt, vous pourrez le sauvegarder avec git en faisant:

git add test.txt

Mais vos changements ne seront pas encore sauvegardés.

git commit

Pour sauvegarder vos changements dans git, vous devez utiliser la commande git commit. Pour rendre le suivi de votre historique plus clair, il est important d'ajouter un message à chacun de vos commit.

Pour ce faire vous devez utiliser le "flag" -m.

La commande aura l'air de ceci:

git commit -m "Ajout du fichier test.txt"

Il est très important de mettre votre message entre guillemets.

Mais ce n'est pas tout. Vos changements et vos fichiers sont maintenant sauvegardés avec git sur votre ordinateur mais ils ne sont toujours pas sur github. Pour les y envoyer, git vous offre une commande.

git push

Avec cette commande, vous pourrez transférer vos fichiers vers github. Il n'y a rien à ajouter. Tapez simplement la commande:

git push

Une fois que l'exécution de la commande est terminée, vous pouvez allez voir votre repo sur github pour voir que le nouveau fichier s'y trouve.

git pull

Finalement, si vous travaillez à plusieurs sur un projet (et c'est un des avantages de git), lorsque vous ferez votre prochaine session de travail, vous commencez par faire git pull. Tous les changements qui auront été faits par d'autres collaborateurs depuis que vous avez fait votre dernier git push seront importés sur votre ordinateur.

Vous pourriez faire git clone et recommencer à neuf mais lorsque le projet comportera plusieurs milliers de fichiers, le temps de transfert sera très long. Avec git pull, seulement les changements que vous avez fait depuis votre dernier push seront ré-importés. Ce qui beaucoup plus efficace.

Pour en connaître un peu plus sur les commandes git elles-mêmes, voyez ma série sur git [http://alainericgauthier.com/git/aide_memoire_git

Ajouter un commentaire

Plain text

  • Les lignes et les paragraphes vont à la ligne automatiquement.
Actualiser Type the characters you see in this picture. Type the characters you see in the picture; if you can't read them, submit the form and a new image will be generated. Not case sensitive.  Switch to audio verification.