Comment ajouter des captures d'écran et des animations aux demandes de tirage GitHub

Les programmeurs GitHub ajoutent souvent des captures d’écran ou des GIF animés à leurs demandes de tirage de dépôt. Ces techniques sont définitivement plus accrocheuses que de faire lire plusieurs lignes de texte brut. Ajouter des captures d’écran statiques est utile si vous souhaitez insérer des changements visuels ou des photographies en ligne. Pour démontrer les flux de processus et le mouvement du curseur de la souris, vous pouvez utiliser des vidéos MP4 et des animations GIF. Le tutoriel suivant vous montre comment ajouter des captures d’écran et des animations MP4/GIF dans les demandes de tirage GitHub.

Table des matières

• 1. Ajouter un nouveau dépôt et une branche
• 2. Créer des captures d’écran pour GitHub
• 3. Créer des vidéos et des animations GIF pour GitHub
• 4. Ajouter des captures d’écran ou des animations aux demandes de tirage GitHub
• 5. Afficher des captures d’écran et des images GIF sur une page GitHub
• Questions fréquentes

Lisez aussi : Le guide du débutant sur Git

1. Ajouter un nouveau dépôt et une branche

Même si vous n’avez jamais utilisé GitHub auparavant, vous pouvez utiliser les étapes ci-dessous pour commencer en tant que développeur. Actuellement, vous n’avez besoin que d’un e-mail pour créer un compte GitHub. Cela rend le démarrage avec GitHub beaucoup plus facile qu’auparavant.

1. Après vous être connecté à votre profil GitHub, cliquez sur le signe « + » en haut à droite pour créer un nouveau dépôt.

1. Donnez au dépôt un nom de votre choix et choisissez de le garder public ou privé. N’oubliez pas de cocher l’option « Initialiser ce dépôt avec un README ».

1. Vous pouvez choisir de publier votre code sous la forme d’une licence Apache 2.0, d’une licence publique générale GNU, d’une licence MIT, d’Eclipse, d’une licence publique Mozilla, etc. Choisissez « aucun » si vous ne souhaitez pas que d’autres utilisent librement le code.
2. Cliquez sur « Créer le dépôt » pour confirmer l’ajout de votre dépôt sous la branche principale de votre profil.

1. À l’étape suivante, ajoutez une branche à votre dépôt à l’aide du menu déroulant montré ci-dessous. Ici, la branche « Guten-tag-1 » a été ajoutée au dépôt « Guten-tag », qui est lui-même une branche du dépôt principal « Hola-World ».

1. Le but d’une branche dans GitHub est d’aider le développeur à travailler sur des fonctionnalités et des corrections de bogues séparément de la branche de production principale. Ajouter un numéro de série tel que 1, 2, 3, etc., est un moyen plus facile de mémoriser le niveau de la branche.

2. Créer des captures d’écran pour GitHub

Pour ajouter des captures d’écran dans GitHub, vous avez besoin d’un bon logiciel de capture d’écran. Dans Windows 11, l’outil de capture est une application Microsoft mieux adaptée à cet effet. Si vous rencontrez des problèmes avec, suivez notre guide de dépannage.

Windows 10, cependant, utilise une application « Snip & Sketch » qui fonctionne très similaire à l’outil de capture de Windows 11 mais avec moins de fonctions. Il dispose d’un minuteur de 3 ou 10 secondes pour le délai de capture de l’écran.

Lisez aussi : Outil de capture Windows 11 ne fonctionne pas : 12 solutions possibles

3. Créer des vidéos et des animations GIF pour GitHub

Pour ajouter des vidéos ou des GIF pour GitHub, vous avez besoin d’un bon outil de capture vidéo. Dans le passé, vous ne pouviez pas télécharger un MP4 dans GitHub, mais cela a changé.

Dans Windows 11 et Windows 10, vous pouvez utiliser une application du Microsoft Store appelée Enregistreur d’écran & Enregistrement d’écran. Le Microsoft Store est la source la plus sûre pour télécharger des logiciels d’enregistrement d’écran, car chaque application est conçue pour bien fonctionner avec Windows. Pour apprendre à enregistrer votre écran gratuitement sur un Mac, suivez ce guide.

1. Lancez l’application d’enregistrement d’écran et choisissez un mode de capture : « Complet », « Zone », « Caméra » ou « Audio uniquement ». Appuyez sur « Démarrer » lorsque vous êtes prêt à commencer l’enregistrement de votre écran.

1. Le bon côté de ce logiciel est que vous pouvez choisir de créer un GIF directement en sélectionnant le mode GIF.

1. Alternativement, vous pouvez facilement convertir un MP4 en GIF en utilisant Ezgif ou tout autre outil en ligne. Tout d’abord, ajoutez la vidéo MP4 en utilisant le lien de téléchargement.

1. Vous obtiendrez une estimation approximative de la taille du fichier GIF, de la largeur et de la longueur. Vous pouvez changer le taux de rafraîchissement de votre fichier GIF pour le rendre plus lent pour des instructions faciles.

Lisez aussi : Comment enregistrer votre écran sur un Mac gratuitement

4. Ajouter des captures d’écran ou des animations aux demandes de tirage GitHub

Une fois que vous avez créé vos captures d’écran ou vidéos, vous pouvez facilement les ajouter aux demandes de tirage GitHub.

1. Pour ajouter des captures d’écran ou des vidéos/animations à GitHub, retournez à la branche que vous avez créée plus tôt et naviguez vers « Demandes de tirage ». Alternativement, accédez-y directement en cliquant simplement sur la branche.

1. Pour ajouter un nouveau fichier, tel qu’un MP4 ou un GIF, sélectionnez « Télécharger des fichiers » dans la branche où vous souhaitez que le fichier soit disponible.

1. Une fois en mode éditeur, vous pouvez joindre l’image de capture d’écran et les fichiers MP4/GIF à partir de l’option « choisissez vos fichiers ». Si vous vous engagez pour la première fois dans le dépôt de la branche GitHub, cliquez sur « valider les modifications ». Sinon, choisissez « mettre à jour le commentaire ».

1. Attendez quelques secondes pour que le fichier de capture d’écran ou d’animation soit ajouté à votre branche de dépôt.

1. La capture d’écran/vidéo/animation créée est ajoutée avec succès à la branche GitHub, et par conséquent, au dépôt.

1. GitHub est tout au sujet de la collaboration avec d’autres développeurs. S’ils aiment vos modifications proposées, ils peuvent les fusionner en amont dans leur propre dépôt. Cela se fait automatiquement si vous pouvez voir une option « Peut être fusionné ».

1. Une fois que vous avez terminé la fusion, les vidéos/captures d’écran apparaîtront comme des « validations » dans le dépôt principal.

Lisez aussi : Comment vider le cache Git

5. Afficher des captures d’écran et des images GIF sur une page GitHub

Au lieu de télécharger des captures d’écran et des fichiers GIF séparément dans le dépôt de demande de tirage, vous pouvez également les rendre visibles sur la page GitHub.

1. L’astuce consiste à cliquer sur le fichier « ReadMe.md » visible sur n’importe quelle branche. Une fois ouvert, cliquez sur une icône appelée « Afficher le blob source ». Cette branche peut être modifiée pour afficher des images, des captures d’écran, des GIF, et plus encore.

1. En cliquant sur l’icône « modifier le fichier », vous serez dirigé vers un écran de codage où vous pouvez ajouter le code de la capture d’écran ou du GIF animé. Il est facile d’afficher une image en ajoutant ! et en entourant le texte alternatif dans [ ], puis en intégrant le lien de l’image dans des parenthèses ().

Si vous ne souhaitez pas coder, il existe un moyen plus facile d’ajouter une capture d’écran/GIF directement à la page du dépôt.

1. Cliquez sur « modifier le fichier » sur la page Readme.md, ce qui vous mènera à une nouvelle fenêtre où vous pouvez joindre la capture d’écran/GIF à afficher sur la page de la branche.

1. Avant de valider les modifications dans votre branche GitHub, vous pouvez facilement prévisualiser l’image, la capture d’écran ou le GIF.

Lisez aussi : Comment installer Git et Git Bash dans Windows

Questions fréquentes

Comment puis-je aligner ou redimensionner une image ou une capture d’écran dans GitHub ?

Pour aligner une image ou une capture d’écran sur votre page GitHub, cliquez sur « modifier ceci » dans le fichier ReadMe.md, puis téléchargez l’image ou la capture d’écran et ajoutez le code suivant :

Modifiez le code selon que vous souhaitez que l’image soit alignée à gauche, à droite ou au centre. Pour redimensionner l’image, modifiez les dimensions de largeur et de hauteur.

Y a-t-il une limite de taille pour les fichiers GIF et vidéo sur GitHub ?

Oui. La taille maximale du fichier est de 50 Mo pour les fichiers GIF ou MP4 individuels. En utilisant une fonctionnalité cachée de GitHub appelée « GitHub Blocks », vous pouvez pousser cela à 100 Mo pour chaque fichier. Les dépôts GitHub (votre branche principale) doivent rester inférieurs à 5 Go.

Si vous devez télécharger une image ou une vidéo avec une taille de fichier plus élevée, utilisez un programme GitHub appelé GitHub Large File Storage (LFS), qui a une limite maximale de 2 Go par fichier pour les utilisateurs gratuits/pro.

Comment puis-je partager des images sur GitHub ?

GitHub n’a actuellement aucune fonctionnalité pour partager directement des images en utilisant des outils de chat et connexes, tels que des captures d’écran ou des GIF. Cependant, vous pouvez créer des « problèmes » sur une page GitHub et les soumettre pour leur examen. Ces problèmes peuvent inclure les images. Pour notifier une personne sur GitHub, utilisez @ avant son nom d’utilisateur.

Crédit image : Groot et Octocat sur Unsplash Toutes les captures d’écran prises par l’auteur.