Planes que admiten esta función: Professional Business Enterprise
¿Qué es el alojamiento de subcarpetas?
El alojamiento en subcarpetas es el método de organizar y mostrar contenido en un sitio web utilizando carpetas bajo el dominio principal (raíz). Una subcarpeta (también llamada subdirectorio) aparece después del dominio raíz en una URL y se utiliza para estructurar el contenido de forma lógica.
Por ejemplo, el dominio raíz de Document360 es document360.com. Por ejemplo, una URL de ruta de subcarpeta o subdirectorio podría ser document360.com/docs/.
La mayoría de las empresas alojan su documentación en una subcarpeta/subdirectorio en el dominio de su sitio web.
Por ejemplo: example.com/docs, example.com/support, etc.
Esto se debe a que alojar una base de conocimiento en un subdirectorio/subcarpeta de un sitio web (example.com/docs) en lugar de un subdominio (docs.example.com) es mejor para la Optimización para Motores de Búsqueda (SEO).
NOTA
El alojamiento de subcarpetas/subdirectorios puede activarse para dominios proporcionados por Document360 y dominios personalizados mapeados.
Habilitar el alojamiento de subcarpetas
Para habilitar la subcarpeta que aloja tu proyecto,
Navega a Configuración () > Sitio de la base de conocimientos en la barra de navegación izquierda del Portal de la base de conocimientos.
En el panel de navegación izquierdo, navega a la pestaña Dominio personalizado > Alojamiento de subcarpetas .
Por defecto, la ruta de la subcarpeta está configurada como /docs.
Activa el interruptor junto a "La base de conocimientos está alojada como una subcarpeta."
Cuando se active el interruptor, la vista previa pública de los artículos será visible. Esto también evita la inserción del slug del espacio de trabajo al insertar enlaces en artículos.
Rutas de subcarpetas personalizadas
También puedes configurar tu base de conocimientos en rutas de subcarpetas o subdirectorios distintas /docsa .
Por ejemplo, /help, /support, etc.
Navega a Configuración () > Sitio de la base de conocimientos en la barra de navegación izquierda del Portal de la base de conocimientos.
En el panel de navegación izquierdo, navega a la pestaña Dominio personalizado. Alojamiento de subcarpetas
Por defecto, la ruta de la subcarpeta está configurada como /docs.
Borra el campo de ruta de subcarpeta e introduce tu ruta de subcarpeta personalizada (por ejemplo,
/help).Haz clic en el Actualizar a la derecha.
Esta nueva subcarpeta personalizada solo funcionará si la opción de alojamiento de la subcarpeta está activada en tu proyecto.
Al configurar otras rutas, añade los lenguajes asociados a cada espacio de trabajo en tu proyecto. Esta configuración varía según los diferentes servidores web.
NOTA
Para proyectos configurados con dominio personalizado y alojamiento de subcarpetas, la opción de vista previa de artículos aún no está soportada.
Si has definido una ruta personalizada para las subcarpetas, no olvides configurar tu servidor para que haga proxy requests para esta ruta. Puedes consultar los artículos específicos de servidores de la plataforma para orientarte.
Rutas personalizadas de API para sitios
Para tu información (para que lo sepas)
La función de rutas de API personalizadas solo está disponible en proyectos de KB Site 2.0. Para migrar del sitio KB 1.0 al sitio KB 2.0, lee el artículo sobre la migración del sitio KB 2.0.
Por defecto, la ruta de la API del sitio está establecida en /api. También puedes personalizar la ruta de la API del sitio desde la pestaña de alojamiento de subcarpetas en la configuración personalizada del dominio.
Por ejemplo, /docs-api, /api-docs, etc.
Después de establecer la ruta de la API del sitio, también debes configurar un bloque de ubicación coincidente en tu servidor web (como /api, /docs-api, etc.).
Asegúrate de que el valor introducido aquí coincide exactamente con la ruta configurada en la configuración de proxy inverso de tu servidor.
Consulta la guía del servidor correspondiente para ejemplos de configuración:
PRECAUCIÓN
Para proyectos de KB Site 2.0 , el alojamiento de subcarpetas funcionará solo cuando tanto la ruta de subcarpeta como la ruta de la API del sitio estén definidas.
Navega a Configuración () > Sitio de la base de conocimientos en la barra de navegación izquierda del Portal de la base de conocimientos.
En el panel de navegación izquierdo, navega a la pestaña Dominio personalizado > Alojamiento de subcarpetas .
Por defecto, la ruta de la API del sitio está configurada en /api.
Borra el campo de ruta de la API del sitio e introduce la ruta personalizada de la API del sitio (por ejemplo,
/docs-api).Haz clic en el Actualizar a la derecha.
Esta nueva ruta personalizada de API solo funcionará si la configuración de alojamiento de subcarpetas está activada en tu proyecto.
NOTA
La ruta de la API del sitio personalizado no es la ruta para la documentación de la API.
Servidores web
Aquí tienes algunos de los servidores web más utilizados
Apache HTTP server
Servidor Nginx
ASP.NET Servidor central
Microsoft - Servidor IIS
Servidor OpenResty
Servidor LiteSpeed
Servidor Cloudflare
NOTA
¿Qué es un servidor web?
Un servidor web almacena y entrega el contenido de un sitio web —como texto, imágenes, vídeo y datos de aplicaciones— a los clientes que lo solicitan. El tipo de cliente más común es un programa de navegador web.
Configuración obligatoria de rutas API para el sitio KB 2.0
Si usas KB 2.0 y alojas tu base de conocimientos en una subcarpeta, es obligatorio añadir una configuración de proxy inverso para la ruta de la API del sitio (por ejemplo, /api) en la configuración de tu servidor.
Sin esta configuración, puede encontrarse con errores de redirección o comportamientos de API dañados.
Visita el artículo correspondiente sobre el servidor para las instrucciones de configuración:
¿Qué ocurre después?
Una vez que el servidor web esté configurado correctamente, tu sitio de la base de conocimientos estará activo en tu subcarpeta/subdirectorio personalizado. Sin embargo, la URL existente de tu proyecto servirá las solicitudes.
Por ejemplo, example.document360.io y example.com/docs (si /docs es la ruta de tu carpeta) apuntará al sitio de la Base de conocimientos.
Esto provocará contenido duplicado en los motores de búsqueda (Google, Bing, etc.). Para ello, tendrás que habilitar una redirección de URL.
NOTA
Para habilitar la redirección desde
example.document360.ioaexample.com/docs, por favor contáctenos en support@document360.com.
Solución de problemas
La URL sigue mostrando '/docs' a pesar de que el alojamiento de subcarpetas está deshabilitado
Por defecto, la documentación está alojada bajo la /docs subcarpeta, y esta ruta permanece visible en la URL independientemente de si la configuración de alojamiento de la subcarpeta está activada o desactivada.
Pasos para resolver:
Para cambiar el camino,
Crea una nueva subcarpeta en tu proyecto.
Activa la configuración de alojamiento de subcarpetas para la subcarpeta recién creada.
Completar la configuración requerida para aplicar la ruta de URL personalizada.
Error 404 debido a '/docs' duplicado en la URL canónica
Cuando tu sitio está alojado en una /docs subcarpeta, añadir /docs la URL canónica hace que aparezca dos veces en la URL final (por ejemplo, nombre del artículo/docs/docs/), lo que lleva a un error 404.
Pasos para resolver:
Para solucionar el problema, actualiza la URL canónica para incluir solo el dominio sin la
/docsruta. Por ejemplo, establece la URL canónica como:https://yourdomain.com/article-nameEsto garantiza que la
/docssubcarpeta se añada solo una vez, manteniendo la estructura correcta de URLs y evitando errores 404.
Preguntas más frecuentes
¿Qué es una URL canónica?
Una URL canónica es el enlace oficial que indica a los motores de búsqueda qué versión de una página indexar y mostrar en los resultados cuando hay múltiples URLs para el mismo contenido. Esto ayuda a prevenir problemas de contenido duplicado y garantiza que la URL preferida esté correctamente posicionada en los resultados de búsqueda.
Por ejemplo:
Si tu página es accesible a través de múltiples URLs, como:
https://example.com/pagehttps://www.example.com/pagehttps://example.com/page?utm=123
Puedes establecer una de ellas (por ejemplo, https://www.example.com/page) como la URL canónica para señalar a los motores de búsqueda que la prioricen.
¿Cómo puedo configurar la URL canónica en Document360?
Puedes usar la configuración de dominio canónico para reemplazar globalmente el subdominio del proyecto por el dominio especificado para las URLs canónicas en todos los artículos. Esto es especialmente útil si quieres enviar una señal a los motores de búsqueda para que indexen tu dominio personalizado (por ejemplo, www.yourdomain.com) en lugar del dominio Document360.
Para cambiar la URL canónica globalmente, sigue los pasos siguientes:
Navega a Configuración () > Sitio de la base de conocimientos > pestaña de Alojamiento de subcarpetas Dominio personalizado en el portal de la Base de conocimientos.
En la pestaña Alojamiento de subcarpetas de Subcarpetas, localiza la opción de dominio canónico .
Introduce el dominio que deseas (por ejemplo,
https://www.yourdomain.com).Haz clic Salvar para guardar tus cambios.