Skip to main content

Références et URL automatiquement liées

Qui peut utiliser cette fonctionnalité ?

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

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

Visit https://.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 de base pour l’écriture et la mise en forme.

Dans les conversations sur , les références aux problèmes et aux demandes d'extraction sont automatiquement converties en liens raccourcis.

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 demande de tirage (pull request)https://.com/jlord/sheetsee.js/issues/26#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-26GH-26
Username/Repository# et numéro de problème ou de demande de tirage (pull request)jlord/sheetsee.js#26jlord/sheetsee.js#26
Organization_name/Repository# et numéro de problème ou de demande de tirage (pull request)-linguist/linguist#4039-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.

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://.com//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.

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

Type de référenceRéférence bruteLien court
URL de commithttps://.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2ea5c3785
SHAa5c3785ed8d6a35868bc169f07e40e889087fd2ea5c3785
User@SHAjlord@a5c3785ed8d6a35868bc169f07e40e889087fd2ejlord@a5c3785
Username/Repository@SHAjlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2ejlord/sheetsee.js@a5c3785

Lors du référencement d'un commit d'un dépôt privé à l'intérieur d'un message de commit, le SHA du commit ne sera raccourci que si au moins un des auteurs ou des committers du commit a au moins 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, lier manuellement un problème dans une demande de tirage générera automatiquement un autre lien depuis le problème vers la demande de tirage. Pour éviter ce comportement, vous pouvez utiliser redirect..com à la place de .com lors de la construction de l’URL dans votre référence. Si vous utilisez une URL redirect..com dans votre lien de référence, aucune fenêtre contextuelle n’apparaîtra lorsque vous passerez la souris dessus.