URLs
O GitHub cria links automaticamente de URLs padrão.
Visit https://github.com
Para obter mais informações sobre como criar links, confira Sintaxe básica de gravação e formatação no GitHub.
Problemas e pull requests
Nas conversas do GitHub, as referências a problemas e pull request são convertidas automaticamente em links curtos.
Observação
As referências vinculadas automaticamente não são criadas em wikis nem arquivos em um repositório.
| Tipo de referência | Referência bruta | Link curto |
|---|---|---|
| URL do problema ou da solicitação de pull | https://github.com/jlord/sheetsee.js/issues/26 | #26 |
# e o número do problema ou da solicitação de pull | #26 | #26 |
GH- e o número do problema ou da solicitação de pull | GH-26 | GH-26 |
Username/Repository# e o número do problema ou da solicitação de pull | jlord/sheetsee.js#26 | jlord/sheetsee.js#26 |
Organization_name/Repository# e o número do problema ou da solicitação de pull | github-linguist/linguist#4039 | github-linguist/linguist#4039 |
Se você fizer referência a um problema, pull request ou discussão em uma lista, a referência irá desenrolar-se para mostrar o título e o estado. Para obter mais informações sobre listas de tarefas, confira About tasklists.
Rótulos
Ao referenciar a URL de uma etiqueta em Markdown, a etiqueta é renderizada automaticamente. Somente as etiquetas do mesmo repositório são renderizadas, as URLs que apontam para uma etiqueta de um repositório diferente são renderizadas como qualquer URL.
Para encontrar a URL de uma etiqueta, navegue até a página de etiquetas e clique em uma etiqueta. Por exemplo, a URL da etiqueta "melhoria" em nosso repositório de documentos públicos é
https://github.com/github/docs/labels/enhancement
Observação
Se o nome da etiqueta contiver um ponto (.), o rótulo não será renderizado automaticamente com base na respectiva URL.
SHAs de commit
As referências em um hash SHA de commit são convertidas automaticamente em links curtos para o commit no GitHub.
| Tipo de referência | Referência bruta | Link curto |
|---|---|---|
| URL da confirmação | https://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2e | a5c3785 |
| SHA | a5c3785ed8d6a35868bc169f07e40e889087fd2e | a5c3785 |
| User@SHA | jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e | jlord@a5c3785 |
Username/Repository@SHA | jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e | jlord/sheetsee.js@a5c3785 |
Solução de problemas de referência de SHAs para fazer commit
Ao fazer referência a um commit de um repositório privado em uma mensagem do commit, o SHA para fazer commit terá somente um link curto se, no mínimo, um dos autores ou uma pessoa que é parte da equipe de confirmadores do commit tiver, pelo menos, um acesso de leitura ao commit referenciado.
Links automáticos personalizados para recursos externos
Se as referências de link automático personalizado estão configuradas para um repositório, referências a recursos externos, como um problema do JIRA ou um ticket do Zendesk, serão convertidas em links encurtados. Para saber quais links automáticos estão disponíveis no repositório, entre em contato com alguém com permissões de administrador no repositório. Para saber mais, confira Configurar links automáticos para fazer referência a recursos externos.
Evitando backlinks para referências vinculadas
Por padrão, as referências geram um backlink. Por exemplo, vincular manualmente a um issue em uma pull request gerará automaticamente outro link do issue de volta para a pull request.
Para evitar esse comportamento, você pode usar redirect.github.com em vez de github.com ao construir a URL em sua referência. Se você usar uma URL redirect.github.com no link de referência, nenhuma janela pop-up será exibida ao passar o mouse sobre ela.