Les programmeurs GitHub ajoutent souvent des captures d’écran ou des GIF animés à leurs demandes d’extraction de référentiel. Ces techniques sont certainement plus accrocheuses que de faire lire à quelqu’un plusieurs lignes de texte brut. L’ajout de captures d’écran statiques est utile si vous souhaitez insérer des modifications visuelles ou des photographies en ligne. Une animation GIF est un bon moyen de démontrer les flux de processus et le mouvement du curseur de la souris.
Le didacticiel suivant vous montrera dès le début comment ajouter des images de capture d’écran et une animation GIF dans les demandes d’extraction GitHub. Même si vous n’avez jamais utilisé GitHub auparavant, vous pouvez suivre ces étapes pour commencer.
1. Ajouter un nouveau référentiel et une nouvelle branche
Si vous êtes nouveau dans le monde de GitHub, suivez la procédure ici pour créer votre compte.
Cliquez sur le signe « + » en haut à droite pour créer un nouveau référentiel. N’oubliez pas de cocher l’option « Initialize this repository with a README ».
À l’étape suivante, ajoutez une branche à votre référentiel à l’aide du menu déroulant ci-dessous. Ici, la branche « Guten-tag » a été ajoutée au référentiel « Hola-World ».
Le but d’une branche dans GitHub est d’aider le développeur à travailler sur des fonctionnalités et des corrections de bogues indépendamment de la branche de production principale.
2. Créer une capture d’écran ou une animation
Pour ajouter des captures d’écran, vous avez besoin d’un bon logiciel de capture d’écran. Dans Windows 10, certains des outils les meilleurs et les plus simples sont l’outil Snip & Sketch et Snipping.
Pour ajouter une animation GIF, vous avez besoin d’un bon outil de capture d’écran vidéo. Un outil recommandé est Recordit qui est extrêmement facile à utiliser pour un screencasting rapide. Il est disponible en téléchargement direct pour Windows et macOS.
Après l’installation, vous pouvez enregistrer quelques secondes de n’importe quel écran à l’aide d’un bouton d’enregistrement. Tous vos screencasts récents seront visibles à partir du menu de la barre d’état système et s’ouvriront dans un navigateur.
Étant donné que les demandes d’extraction GitHub n’autorisent pas les fichiers vidéo (MP4, etc.), vous devrez les convertir en fichiers GIF. En fait, il prend en charge un nombre très limité de fichiers personnalisés : JPG, JPEG, GIF, PNG, DOCX, PPTX, PDF, TXT, XLSX et ZIP. Vous pouvez facilement convertir un MP4 en GIF en utilisant Ezgif ou tout autre outil en ligne.
Le fichier GIF créé suivant sera inséré dans une demande d’extraction GitHub. Il illustre la séquence simple d’ajout d’une nouvelle branche à un référentiel GitHub à l’aide de l’application GitHub Desktop.
3. Ajouter des captures d’écran ou des animations aux demandes d’extraction GitHub
Revenez à la branche que vous avez créée précédemment et accédez à « Demandes d’extraction ». Ici, vous pouvez modifier les données de la demande d’extraction à partir d’un menu à trois points.
Une fois en mode éditeur, vous pouvez joindre l’image de capture d’écran et les fichiers d’animation GIF à partir de l’option « Joindre des fichiers ». Si vous vous engagez pour la première fois dans le référentiel de branche GitHub, cliquez sur « commit ». Sinon, le choix est de « mettre à jour le commentaire ».
La capture d’écran et l’animation créées ont été ajoutées avec succès à la branche GitHub et, à son tour, au référentiel.
GitHub est axé sur la collaboration avec d’autres développeurs. S’ils aiment vos modifications proposées, ils peuvent les fusionner en amont dans leur propre référentiel. Cela se fait en utilisant l’option « merge pull request ».
Une animation est certainement un bon moyen d’attirer l’attention des autres développeurs de la communauté GitHub. En suivant ce didacticiel, vous avez appris à ajouter des captures d’écran et des animations GIF à votre référentiel GitHub et à l’une de ses branches. Si vous n’êtes pas dans GitHub, vous pouvez consulter cette liste d’alternatives GitHub à la place.
