Sobre redireccionamientos
Si se realiza un cambio en un artículo que afecta a la capacidad de las personas para encontrarlo, creamos un redireccionamiento desde cualquier versión obsoleta al contenido actual. Es posible que tengamos que hacerlo si se cambia el título de un artículo, se agrega una nueva versión o se cambia la ubicación del archivo.
Los redireccionamientos se pueden configurar local o externamente.
Configuración de redireccionamientos locales
Dentro de GitHub Docs, puedes redirigir de un archivo a otro o de una versión a otra.
Redireccionamientos entre archivos
Si cambias el nombre de un artículo y deseas que su dirección URL anterior redirija a su nueva dirección URL para todas las versiones, usa el texto preliminar redirect_from con la ruta de acceso al nombre anterior del artículo. Si cambias el nombre de un artículo y deseas que diferentes versiones redirijan a direcciones URL diferentes, sigue los pasos descritos en la sección Redirecciones entre versiones.
En el ejemplo siguiente, se cambió el nombre del artículo "All about commits" a "Creating your first commit". El texto preliminar redirect_from redirige a cualquier persona que vaya a la dirección URL del artículo anterior a la dirección URL del nuevo artículo.
title: Creating your first commit
redirect_from:
- /content/get-started/all-about-commits
Consulta redirect_from el archivo LÉAME de GitHub Docs para obtener más detalles.
Redireccionamientos automáticos para direcciones URL que no incluyen una versión
Si se introduce una dirección URL de una página sin una versión (https://docs.github.com/ARTICLE en lugar de https://docs.github.com/VERSION/ARTICLE), el sitio te redirigirá automáticamente a la primera versión disponible de la página.
El orden de precedencia se especifica en lib/all-versions.ts. El orden actual de precedencia es:
- GitHub Free, GitHub Pro, o GitHub Team (
fpt) - GitHub Enterprise Cloud (
ghec) - GitHub Enterprise Server (
ghes)
Si una página titulada ARTICLE solo está disponible en GitHub Enterprise Cloud y GitHub Enterprise Server, el vínculo https://docs.github.com/ARTICLE se redirigirá automáticamente a https://docs.github.com/enterprise-cloud@latest/ARTICLE porque GitHub Enterprise Cloud tiene precedencia sobre GitHub Enterprise Server.
Si ARTICLE está disponible en Free, Pro o Team, no se producirá ningún redireccionamiento porque fpt las páginas no tienen un segmento de versión, por lo que el contenido fpt en https://docs.github.com/ARTICLE se representará.
Redireccionamientos entre versiones
Si deseas que la dirección URL de una versión de un artículo redirija a una URL de otra versión o a otra URL completamente distinta, debes actualizar el archivo redirect-exceptions.txt en el directorio src/redirects.
Por ejemplo, si eliminas la versión Free, Pro o Team (fpt) de un artículo, la dirección URL redirigirá automáticamente a la siguiente versión disponible de la página. Si quieres que se redirija a una versión más baja en el orden de precedencia, o a una página diferente por completo, debes especificar una excepción.
Cada entrada del archivo redirect-exceptions debe comenzar con la ruta a la que quieras redirigir, incluida la versión, seguida de una lista desordenada de las rutas desde las que quieras redirigir. En el ejemplo siguiente, las rutas de la lista sin ordenar redirigirán a la versión GitHub Enterprise Cloud de Exportar la información de los miembros de tu organización.
/enterprise-cloud@latest/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization
- /[email protected]/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization
- /[email protected]/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization
- /[email protected]/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization
Configuración de redirecciones externas
Rara vez, el contenido se moverá fuera del sitio GitHub Docs. Para este tipo de redireccionamientos, actualiza el archivo external-sites.json en el directorio src/redirects.
Cada entrada del archivo external-sites.json es un par clave-valor donde la clave es la ruta a la ubicación en la que se encontraba el contenido y el valor es la ruta a la ubicación a la que debe redirigir.
"/github-status": "https://www.githubstatus.com/",
"/articles/github-security": "https://github.com/security",