Acerca de los autoenlaces
Cualquier usuario con permisos de administración en un repositorio puede configurar referencias de enlace automático para vincular propuestas, solicitudes de cambios, mensajes de confirmación y descripciones de lanzamientos con los servicios externos de terceros.
Las referencias de los autoenlaces ahora pueden aceptar caracteres alfanuméricos. Cuando se introdujeron originalmente, los autoenlaces personalizados se limitaron a los recursos externos que utilizaban identificadores numéricos. Los autoenlaces personalizados ahora funcionan con identificadores aklfanuméricos. Las referencias de autoenlace tradicionales que reconocen únicamente identificadores numéricos son obsoletas ahora y se muestran con la etiqueta "legacy".
Puedes definir los autoenlaces personalizados si especificas un prefijo de referencia y una URL destino.
- Los prefijos de referencia no pueden tener nombres superpuestos. Por ejemplo, un repositorio no puede tener dos autoenlaces personalizados con prefijos tales como
TICKET
yTICK
, ya que ambos prefijos coincidirían con la secuenciaTICKET123a
. - Las URL destino incluyen una variable
<num>
que es compatible con los siguientes caracteres:a-z
(con distinción de mayúsculas y minúsculas),0-9
y-
.
Configurar enlaces automáticos para referenciar recursos externos
Este procedimiento demuestra cómo configurar los autoenlaces para referenciar recursos externos. Por ejemplo, si utilizas Zendesk para rastrear los tickets que reportan los usuarios, puedes referenciar un número de ticket en la solicitud de cambios que abriste para corregir la propuesta.
-
En GitHub.com, visita la página principal del repositorio.
-
Debajo de tu nombre de repositorio, da clic en Configuración.
-
En la sección de "integraciones" de la barra lateral, haz clic en Referencias de autoenlace.
-
Haz clic en Add autolink reference (Agregar referencia de enlace automático).
-
Debajo de "Reference prefix" (Prefijo de referencia), escribe un prefijo corto y significativo que quieras que los colaboradores utilicen para generar enlaces automáticos para el recurso externo.
-
Debajo de "Target URL" (URL de destino), escribe el enlace al sistema externo al que te quieras vinculr. Asegúrate de conservar
<num>
como variable para el número de referencia. -
Haz clic en Add autolink reference (Agregar referencia de enlace automático).