Comment créer votre premier référentiel sur Github

Le site Github populaire ainsi que l'outil git constituent une excellente ressource non seulement pour distribuer et présenter votre travail, mais également pour faciliter un contrôle de version efficace et professionnel.

Dans ce didacticiel, nous allons explorer comment créer un référentiel Github, pousser des commits, des versions de balises, etc.

Créer un référentiel

Pour créer un nouveau référentiel, connectez-vous d'abord à Github ou créez un nouveau compte. Une fois connecté, cliquez sur le bouton Créer nouveau dans le coin supérieur droit de l'écran, suivi du lien Référentiel dans la liste déroulante qui apparaît.

Vous verrez l'écran de création de référentiel:

Le nom et la description du référentiel peuvent être tout ce que vous souhaitez, et pour cet exemple "muo_demo" a été utilisé comme nom. Laissez le reste des champs tels quels / vides et cliquez sur le bouton Créer un nouveau référentiel . Vous serez redirigé vers une page affichant votre nouveau référentiel vierge.

Lancer le référentiel local

Maintenant qu'un référentiel sur Github a été créé, vous devez initialiser le référentiel sur votre PC local. Exécutez les commandes suivantes dans le terminal pour créer un répertoire vide et ajoutez un fichier Readme.md.

 mkdir myrepo

 cd myrepo

 echo "# My Test Repository" > Readme.md

 echo "A temporary file" > temp.txt

Lors de la visualisation d'un référentiel sur Github, le contenu du fichier Readme.md est toujours affiché pour décrire le référentiel, ou comme première page du manuel. L'extension de fichier .md signifie format markdown, et si vous ne connaissez pas Markdown, consultez notre excellente feuille de triche au format Markdown .

Vous pouvez maintenant lancer le référentiel dans le terminal avec les commandes.

 git init

 git remote add origin https://github.com/mdizak/muo_demo.git

Dans la deuxième commande, vous devez changer le "mdizak" en votre nom d'utilisateur Github, et la partie "muo_demo" au nom de votre référentiel. Par exemple, si votre nom d'utilisateur Github est "johndoe" et le nom de votre référentiel est "test_repo", la commande serait:

 git remote add origin https://github.com/johndoe/test_repo.git

Premier engagement

Vous pouvez maintenant synchroniser les référentiels local et Github, et ajouter les deux fichiers à Github, avec les commandes suivantes dans le terminal.

 git add Readme.md temp.txt

 git commit -m "My first commit"

 git push -u origin master

Vous serez invité à entrer votre nom d'utilisateur et votre mot de passe Github, et une fois l'entrée réussie, les deux fichiers seront téléchargés dans votre référentiel Github. Si vous rechargez votre référentiel Github dans votre navigateur, vous verrez maintenant les deux fichiers ainsi que l'en-tête "My Test Repository" dans le fichier Readme.md.

Messages de validation volumineux

Au lieu de spécifier uniquement un petit message de validation d'une seule ligne, il est également possible d'inclure un message texte plus grand. Dans votre éditeur de texte préféré, entrez le contenu du message de validation, qui peut être aussi grand et autant de lignes que vous le souhaitez. Lorsque vous validez les dernières modifications, utilisez la commande.

 git commit --file=/path/to/commit.txt

Assurez-vous que la commande pointe vers le fichier texte de votre message de validation et que son contenu sera utilisé à la place du message d'une seule ligne défini via l'option -m.

Suppression de fichiers

La suppression des fichiers se fait à peu près de la même manière, sauf pour l'utilisation de la commande git add ci-dessus, nous utilisons la commande git rm . Pour supprimer le fichier temp.txt que vous avez précédemment ajouté, exécutez les commandes suivantes dans le terminal.

 git rm temp.txt

 git commit -m "Deleting temp file"

 git push -u origin master

Vous serez à nouveau invité à entrer votre nom d'utilisateur et votre mot de passe, et une fois terminé, le fichier temp.txt sera supprimé de votre référentiel Github. C'est tout ce qu'on peut en dire!

Balisage des communiqués

De temps en temps, une fois que vous êtes parfaitement satisfait de votre projet testé, vous voudrez peut-être marquer l'état actuel comme une version. Cela informe les autres que le projet dans son état est terminé et prêt à être distribué au public.

Le marquage de votre référentiel comme version est effectué en ajoutant une balise avec le numéro de version. Par exemple, pour publier notre référentiel actuel en tant que v1.0.0 dans le terminal, exécutez les commandes.

 git tag 1.0.0

 git push --tags

Après avoir entré votre nom d'utilisateur et votre mot de passe Github, rechargez la page du référentiel dans votre navigateur Web. Vous remarquerez qu'il existe maintenant une version de votre référentiel. Cliquer pour afficher toutes les versions fournira un lien vers l'archive TAR.GZ pour le référentiel complet dans l'état où la version a été étiquetée.

Référentiel de clonage

Parfois, vous devrez cloner et réinitialiser votre référentiel à partir de zéro. Cela se fait facilement avec les commandes suivantes dans le terminal.

 git clone https://github.com/mdizak/muo_demo.git myrepo

 cd myrepo

 git init

Comme lorsque nous avons initialisé le référentiel, dans la première ligne, vous devez modifier le nom d'utilisateur et le nom du référentiel Github dans l'URL.

Cela téléchargera le contenu du référentiel depuis Github dans le répertoire / myrepo /, puis le réinitialisera avec la commande git init . À partir de là, vous pouvez continuer à ajouter et à supprimer des fichiers de la même manière que ci-dessus.

Afficher l'historique des validations

Vous pouvez revenir en arrière et afficher vos commits précédents avec le journal git , tels que:

 git log - 3

La commande ci-dessus affichera les trois derniers commits effectués dans le référentiel. Cela peut s'avérer utile si vous devez modifier ou supprimer un commit pour une raison quelconque.

Modifier un message de validation

Si vous avez déjà poussé un commit sur Github, puis que vous vous êtes rendu compte plus tard que vous avez fait une erreur dans le message de commit, il existe un moyen de le modifier. Pour modifier le dernier message de validation, dans le terminal, exécutez la commande.

 git commit --amend

Cela ouvrira votre éditeur de texte par défaut avec le message de validation précédent. Apportez les modifications nécessaires et fermez l'éditeur. Si vous utilisez nano comme éditeur de texte, vous pouvez le fermer en appuyant sur Ctrl + X , suivi des touches Y et Entrée .

Une fois que vous avez enregistré le nouveau message de validation, envoyez-le sur Github avec la commande:

 git push --force origin

Prêt à montrer votre travail!

Félicitations, vous avez maintenant appris les bases de l'utilisation du site Web populaire Github avec l'outil de ligne de commande git. Vous avez créé avec succès un référentiel et pouvez désormais ajouter / supprimer des fichiers, envoyer des validations, marquer des versions et cloner des référentiels.

Si vous souhaitez en savoir plus sur les commandes git avancées, consultez le site Advanced git Commands .