intéressant

Comment diable puis-je utiliser GitHub?

Cher Goldavelez.com,

J'ai appris à coder et je veux commencer à utiliser GitHub pour gérer mes projets. Malgré la leçon d'introduction qu'ils fournissent, je ne comprends toujours pas comment cela fonctionne. Pouvez-vous m'aider?

Cordialement,

Aide Git

Cher GH,

GitHub est un excellent outil, mais c'est certainement un peu déroutant la première fois (et éventuellement plusieurs fois par la suite). C'est probablement pourquoi GitHub a créé un logiciel (pour OS X et Windows) afin de simplifier un peu le processus. Néanmoins, il est bon d'apprendre à l'ancienne, sinon vos options dans le logiciel simplifié n'auront aucun sens. Commençons par les bases.

Première étape: inscrivez-vous à GitHub

Voici la partie la plus facile: créez-vous un compte GitHub en vous inscrivant sur la première page. Après avoir rempli le formulaire, GitHub vous connectera et vous amènera à votre fil de nouvelles vide. Au milieu de la page, vous verrez le camp d'entraînement (illustré à droite). Nous allons le parcourir pour configurer votre compte et, plus tard, créer votre premier référentiel. Cliquez sur "Configurer Git" pour commencer.

Deuxième étape: installer Git

GitHub existe à cause d'une application de contrôle de version appelée git . Le site est basé sur la façon dont git fonctionne, et git est plutôt vieux. Il s'exécute via la ligne de commande et ne possède aucune interface utilisateur graphique sophistiquée. Comme il est conçu pour gérer le code écrit, cela ne devrait pas sembler trop effrayant. (Bien entendu, comme mentionné précédemment, GitHub a conçu un logiciel formidable pour vous permettre d'utiliser leur service sans ligne de commande, mais cela ne vous aidera pas beaucoup à moins de connaître les bases.)

Git fonctionne en lisant un référentiel de code local (juste un dossier contenant du code pour votre projet) sur votre ordinateur et en reflétant ce code ailleurs (dans ce cas, les serveurs de GitHub). Initialement, nous allons valider (c'est-à-dire envoyer) l'intégralité de votre référentiel local vers GitHub, mais ce n'est qu'une affaire ponctuelle. Au fur et à mesure que vous continuez à travailler sur votre code, vous allez simplement valider les modifications. GitHub gardera ensuite une trace des modifications que vous avez apportées, en créant différentes versions de fichiers afin que vous puissiez revenir aux anciennes si vous le souhaitez (ou tout simplement en garder la trace pour d'autres raisons). C’est principalement la raison pour laquelle vous voudriez utiliser un système de contrôle de version tel que git, mais des avantages supplémentaires apparaissent lorsque vous utilisez git pour gérer le code avec d’autres personnes travaillant sur votre projet. Lorsque plusieurs développeurs engagent du code avec git, GitHub devient un référentiel central dans lequel tout le code sur lequel tout le monde travaille peut rester synchronisé. Vous allez valider vos modifications et les autres développeurs les extraire (c.-à-d. Les synchroniser avec leur référentiel local). Vous ferez la même chose avec leur code.

Git rend tout cela possible, vous devez donc télécharger la dernière version et l'installer. Sur OS X, vous venez d'installer l'application en ligne de commande. Sous Windows, vous aurez encore quelques éléments. Nous discuterons de la façon dont ils travaillent à la prochaine étape.

Troisième étape: Configurer Git

Pour configurer git, vous devez vous rendre dans la ligne de commande. Sous OS X, cela signifie le lancement de l'application Terminal (Disque dur -> Applications -> Utilitaires -> Terminal) et sous Windows, le lancement de l'application Git Bash que vous venez d'installer - l'invite de commande Windows. Lorsque vous êtes prêt, dites votre nom à git comme ceci:

git config --global user.name "Your Name Here"

Par exemple, le mien ressemblerait à ceci parce que j'utilise un compte de test pour cet exemple:

git config --global user.name "Adam Dachis"

Vous pouvez indiquer n'importe quel nom, mais vous devrez ensuite saisir votre email. Cet email sera celui que vous avez utilisé lors de votre inscription à GitHub:

git config --global user.email " "

Si, pour une raison quelconque, vous vous êtes inscrit à GitHub avec une adresse e-mail incorrecte, vous devrez la changer.

Maintenant, pour éviter de toujours entrer vos informations d'identification de connexion et de générer des clés SSH, vous devrez installer l'assistant d'informations d'identification de sorte que vos mots de passe soient mis en cache. Si vous utilisez Windows, téléchargez-le et installez-le. Si vous utilisez OS X, vous devrez gérer cela via le terminal. Pour commencer, utilisez cette commande pour télécharger l'assistant d'identification:

curl -s -O \

//github-media-downloads.s3.amazonaws.com/osx/git-credential-osxkeychain

Cela téléchargera un tout petit fichier et ne devrait pas prendre trop de temps. Lorsque vous avez terminé, entrez la commande suivante pour vous assurer que les autorisations sont correctes sur le fichier que vous venez de télécharger (et corrigez-les sinon):

chmod u+x git-credential-osxkeychain

Il est maintenant temps d'installer l'assistant d'identification dans le même dossier que celui dans lequel vous installez git. Pour ce faire, entrez cette commande:

sudo mv git-credential-osxkeychain `dirname \`which git\``

Vous serez invité à entrer votre mot de passe administrateur car la commande ci-dessus a commencé par sudo. Sudo est un raccourci pour "super utilisateur" et est nécessaire pour effectuer une tâche nécessitant un accès root. La commande sudo vous permet de devenir l'utilisateur root (un utilisateur autorisé à faire à peu près n'importe quoi) sur votre système d'exploitation pendant un moment afin que vous puissiez effectuer cette tâche. Vous êtes invité à entrer votre mot de passe pour prouver que vous êtes un administrateur sur l'ordinateur et que vous devriez être autorisé à le faire. Une fois que vous avez entré votre mot de passe et que l'assistant d'identification a été déplacé, terminez l'installation avec cette commande:

git config --global credential.helper osxkeychain

Maintenant, vous êtes prêt et pouvez maintenant utiliser git et GitHub!

Quatrième étape: créer votre premier référentiel

Maintenant que vous en êtes arrivé là, vous pouvez utiliser GitHub! En tant que premier ordre du jour, nous allons créer un référentiel (ou "repo"). Rendez-vous sur GitHub et cliquez sur le bouton "Nouveau référentiel" en haut à droite de la page de votre compte. (Remarque: si vous affichez toujours la section bootcamp de GitHub, elle apparaîtra en dessous.)

Lors de la création d'un référentiel, vous devez décider de quelques éléments, notamment de son nom et de son accès public ou non. Choisir un nom devrait être assez simple car vous avez probablement déjà un nom pour votre projet. Si vous ne faites que suivre à des fins d'apprentissage, utilisez "Hello-World". Pourquoi "Hello-World" et pas "Hello World"? Parce que les espaces et les caractères spéciaux vont causer des problèmes. Restez simple et facile à taper dans la ligne de commande. Si vous souhaitez inclure un nom plus complexe, vous pouvez l'ajouter au champ de description facultatif situé sous le champ de nom.

Si vous créez un projet open-source, vous souhaitez un référentiel public. Si vous voulez coder vous-même ou partager uniquement avec des personnes spécifiques, un référentiel privé fera l'affaire. Faites le choix qui vous convient le mieux, à vous et à votre projet.

Lorsque vous avez terminé, vous pouvez cliquer sur le bouton "Créer un référentiel", mais vous souhaitez peut-être autre chose: cochez la case "Initialiser ce référentiel avec un fichier LISEZMOI". Pourquoi? Tous les référentiels nécessitent un fichier README. Idéalement, ce fichier devrait contenir quelques informations sur votre projet, mais vous ne voudrez peut-être pas en traiter pour le moment. En initialisant le référentiel avec un fichier README, vous obtiendrez un fichier README vide que vous pourrez traiter ultérieurement. Pour les besoins de ce didacticiel, nous allons laisser la zone car, dans la section suivante, nous allons créer un fichier README de toutes pièces pour s’entraîner à le commettre (l’envoyer) à GitHub.

Cinquième étape: Faites votre premier engagement

Lorsque vous envoyez des fichiers à GitHub, vous les utilisez. Pour vous exercer, nous allons initialiser votre référentiel local et créer un fichier README à valider en tant que pratique. Avant de commencer, vous devez savoir où se trouve votre référentiel de code local sur votre ordinateur et comment y accéder via la ligne de commande. Dans ce tutoriel, nous allons supposer qu'il existe un répertoire appelé "Hello-World" dans le dossier personnel de votre ordinateur. Si vous devez en créer un, exécutez simplement cette commande (identique pour Git Bash sous Windows et le terminal OS X):

mkdir ~/Hello-World

Passez maintenant à ce répertoire en utilisant la commande cd (change directory):

cd ~/Hello-World

Au cas où vous vous le demanderiez, le ~ représente votre répertoire personnel dans Git Bash et Terminal. C'est tout simplement un raccourci pour que vous n'ayez pas à tout taper (ce qui ressemblerait davantage à / Utilisateurs / votre nom d'utilisateur /). Maintenant que votre référentiel est prêt, tapez ceci:

git init

Si vous aviez déjà un référentiel prêt à être utilisé, il vous suffirait de vous connecter à ce répertoire, puis d'exécuter la commande git init . Dans les deux cas, votre référentiel local est prêt et vous pouvez commencer à valider du code. Mais attendez, vous n'avez rien à engager! Exécutez cette commande pour créer un fichier README:

touch README

Faisons une pause une seconde et voyons ce qui vient de se passer. Accédez au dossier d'accueil de votre ordinateur et examinez le dossier Hello-World (ou le dossier que vous utilisez pour un référentiel local). Vous remarquerez un fichier README à l'intérieur, grâce à la commande que vous venez d'exécuter. Ce que vous ne verrez pas est un dossier .git, mais c'est parce qu'il est invisible. Git le cache là-dedans, mais comme vous avez exécuté la commande git init vous savez qu'elle existe. Si vous êtes sceptique, exécutez simplement la commande ls dans Git Bash / Terminal pour afficher la liste de tout ce qui se trouve dans le répertoire actuel (qui, si vous suivez, est votre référentiel local).

Alors, comment git sait-il que nous voulons valider ce fichier README que nous venons de créer? Ce n'est pas, et vous devez le dire. Cette commande fera l'affaire:

git add README

Si vous souhaitez ajouter d'autres fichiers à valider, vous utiliserez la même commande, mais vous remplacerez README par le nom d'un autre fichier. Maintenant, lancez cette commande pour la commettre:

git commit -m 'first commit'

Tandis que les autres commandes étaient assez simples, la commande commit a encore un peu plus de cours, alors décomposons-la. Lorsque vous tapez git, vous git simplement à la ligne de commande que vous souhaitez utiliser le programme git. Lorsque vous tapez commit, vous indiquez à git que vous souhaitez utiliser la commande commit. Tout ce qui suit ces deux choses compte comme des options. Le premier est ce qu'on appelle un drapeau. Un indicateur indique que vous voulez faire quelque chose de spécial plutôt que d'exécuter la commande commit. Dans ce cas, l'indicateur -m signifie "message" et ce qui suit est votre message de validation (dans l'exemple, "first commit"). Le message n'est pas absolument nécessaire (bien que vous ayez généralement besoin d'en fournir un), mais simplement une référence pour vous aider à différencier les différentes versions d'un fichier (ou de plusieurs fichiers) que vous avez validées dans votre référentiel.

Votre premier commit devrait passer en une fraction de seconde car vous n'avez encore rien téléchargé. Pour obtenir ce fichier README vide sur GitHub, vous devez le pousser avec quelques commandes. Voici le premier:

git remote add origin //github.com/yourusername/Hello-World.git

Vous devez remplacer "votre nom d'utilisateur" par - vous l'avez deviné - votre nom d'utilisateur GitHub. Pour moi, cela ressemblerait à ceci:

git remote add origin //github.com/gittest1040/Hello-World.git

Cette commande indique à git où envoyer votre référentiel Hello-World. Il ne vous reste plus qu'à l'envoyer:

git push origin master

Une fois que vous avez exécuté cette commande, tout (dans ce cas, juste votre fichier README) se rendra à GitHub. Félicitations pour votre premier engagement!

Apprendre plus

L'utilisation de GitHub nécessite plus que la création d'un fichier README, mais ces bases doivent vous permettre de mieux comprendre comment interagir avec l'application git et le service. Maintenant que vous savez comment fonctionne GitHub, vous pouvez utiliser les applications GitHub pour gérer votre code si vous préférez. Si vous voulez en savoir plus sur GitHub, il existe d'excellents tutoriels. Pour commencer, jetez un coup d'œil à la façon de créer un référentiel, ainsi que le guide GitHub de LockerGnome.

Amusez-vous à gérer votre code!

Amour,

Goldavelez.com