Skip to main content

Références et URL automatiquement liées

Les références aux URL, aux problèmes, aux demandes de tirage (pull requests) et aux validations (commits) sont automatiquement raccourcies et converties en liens.

Qui peut utiliser cette fonctionnalité ?

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

URLs

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

Visit https://github.com

Capture d’écran du rendu du Markdown de GitHub montrant comment une URL commençant par « http » devient un lien bleu cliquable. Le texte indique : « 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.

Problèmes et demandes de tirage

Dans les conversations sur GitHub, les références sur les problèmes et les demandes de tirage (pull requests) sont automatiquement converties en liens raccourcis.

Note

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://github.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)github-linguist/linguist#4039github-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

Note

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 à l’algorithme de hachage sécurisés (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/a5c3785ed8d6a35868bc169f07e40e889087fd2ea5c3785
SHAa5c3785ed8d6a35868bc169f07e40e889087fd2ea5c3785
User@SHAjlord@a5c3785ed8d6a35868bc169f07e40e889087fd2ejlord@a5c3785
Username/Repository@SHAjlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2ejlord/sheetsee.js@a5c3785

Résolution des problèmes de référencement des commits des SHA

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 ».

Pour aller plus loin