CrĂ©ation d’un lien permanent vers un extrait de code

Vous pouvez crĂ©er un lien permanent vers une ligne ou une plage de lignes de code spĂ©cifique dans une version spĂ©cifique d’un fichier ou d’une demande de tirage (pull request).

Qui peut utiliser cette fonctionnalité ?

Markdown peut ĂȘtre utilisĂ© dans l’interface web GitHub.

Dans cet article

Liaison Ă  du code

Ce type de lien permanent s’affichera en tant qu’extrait de code uniquement dans le dĂ©pĂŽt d’oĂč il provient. Dans d’autres dĂ©pĂŽts, l’extrait de code de lien permanent s’affichera en tant qu’URL. Cela ne fonctionne pas dans les fichiers Markdown, uniquement dans les commentaires.

Capture d’écran d’un commentaire de problĂšme. Un extrait de code se compose d'un en-tĂȘte qui indique le nom du fichier et les numĂ©ros de ligne, et d'un corps qui contient le code de ces lignes.

Conseil

Pour créer un lien permanent pour un fichier entier, consultez Obtention de liens permanents vers des fichiers.

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Localisez le code avec lequel que vous Ă©tablir le lien :

    • Pour Ă©tablir un lien Ă  un code Ă  partir d’un fichier, accĂ©dez Ă  celui-ci.
    • Pour crĂ©er un lien vers le code d'une requĂȘte de tirage, naviguez jusqu'Ă  la requĂȘte de tirage et cliquez sur Fichiers modifiĂ©s. Ensuite, recherchez le fichier contenant le code que vous souhaitez inclure dans votre commentaire, puis cliquez sur Afficher.

  3. Choisissez s’il faut sĂ©lectionner une seule ligne ou une plage.

    • Pour sĂ©lectionner une seule ligne de code, cliquez sur le numĂ©ro de la ligne pour mettre celle-ci en surbrillance.
    • Pour sĂ©lectionner une plage de code, cliquez sur le numĂ©ro de la premiĂšre ligne de code de la plage pour mettre celle-ci en surbrillance. Pointez ensuite sur la derniĂšre ligne de la plage de code, appuyez sur Maj et cliquez sur le numĂ©ro de la ligne pour mettre la plage en surbrillance.

  4. À gauche de la ligne ou de la plage de lignes, cliquez sur . Dans le menu dĂ©roulant, cliquez sur Copier le lien permanent.

    Capture d’écran d’un fichier avec 8 lignes sĂ©lectionnĂ©es. À gauche de la premiĂšre ligne sĂ©lectionnĂ©e, un bouton Ă©tiquetĂ© avec une icĂŽne de trois points est indiquĂ© en orange foncĂ©.

  5. AccĂ©dez Ă  la conversation dans laquelle vous souhaitez Ă©tablir un lien Ă  l’extrait de code.

  6. Collez votre lien permanent dans un commentaire, puis cliquez sur Commentaire.

Liaison Ă  Markdown

Vous pouvez lier des lignes spĂ©cifiques dans des fichiers Markdown en chargeant le fichier Markdown sans rendu Markdown. Pour charger un fichier Markdown sans effectuer de rendu, vous pouvez utiliser le paramĂštre ?plain=1 Ă  la fin de l'URL du fichier. Par exemple : github.com/<organization>/<repository>/blob/<commit_SHA>/README.md?plain=1.

Vous pouvez crĂ©er un lien Ă  une ligne spĂ©cifique dans le fichier Markdown de la mĂȘme façon que dans du code. Ajouter #L avec le numĂ©ro de ligne ou les numĂ©ros Ă  la fin de l'URL. Par exemple, github.com/<organization>/<repository>/blob/<commit_SHA>/README.md?plain=1#L14 mettra en Ă©vidence la ligne 14 dans le fichier README.md brut.

Pour aller plus loin