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.

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.

Tip

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 lier un code depuis une demande de tirage (pull request), accédez à la demande de tirage et cliquez sur Fichiers changés. Ensuite, accédez au 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 rendu, vous pouvez utiliser le paramètre ?plain=1 à la fin de l’URL du fichier. Par exemple : github.com/<organization>/<repository>/blob/<branch_name>/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. Ajoutez #L avec le numéro de ligne ou les chiffres à la fin de l’URL. Par exemple, github.com/<organization>/<repository>/blob/<branch_name>/README.md?plain=1#L14 mettra en évidence la ligne 14 dans le fichier README.md brut.

Pour aller plus loin