Descargo de responsabilidad: Este artículo se generó mediante traducción automática.

Regla de redireccionamiento de artículos

Prev Next

Planes que admiten el uso de reglas de redireccionamiento de artículos en el sitio de la base de conocimientos

Profesional
Negocio
Empresa






Puede configurar una regla de redireccionamiento de artículos para cualquier URL de artículo publicado o en borrador. La función de redireccionamiento es útil cuando se cambia la URL de un artículo y se hace referencia a esa misma URL en otros artículos del sitio de la base de conocimientos. También puede realizar una importación masiva de reglas de redireccionamiento.

Las reglas de redireccionamiento evitan que los usuarios hagan clic en enlaces muertos o rotos.


Adición de una regla de redireccionamiento de artículo

Puede cambiar la URL o el slug de un artículo antes o después de publicar la página del artículo o la categoría. También se puede modificar la dirección URL de una categoría de tipo índice. Puede realizar estos cambios directamente en el editor de artículos.

Para agregar la regla de redireccionamiento de artículos, siga los pasos a continuación:

  1. Vaya a Configuración ()> Sitio de la base de conocimientos > Reglas de redireccionamiento de artículos en el portal de la base de conocimientos.

    Aparecerá la página Reglas de redireccionamiento de artículos con una lista de las reglas existentes (si las hay).

  2. Haga clic en Nueva redirección para crear una nueva regla de redirección.

    Aparecerá el panel Nueva regla de redireccionamiento .

  3. Seleccione el tipo de redireccionamiento deseado:
    a. Termina con: Para establecer la regla de redirección para un artículo con el slug único al final de su URL.
    b. Reemplazar con: Para establecer la regla de redirección para el texto de la URL entre el nombre de dominio y el slug del artículo.

Termina con

  1. En el campo Ruta de origen , escriba el slug único al final de la URL para la redirección.

NOTA

El slug de URL en la ruta de origen debe comenzar con una barra diagonal (/).

  1. En el campo URL de destino , escriba la URL de destino completa o escriba el nuevo slug para la redirección. Agregar una barra diagonal (/) al principio de la URL de destino es opcional.

Ejemplo: Para redirigir la URL del artículo de a https://docs.document360.com/docs/getting-started-video-library, agregue la ruta de origen y la URL de https://docs.document360.com/docs/getting-started-with-document360 destino como se menciona a continuación:
Ruta de acceso de origen: /getting-started-with-document360
URL de destino: getting-started-video-library

  1. Haga clic en Crear.

Reemplácelo con

  1. En el campo Ruta de origen , escriba el texto entre el dominio y el slug del artículo que desea redirigir.

Ejemplo: La ruta de origen de la URL https://project.technicaldocumentation.com/v1/docs/fr/getting-started es /v1/docs/fr/.

NOTA

La ruta de acceso de origen debe comenzar y terminar con una barra diagonal (/).

  1. En el campo Reemplazar texto , escriba el nuevo texto de URL que desea utilizar para el redireccionamiento.

Ejemplo: Reemplácelo /v1/docs/fr/ por /v2/docs/en/ en la URL https://project.technicaldocumentation.com/v1/docs/fr/getting-started.

NOTA

El texto de reemplazo debe comenzar y terminar con una barra diagonal (/).

  1. Haga clic en Crear.


Prácticas recomendadas

Si administra una base de conocimientos multilingüe con varios espacios de trabajo de proyecto, establezca reglas de redireccionamiento basadas en el idioma o el espacio de trabajo. Por ejemplo, si establece una regla con la ruta /customer-support de origen y el destino /sales-and-support, esto solo se aplica al idioma predeterminado del espacio de trabajo principal.

  • Para aplicar esta regla a otro idioma (por ejemplo, alemán: /de/), cree una nueva regla con la ruta /de/customer-support de origen y el destino /de/sales-and-support.

  • Para aplicar la regla en otro espacio de trabajo (por ejemplo, versión 1: /v1/), establezca la ruta /v1/docs/customer-support de origen y el destino /v1/docs/sales-and-support.


Regla de redireccionamiento a nivel de sitio

En la página Reglas de redireccionamiento de artículos , puede establecer una regla de redireccionamiento de subcarpeta en el nivel de sitio mediante la opción Reemplazar con . Esto es útil para migrar desde otra plataforma o redirigir espacios de trabajo/idiomas obsoletos.

Ejemplo: Establezca una regla de redireccionamiento para la subcarpeta /azure/serverless /data/cloud360 en las URL como https://apidocs.serverless360.com/azure/serverless/article_slug.


Edición de una regla de redireccionamiento

Para editar la regla de redireccionamiento de artículos, siga los pasos a continuación:

  1. Vaya a Configuración ()> Sitio de la base de conocimientos > Reglas de redireccionamiento de artículos en el portal de la base de conocimientos.

    Aparecerá la página Reglas de redireccionamiento de artículos con una lista de las reglas existentes (si las hay).

  2. Utilice el filtro para encontrar la regla de redireccionamiento deseada.

  3. Coloque el cursor sobre la regla deseada y haga clic en el icono Editar ().

    Aparecerá el panel Editar regla de redireccionamiento .

  4. Actualice los campos necesarios.

  5. Haga clic en Actualizar.


Eliminación de una regla de redireccionamiento

Para eliminar una regla de redireccionamiento de artículo, siga los pasos a continuación:

  1. Vaya a Configuración ()> Sitio de la base de conocimientos > Reglas de redireccionamiento de artículos en el portal de la base de conocimientos.

    Aparecerá la página Reglas de redireccionamiento de artículos con una lista de las reglas existentes (si las hay).

  2. Utilice Filtro para encontrar la regla de redireccionamiento deseada.

  3. Coloque el cursor sobre la regla deseada y haga clic en el icono Eliminar ().

  4. Para eliminar varias reglas, seleccione las casillas de verificación junto a las reglas y haga clic en Eliminar.

  5. Haga clic en en el panel de confirmación Eliminar .

NOTA

Las reglas de redireccionamiento eliminadas no se pueden recuperar.


Filtrar una regla de redireccionamiento

Para filtrar la regla de redireccionamiento deseada, siga los pasos a continuación:

  1. Buscar: introduzca una palabra clave de la ruta de origen o la URL de destino en la barra de búsqueda y se rellenará el resultado.

  2. Tipo: Filtrar por el tipo de redireccionamiento: Termina con, Reemplazar con o Ambos.

  3. Fecha de modificación: filtre las reglas por la fecha de la última modificación, con opciones como 1 año, 3 meses, 30 días o 7 días. Haga clic en Fecha personalizada para elegir cualquier intervalo de fechas personalizado y seleccione el intervalo de fechas deseado.


Importación de reglas de redireccionamiento

Para importar reglas de redireccionamiento masivo a la vez, cargue un archivo CSV que coincida con la siguiente plantilla:

Fuente

Destino

RedirectionType

/myoldarticle

newarticle

Termina con

/en/customers/

/v1/docs/

reemplazarcon

NOTA

El tamaño del archivo debe ser menor o igual a 1 MB.

Importar plantilla de archivo de regla de redireccionamiento

También puedes descargar la plantilla aquí:

Para importar reglas de redireccionamiento de forma masiva:

  1. Prepare un archivo CSV que coincida con la plantilla proporcionada (tamaño de archivo ≤ 1 MB).

  2. Vaya a Configuración ()> Sitio de la base de conocimientos > Reglas de redireccionamiento de artículos en el portal de la base de conocimientos.

  3. Haga clic en Importar regla de redireccionamiento.

    Aparecerá el panel Importar reglas de redireccionamiento .  

  4. Arrastre y suelte el archivo CSV o seleccione Haga clic para cargar.

  5. Revise la lista de reglas válidas e inválidas.

    NOTA

    Haga clic en el icono Descargar () cerca del recuento de reglas no válidas para descargar la lista de reglas no válidas.

  6. Haga clic en Importar para aplicar las reglas válidas.


Exportación de reglas de redireccionamiento

Para exportar reglas de redireccionamiento como un archivo CSV, siga los pasos que se indican a continuación:

  1. Vaya a Configuración ()> Sitio de la base de conocimientos > Reglas de redireccionamiento de artículos en el portal de la base de conocimientos.

  2. Haga clic en Exportar para descargar las reglas como un archivo CSV.


Solución de problemas

Artículo publicado que redirige o muestra un error 404

Un artículo publicado en el sitio de la base de conocimientos puede redirigir a otro artículo o provocar un error 404 debido a una regla de redirección mal configurada aplicada al enlace del artículo.

Pasos para resolverlo:

  1. Vaya a Configuración ()> Sitio de la base de conocimientos > Reglas de redireccionamiento de artículos en el portal de la base de conocimientos.

  2. Utilice la barra de búsqueda para encontrar el slug del artículo y comprobar si se aplica una regla de redirección.

  3. Si se aplica una regla de redireccionamiento, revise su propósito. Si la regla es innecesaria o está mal configurada, elimínela.

  4. Guarde los cambios y vuelva a visitar el artículo para asegurarse de que se muestra como se esperaba en el sitio de la base de conocimientos.

Si el problema persiste después de seguir estos pasos, póngase en contacto con el equipo de soporte de Document360 para obtener más ayuda: Póngase en contacto con el equipo de soporte de Document360

Published article redirecting or showing a 404 error

Encontrar un error al guardar una regla de redirección de artículo.

Error: No se pudo guardar la regla de redirección de artículos. El origen dado ya forma parte de un destino existente.

Este error se produce cuando un slug de destino (el destino de una regla de redireccionamiento existente) se utiliza como ruta de origen para otra redirección. Una vez que se establece un destino en una regla de redireccionamiento, se convierte en un destino estático y no se puede volver a utilizar como origen en una nueva regla.

Pasos para resolverlo:

  • Asegúrese de que el slug de destino no se utilice como ruta de acceso de origen en ninguna regla de redireccionamiento nueva o existente.

  • Revise y actualice las reglas de redireccionamiento para evitar conflictos.

An error message indicating failure to save article redirection rule in the Knowledge base portal.

Evitar errores 404 después de quitar idiomas en el sitio de la base de conocimientos

Cuando se eliminan u ocultan idiomas del sitio de la base de conocimientos, los lectores pueden encontrar errores 404 si intentan acceder a las versiones de los artículos en los idiomas eliminados.

Una vez que se elimina un idioma del proyecto, todos los artículos asociados con ese idioma dejan de estar disponibles. Sin embargo, los usuarios con enlaces marcados o acceso directo a esas URL pueden intentar abrirlas, lo que provoca errores 404.

Pasos para resolverlo:

Para evitar errores 404 y redirigir a los usuarios a la versión de idioma principal del artículo, configure reglas de redireccionamiento para los idiomas eliminados:

  1. Vaya a Configuración ()> Sitio de la base de conocimientos > Reglas de redireccionamiento de artículos en el portal de la base de conocimientos.

  2. Haga clic en Nuevo redireccionamiento para agregar una nueva regla de redireccionamiento.

    Aparecerá el panel Nueva regla de redireccionamiento .

  3. Elija Reemplazar con en la sección Tipo de redireccionamiento .

  4. En la ruta de origen, escriba /docs/<language_code> (por ejemplo, para francés, /docs/fr /docs/es para español, /docs/de para alemán).

  5. En la opción Reemplazar texto, escriba / para redirigir todos los enlaces de artículos específicos del idioma al idioma principal.

  6. Haga clic en Crear para guardar la regla.

    Repita el proceso para cada idioma eliminado. Una vez que se aplican estas reglas de redirección, cualquier intento de acceder a un artículo de idioma eliminado redirigirá automáticamente a los usuarios a la versión del idioma principal, evitando errores 404 incluso si los enlaces están marcados.

Creating a new redirect rule with source path and replace text fields filled.


Preguntas frecuentes

¿Qué son los enlaces muertos?

Los enlaces muertos, o enlaces rotos, son hipervínculos que ya no funcionan debido a problemas como cambios de URL, URL incorrectas o artículos restringidos/privados. Por lo general, dan como resultado una página de error 404.a

¿Qué es un slug de artículo?

Un slug es la parte de una URL que identifica de forma única un artículo/página específica. Viene después de la / URL raíz de tu proyecto.

Ejemplo:
URL del artículo: https://docs.document360.com/docs/why-did-we-build-document360

:/why-did-we-build-document360

¿Cuántas reglas de redireccionamiento puedo configurar en un proyecto?

Puedes configurar un máximo de 10.000 reglas de redireccionamiento por proyecto. Si superas el límite, ponte en contacto con nuestro equipo de soporte.

¿Hay límites para la función de reglas de redireccionamiento de importación?

Puede importar hasta 1.000 reglas de redireccionamiento por día y usar la función de importación hasta cinco veces por día. Si superas el límite, ponte en contacto con nuestro equipo de soporte.

¿Por qué veo el error "El sitio de KB se redirige demasiadas veces cuando se accede"?

Este error se produce debido a un bucle de redireccionamiento, a menudo causado por la configuración de la URL del sitio de la base de conocimiento de Document360 como URL de inicio de sesión para la autenticación JWT. Asegúrese de que la URL de inicio de sesión para la autenticación JWT no sea la misma que la URL del sitio de Document360 KB. Utilice una página de autenticación dedicada como URL de inicio de sesión para evitar bucles de redireccionamiento y resolver el error.

¿Cómo podemos abordar el problema de los errores 404 cuando interrumpimos las funcionalidades que conducen a enlaces entrantes de fuentes que no podemos controlar?

En el caso de las funciones descontinuadas, para administrar los errores 404 de manera eficaz, cree un artículo estándar que informe a los usuarios sobre la interrupción de una funcionalidad, que se puede usar para redirigir artículos relevantes.

Para múltiples funcionalidades descontinuadas, considere establecer una página centralizada que consolide toda la información relacionada, asegurando que los usuarios puedan acceder fácilmente a las actualizaciones y reduciendo la aparición de enlaces muertos.

¿Cómo puedo redirigir un artículo de una página a otra utilizando JavaScript personalizado?

Para redirigir un artículo de una página a otra utilizando JavaScript personalizado, siga los pasos que se indican a continuación:

  1. Vaya a Configuración () > Sitio de la base de conocimientos > Personalizar el sitio en el portal de la base de conocimientos.

  2. Haz clic en CSS y JavaScript personalizados.

  3. Pegue el siguiente código en la pestaña JavaScript :

    $(document).ready(function() {
      if(window.location.href=="source URL") {
        window.location.replace("destination URL");
      }
    });
    
  4. Reemplace la URL de origen y la URL de destino en el código.

  5. Haga clic en Guardar.

¿Cómo escribo una regla de redireccionamiento para reemplazar el nombre del espacio de trabajo en la dirección URL?

Puede utilizar reglas de redireccionamiento al migrar de una plataforma diferente a Document360.

  • Estructura de URL antigua: https://docs.document360.com/{oldworkspace}/section/page

  • Nueva estructura de URL: https://docs.document360.com/{newworkspace}/section/page

El mismo dominio debe estar asignado a ambas plataformas para que la redirección funcione. Por ejemplo
Si el área de trabajo antigua es v1 y la nueva es v2:

Fuente

Destino

Regla

/v1

/

Termina con

/v1/

/v2

reemplazarcon

Esta regla garantiza que todas las solicitudes que apunten al área de trabajo anterior v1 se redirijan al nuevo área de trabajo v2.

¿Cómo puedo redirigir la URL de un artículo/categoría específica a la página de inicio de mi documentación?

Para redirigir una URL específica a la página de inicio de mi documentación, cambie la URL de destino como '/'.
Por ejemplo, si desea redirigir la URL a , establezca la URL de origen como /docs/welcome y la URL de destino como '/' en la regla de redirección de reemplazo por. https://docs.radixdlt.com https://docs.radixdlt.com/docs/welcome