Resolver un enlace heredado de artículo público
Usa esta guía cuando un enlace antiguo de ayuda pública contenga solo un id de artículo, como /manual/es-access-users-create-location-internal. La pantalla pública de Docs carga el índice de Docs en español, sustituye la ruta antigua por /docs/accesos/es-access-users-create-location-internal y muestra el artículo sin requerir inicio de sesión.
En este artículo
Los enlaces antiguos de ayuda pública bajo /docs, /manual y /wiki siguen abriendo la pantalla pública de Docs. Cuando el enlace solo contiene un id de artículo, la pantalla lo resuelve contra el índice cargado antes de mostrar el artículo.
En el ejemplo de ES, /manual/es-access-users-create-location-internal se convierte en /docs/accesos/es-access-users-create-location-internal y muestra Crear un usuario interno de ubicación para Marea Gran Via.
Antes de empezar
- El sitio público de la landing de Antylogic es alcanzable y puede mostrar la pantalla de Docs.
- PUBLIC_API_BASE_URL apunta a un host de API que sirve /api/public/docs.
- El bundle de Docs en español incluye es-access-users-create-location-internal.
- No se requiere usuario autenticado, pertenencia a organización, pertenencia a ubicación, rol ni sesión demo.
- Para el contexto de ES en español, el locale de los Docs públicos resuelve a es.
Instrucciones
- 1.
Abre el enlace público antiguo
Abre /manual/es-access-users-create-location-internal, o la ruta equivalente de un solo segmento bajo /docs o /wiki. La página permanece pública y de solo lectura.
- 2.
Deja que se cargue el índice de Docs
La pantalla solicita GET /api/public/docs con locale=es más la plataforma y el tema seleccionados. La resolución heredada solo se ejecuta cuando ese índice ha respondido correctamente.
- 3.
Confirma la ruta canónica
Cuando el resumen cargado coincide con el id recortado y convertido a slug, el navegador sustituye la ruta antigua por /docs/accesos/es-access-users-create-location-internal. El prefijo /manual o /wiki no se conserva.
- 4.
Lee el artículo
La petición normal de detalle del artículo carga GET /api/public/docs/accesos/es-access-users-create-location-internal con los mismos parámetros de locale, plataforma y tema, y después renderiza Crear un usuario interno de ubicación.
- 5.
Gestiona los enlaces no resueltos
Si el id no está en el índice del locale actual, la URL no se sustituye y no se solicita ningún detalle de artículo. Comparte un enlace canónico publicado de Docs cuando el id antiguo no se encuentre.
Validaciones y límites
- La ruta heredada debe coincidir con /docs/:articleId, /manual/:articleId o /wiki/:articleId.
- El id entrante se recorta y normaliza con las reglas de slug del frontend antes de compararse.
- Un id heredado resuelve solo cuando un resumen de artículo cargado tiene el mismo slug o el mismo id tras la normalización.
- El destino de sustitución usa siempre /docs/{sectionSlug}/{articleSlug} y emplea replace del historial del navegador.
- Si la petición de índice o de detalle falla, la pantalla de Docs muestra el error genérico de carga.
- Las rutas de dos segmentos /manual/:sectionSlug/:articleSlug y /wiki/:sectionSlug/:articleSlug se renderizan en el sitio y no se canonizan solo por su prefijo.
Resultado esperado
El visitante llega al artículo público actual sin autenticación, y el historial del navegador contiene la ruta canónica /docs/accesos/es-access-users-create-location-internal en lugar del enlace antiguo de un solo segmento.