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 « Initialiser ce référentiel avec un fichier 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 séparément 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 Snip & Sketch et Snipping tool.
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 Enregistrer. Tous vos screencasts récents seront visibles dans le menu de la barre d’état système et ouverts dans un navigateur.
Étant donné que les requêtes 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 montre la séquence simple d’ajout d’une nouvelle branche à un référentiel GitHub à l’aide de l’application GitHub Desktop.
3. Ajoutez 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 à « Pull request ». 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 la 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, à leur tour, au référentiel.
GitHub est tout au sujet de la collaboration avec d’autres développeurs. S’ils aiment les modifications que vous proposez, ils peuvent les fusionner en amont dans leur propre référentiel. Cela se fait à l’aide de 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 complétant 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 plutôt consulter cette liste d’alternatives à GitHub.
