{"meta":{"title":"Affichage et compréhension des fichiers","intro":"Explorez le contenu du fichier et les modifications de trace au fil du temps pour comprendre une nouvelle base de code et son évolution.","product":"Référentiels","breadcrumbs":[{"href":"/fr/repositories","title":"Référentiels"},{"href":"/fr/repositories/working-with-files","title":"Utiliser des fichiers"},{"href":"/fr/repositories/working-with-files/using-files","title":"Utilisation de fichiers"},{"href":"/fr/repositories/working-with-files/using-files/viewing-and-understanding-files","title":"Visualiser et comprendre les fichiers"}],"documentType":"article"},"body":"# Affichage et compréhension des fichiers\n\nExplorez le contenu du fichier et les modifications de trace au fil du temps pour comprendre une nouvelle base de code et son évolution.\n\nGitHub fournit des outils permettant de visualiser le contenu brut, de suivre les modifications apportées à des lignes spécifiques et d'explorer l'évolution du contenu d'un fichier au fil du temps. Ces insights révèlent comment le code a été développé, son objectif actuel et sa structure, ce qui vous aide à contribuer efficacement.\n\n## Affichage ou copie du contenu d’un fichier brut\n\nL’affichage brut vous permet d’afficher ou de copier le contenu brut d’un fichier sans aucun style.\n\n1. Sur GitHub, accédez à la page principale du référentiel.\n\n2. Cliquez sur le fichier que vous souhaitez afficher.\n\n3. Dans le coin supérieur droit de la vue du fichier, cliquez sur **Raw**.\n\n \n\n4. Si vous le souhaitez, pour copier le contenu du fichier brut, dans le coin supérieur droit de la vue du fichier, cliquez sur **** . Pour télécharger le fichier brut, cliquez sur ****.\n\n## Affichage de l’historique de révision ligne par ligne pour un fichier\n\nDans la vue Blame, vous pouvez voir l’historique des révisions ligne par ligne d’un fichier dans son intégralité.\n\n> \\[!TIP]\n> Sur la ligne de commande `git blame`, vous pouvez également utiliser cette fonction pour afficher l'historique des révisions des lignes d'un fichier. Pour plus d’informations, consultez la [documentation Git sur `git blame`](https://git-scm.com/docs/git-blame).\n\n1. Sur GitHub, accédez à la page principale du référentiel.\n\n2. Cliquez pour ouvrir le fichier dont vous souhaitez afficher l’historique des lignes.\n\n3. Au-dessus du contenu du fichier, cliquez sur **Blame**. Ce mode vous permet d’accéder à un historique des révisions ligne par ligne, où le code se trouve dans un fichier séparé par commit. Chaque commit liste l’auteur, la description et la date du commit.\n\n4. Pour voir les versions d’un fichier avant un commit particulier, cliquez sur . Sinon, pour voir plus de détails sur un commit en particulier, cliquez sur le message de commit.\n\n \n\n5. Pour retourner au mode Code brut, au-dessus du contenu du fichier, cliquez sur **Code**.\n * Si vous visualisez un fichier Markdown, au-dessus du contenu du fichier, vous pouvez également cliquer sur **Aperçu** pour retourner à la vue où la mise en forme Markdown est appliquée.\n\n## Ignorer des commits dans l’affichage des blâmes\n\nToutes les révisions spécifiées dans le fichier `.git-blame-ignore-revs`, qui doit se trouver dans le répertoire racine de votre dépôt, sont masquées de l’affichage des blâmes à l’aide du paramètre de configuration Git `git blame --ignore-revs-file`. Pour plus d’informations, consultez [`git blame --ignore-revs-file`](https://git-scm.com/docs/git-blame#Documentation/git-blame.txt---ignore-revs-fileltfilegt) dans la documentation Git.\n\n1. Dans le répertoire racine de votre dépôt, créez un fichier nommé `.git-blame-ignore-revs`.\n\n2. Ajoutez les hachages de commit que vous souhaitez exclure de l’affichage des blâmes pour ce fichier. Nous vous recommandons de structurer le fichier comme suit, y compris les commentaires :\n\n ```shell\n # .git-blame-ignore-revs\n # Removed semi-colons from the entire codebase\n a8940f7fbddf7fad9d7d50014d4e8d46baf30592\n # Converted all JavaScript to TypeScript\n 69d029cec8337c616552756310748c4a507bd75a\n ```\n\n3. Commitez et poussez (push) les changements.\n\nDans la vue de responsabilité, les révisions sont exclues si le commit **a introduit de nouvelles lignes** ou modifié des lignes existantes. Si le commit a été le dernier à **modifier** une ligne, il apparaît toujours dans la vue blame. Vous voyez la bannière « Révisions dans .git-blame-ignore-revs ignorées » qui indique que certains commits peuvent être masqués :\n\n\n\n\n\nCela peut être utile si quelques commits apportent des modifications importantes à votre code. Vous pouvez également utiliser le fichier lors de l’exécution locale de `git blame` :\n\n```shell\ngit blame --ignore-revs-file .git-blame-ignore-revs\n```\n\nVous pouvez également configurer votre dépôt Git local afin qu’il ignore toujours les révisions dans ce fichier :\n\n```shell\ngit config blame.ignoreRevsFile .git-blame-ignore-revs\n```\n\n## Contournement de `.git-blame-ignore-revs` dans l’affichage des blâmes\n\nSi l’affichage des blâmes d’un fichier indique **Révisions dans .git-blame-ignore-revs ignorées**, vous pouvez toujours contourner `.git-blame-ignore-revs` et consulter l’affichage des blâmes normal. Dans l’URL, ajoutez un `~` au SHA et la bannière **Ignorer les révisions dans .git-blame-ignore-revs** disparaîtra.\n\n## Comprendre les fichiers avec Copilot\n\n> \\[!NOTE] Vous aurez besoin d’accéder à GitHub Copilot. Pour plus d’informations, consultez « [Qu’est-ce que GitHub Copilot ?](/fr/copilot/get-started/what-is-github-copilot#get-access) ».\n\nVous pouvez également utiliser Copilot pour poser des questions sur des lignes de code spécifiques dans un fichier, ce qui vous aide à comprendre le fonctionnement du code et réduit le risque d'introduire de nouveaux problèmes.\n\n1. Dans GitHub, accédez à un référentiel et ouvrez un fichier.\n\n2. Effectuez l’une des opérations suivantes :\n * Pour poser une question sur **l'ensemble du fichier**, cliquez sur l'icône Copilot () en haut à droite de la vue du fichier.\n\n \n\n * Pour poser une question sur des **lignes spécifiques** du fichier :\n\n 1. Cliquez sur le numéro de ligne de la première ligne que vous souhaitez interroger, maintenez la touche Majuscule enfoncée, puis cliquez sur le numéro de ligne de la dernière ligne que vous souhaitez sélectionner.\n 2. Pour poser votre propre question sur les lignes sélectionnées, cliquez sur l'icône Copilot () à droite de votre sélection, puis saisissez votre question dans le panneau GitHub Copilot Chat.\n 3. Pour poser une question prédéfinie, cliquez sur le bouton pointant vers le bas à côté de l’icône de Copilot, puis choisissez l’une des options.\n\n \n\n3. Si vous avez cliqué sur l’icône de Copilot, saisissez une question dans la zone Demander à Copilot en bas du volet de conversation, puis appuyez sur Entrée.\n\n Par exemple, si vous souhaitez poser des questions sur l’intégralité du fichier, vous pouvez entrer :\n\n * `Explain this file.`\n * `How could I improve this code?`\n * `How can I test this script?`\n\n Si vous souhaitez poser des questions sur des lignes spécifiques, vous pouvez entrer :\n\n * `Explain the function at the selected lines.`\n * `How could I improve this class?`\n * `Add error handling to this code.`\n * `Write a unit test for this method.`\n\n Copilot répond à votre demande dans le volet.\n\n4. Après avoir soumis une question, vous pouvez cliquer sur dans la zone de texte pour arrêter la réponse.\n\n5. Vous pouvez poursuivre la conversation en posant une question de suivi. Par exemple, vous pouvez saisir « Dites-m’en plus » pour que Copilot développe son dernier commentaire."}