Cómo detectar y corregir enlaces a anclas rotos y fragmentos inexistentes

¿Qué es un enlace a un ancla o un fragmento de URL?#

Un enlace a un ancla utiliza un identificador de fragmento después de # para referirse a una ubicación o un estado dentro de un recurso. En una URL típica de documentación, como /help/#installation, la ruta de la página identifica el documento y el fragmento identifica un destino dentro de él.

En un enlace convencional a una sección HTML, el fragmento suele corresponder al identificador de un elemento. Si el documento carga, pero el destino ya no existe, el visitante puede quedarse al principio o llegar a un lugar inesperado. El código de respuesta puede seguir indicando éxito porque el documento sí existe.

Por qué se rompen los enlaces a anclas después de editar el contenido#

Muchos sistemas de contenido generan los identificadores de los encabezados a partir de su texto. Cambiar «Instalación» por «Primeros pasos» puede modificar el fragmento generado aunque el tema siga en la misma página. Reordenar o duplicar encabezados también puede alterar los identificadores generados automáticamente.

Otros problemas surgen al copiar una dirección incompleta, cambiar signos de puntuación o situar el destino en contenido que solo se carga tras una interacción. Un enlace que funciona en una página ya abierta puede fallar cuando alguien ingresa la URL directamente en una pestaña nueva. Son condiciones de navegación distintas: prueba ambas.

Cómo investigar un ancla inexistente#

Abre la URL de destino completa, incluido su fragmento. Espera a que el documento cargue y comprueba si existe la sección prevista y si el navegador llega a ella. Compara el fragmento con el identificador exacto utilizado por la página; no des por hecho que el texto visible del encabezado y el identificador generado sean idénticos.

Utiliza Linky para detectar anclas inexistentes y después verifica manualmente el estado de la página correspondiente. El inspector de URL y fragmentos de este sitio puede separar los componentes de una dirección que pegues, pero no consulta el destino ni demuestra que allí exista un elemento.

1. Copia el enlace de origen completo, incluido el fragmento.
2. Ábrelo en una pestaña nueva y espera a que la página termine de cargar.
3. Identifica el encabezado o el elemento de destino previsto.
4. Compara su identificador con el fragmento.
5. Corrige el origen o el destino y vuelve a probar el recorrido publicado.

Elige identificadores estables para el contenido al que otros enlazan#

En la documentación a la que se enlaza con frecuencia, elige identificadores estables que describan el tema y resistan los cambios de redacción. Un título visible puede mejorar sin romper todos los marcadores que apuntan a él. Registra los identificadores importantes al trasladar contenido entre sistemas.

Si un ancla antigua tiene muchas referencias, considera mantener un destino compatible cerca de la sección que la sustituye. Asegúrate de que no genere identificadores duplicados ni interfiera con la accesibilidad. Si no resulta viable conservar la compatibilidad, actualiza los enlaces que controlas y comunica el nuevo destino cuando sea necesario.

Fragmentos, enrutamiento y formatos de enlace especiales#

No todos los fragmentos son simples identificadores de elementos. Algunas aplicaciones los utilizan para el enrutamiento del lado del cliente o para el estado de la aplicación. Los enlaces a fragmentos de texto también pueden identificar texto en lugar de un elemento de destino convencional. Identifica el formato antes de interpretar el resultado de un comprobador.

Si tu aplicación depende de una ruta especial basada en fragmentos, prueba la navegación directa y el comportamiento al recargar. Si el enlace debe ser una referencia normal al contenido, prefiere un destino estable que los visitantes puedan abrir y compartir sin necesitar un estado previo de la aplicación. Documenta las excepciones en la auditoría en lugar de aplicar una única regla a todas las URL.

Comprueba los enlaces directos durante migraciones y publicaciones#

Agrega los fragmentos importantes a la lista de comprobación de la migración junto con las rutas de las páginas. La navegación de la documentación, los índices y las notas de versión suelen contener muchos enlaces a secciones. Una migración de URL puede parecer correcta y, aun así, dejar esas referencias inoperantes.

Antes de publicar, prueba enlaces desde otra página, no solo el índice local. Después de publicar, analiza la página y revisa los enlaces directos conocidos. Mantén juntos el tema previsto, la página de origen y el nuevo destino en el registro de correcciones para que otro editor pueda confirmar por qué cambió el destino.

• Comprueba los identificadores generados para los encabezados después de editarlos.
• Evita identificadores duplicados dentro de un mismo documento.
• Conserva destinos estables para las secciones que se comparten con frecuencia.
• Prueba la navegación directa al contenido que se carga dinámicamente.
• Revisa los fragmentos al trasladar o combinar documentación.

Preguntas frecuentes#

Pon en práctica este procedimiento

Consulta la documentación relacionada de Linky para conocer los controles y límites del producto utilizados en este artículo. Contactar con soporte si un resultado requiere más investigación.