Mover una página
redirectFrom en el frontmatter, convertido en reglas de ruta bajo todos los prefijos.
Una página movida es el único enlace roto que un sitio de documentación se crea a sí mismo. Pon la URL antigua en el frontmatter de la página nueva y la redirección se publica en el mismo commit que el movimiento.
Pasos
- Mueve el archivo y renómbralo como pretendías.
- Enumera las rutas antiguas en la propia página, sin ningún prefijo:
--- title: Desplegar un sitio description: Dónde puede ejecutarse un sitio duxt. redirectFrom: - /getting-started/deploy - /deployment --- - Recompila. La compilación convierte cada entrada en reglas de ruta — bajo todos los prefijos de repositorio, versión y locale en los que se sirve la página.
- Comprueba una de ellas, prefijo incluido, en el sitio compilado.
Por qué el frontmatter es el sitio correcto
El arreglo siempre vivió fuera del sitio: una regla de nginx, un archivo
_redirects de Netlify, una lista de Cloudflare — escritos por quien despliega
el sitio y nunca por quien movió la página. Y solo la capa puede resolverlo una
vez, porque solo el manifiesto resuelto sabe qué prefijos existen; quien
escribiera las reglas a mano tendría que redescubrir todo el esquema en cada
página.
El prefijo numérico se elimina de la URL, así que renombrar 3.guides/ a
4.guides/ no mueve nada. Solo la parte posterior al punto es la URL.
Lista de comprobación
- Todas las rutas antiguas están listadas, escritas sin prefijo
- La compilación no informa de ningún enlace interno roto
- Una URL antigua también redirige bajo el prefijo de versión, no solo desnuda
- No se ha añadido nada a la configuración del servidor web