Références et URL automatiquement liées

Les références aux URL, aux problèmes, aux pull requests et aux commits sont automatiquement raccourcies et converties en liens.

Qui peut utiliser cette fonctionnalité ?

Markdown peut être utilisé dans l’interface web GitHub.

Dans cet article

URLs

GitHub crée automatiquement des liens à partir d'URL standard.

Visit https://github.com

Capture d'écran du rendu GitHub Markdown montrant comment une URL est affichée sous la forme d'un lien bleu cliquable, « Visitez https://github.com »

Pour plus d’informations sur la création de liens, consultez Syntaxe d’écriture et de mise en forme de base.

Problèmes et pull requests

Dans les conversations sur GitHub, les références aux tickets et aux pull requests sont automatiquement transformées en liens courts.

Remarque

Les références automatiquement liées ne sont pas créées dans les wikis ou les fichiers d’un référentiel.

Type de référenceRéférence bruteLien court
URL de problème ou de pull request (demande)https://github.com/jlord/sheetsee.js/issues/26
          [#26](https://github.com/jlord/sheetsee.js/issues/26)

| # et numéro de problème ou de demande de tirage (pull request) | #26 | #26 | | GH- et numéro de problème ou de demande de tirage (pull request) | GH-26 | GH-26 | | Username/Repository# et numéro de problème ou de demande de tirage (pull request) | jlord/sheetsee.js#26 | jlord/sheetsee.js#26 | Organization_name/Repository# et numéro de problème ou de demande de tirage (pull request) | github-linguist/linguist#4039 | github-linguist/linguist#4039

Si vous référencez un problème, une demande de tirage ou une discussion dans une liste, la référence se déploie pour afficher le titre et l’état à la place. Pour plus d’informations sur les listes de tâches, consultez À propos des listes de tâches.

Étiquettes

Lorsque vous référencez l’URL d’une étiquette dans Markdown, l’étiquette est automatiquement affichée. Seules les étiquettes du même dépôt sont affichées, les URL pointant vers une étiquette à partir d’un autre dépôt sont affichées comme n’importe quelle URL.

L’URL d’une étiquette est disponible en accédant à la page des étiquettes et en cliquant sur l’une d’entre elles. Par exemple, l’URL de l’étiquette « amélioration » dans notre dépôt de documentation public est

https://github.com/github/docs/labels/enhancement

Remarque

Si le nom de l’étiquette contient un point (.), l’étiquette ne s’affiche pas automatiquement à partir de l’URL de l’étiquette.

Algorithmes de hachage sécurisés (SHA) de commit

Les références au hachage SHA d'un commit sont automatiquement converties en liens raccourcis vers le commit sur GitHub.

Type de référenceRéférence bruteLien court
URL de commithttps://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e
          [a5c3785](https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e) |

| SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | a5c3785 | | User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | jlord@a5c3785 | Username/Repository@SHA | jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | jlord/sheetsee.js@a5c3785 |

Résolution des problèmes liés à la référence des SHA de commits

Lorsqu’on référence un commit provenant d’un dépôt privé dans un message de commit, le SHA du commit ne sera converti en lien court que si au moins un des auteurs ou des committers dispose au moins d’un accès en lecture au commit référencé.

Si des références personnalisées de lien automatique sont configurées pour un référentiel, les références à des ressources externes, comme un problème de JIRA ou un ticket Zendesk, sont converties en liens raccourcis. Pour savoir quels liens automatiques sont disponibles dans votre référentiel, contactez une personne disposant d’autorisations d’administration sur le référentiel. Pour plus d’informations, consultez « Configuration de liens automatiques pour référencer des ressources externes ».

Par défaut, les références génèrent un backlink. Par exemple, créer manuellement un lien vers un problème dans une demande de tirage (pull request) générera automatiquement depuis le problème un lien de retour vers la demande de tirage. Pour éviter ce comportement, vous pouvez utiliser redirect.github.com à la place de github.com lors de la construction de l’URL dans votre référence. Si vous utilisez une URL redirect.github.com dans votre lien de référence, aucune fenêtre contextuelle n’apparaîtra lorsque vous passerez la souris dessus.

Remarque

Cette méthode n’est pas prise en charge dans GitHub Enterprise Cloud avec Data Residency (ghe.com).

Pour aller plus loin

  •         [AUTOTITLE](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)