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 les commits, publier des balises, etc.

Créer un référentiel

Pour créer un nouveau référentiel, connectez-vous d'abord à Github ou inscrivez-vous pour un nouveau compte. Une fois connecté, cliquez sur le Créer un nouveau dans le coin supérieur droit de l'écran, suivi de la Dépôt lien 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 appuyez sur le bouton Créer un nouveau référentiel bouton. Vous serez redirigé vers une page affichant votre nouveau référentiel vierge.

instagram viewer

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 "Un fichier temporaire"> 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 représente le format markdown, et si vous ne connaissez pas Markdown, consultez notre excellente feuille de triche au format Markdown.

La feuille de triche imprimable pour les débutants et les experts

Cette feuille de triche imprimable Markdown fournit tout ce que vous devez savoir sur le formatage Markdown en un coup d'œil. Gardez-le à portée de main et ne soyez plus jamais confus.

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

git init
git remote ajouter l'origine 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" en le 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 ajouter l'origine 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 "Mon premier commit"
git push -u origin master

Vous serez invité à entrer votre nom d'utilisateur et votre mot de passe Github, et une fois la saisie 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 volumineux. Dans votre favori éditeur de texte, 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 = / chemin / vers / 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 sur 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 ce qui précède git ajouter commande, nous utilisons la git rm commander. 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 "Suppression du fichier temporaire"
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 souhaiterez 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 se fait 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. 

balise git 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 désormais 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. 

clone git 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 de Github dans le répertoire / myrepo /, puis le réinitialisera avec le git init commander. À 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, tel que: 

git log - 3

La commande ci-dessus affichera les trois derniers commits effectués dans le référentiel. Cela peut être utile si vous avez besoin de modifier ou de 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, exécutez la commande dans le terminal. 

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 du Oui et Entrer clés.

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éé un référentiel avec succès 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 Commandes git avancées placer.

E-mail
Comment héberger un site Web gratuitement à l'aide de pages GitHub

Si vous avez un site Web simple, vous n'avez pas besoin de payer pour l'hébergement Web. Vous pouvez utiliser les pages GitHub gratuitement!

Rubriques connexes
  • Programmation
  • GitHub
A propos de l'auteur
Matt Dizak (13 articles publiés)Plus de Matt Dizak

Abonnez-vous à notre newsletter

Rejoignez notre newsletter pour des conseils techniques, des critiques, des ebooks gratuits et des offres exclusives!

Un pas de plus…!

Veuillez confirmer votre adresse e-mail dans l'e-mail que nous venons de vous envoyer.

.