Planes que admiten el alojamiento de Document360 en un subdirectorio
| Profesional | Negocio | Empresa |
|---|---|---|
¿Qué es el alojamiento de subcarpetas?
El alojamiento de subcarpetas es un método para organizar y mostrar el contenido de 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 lo tanto, la URL de la ruta de una subcarpeta/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 conocimientos 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 de motores de búsqueda (SEO).
NOTA
El alojamiento de subcarpetas/subdirectorios se puede habilitar para los dominios proporcionados por Document360 y los dominios personalizados asignados.
Habilitación del alojamiento de subcarpetas
Para habilitar el alojamiento de subcarpetas para su proyecto,
Vaya a Configuración () en la barra de navegación izquierda de la Portal de la base de conocimientos.
En el panel de navegación izquierdo, vaya a Sitio de la base de conocimientos > Dominio personalizado > Alojamiento de subcarpetas pestaña.
De forma predeterminada, la ruta de acceso de la subcarpeta se establece en /docs.
Activa el botón de alternancia junto a "La base de conocimientos está alojada como una subcarpeta".
Cuando el interruptor está activado, 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.
.png)
Rutas de subcarpeta personalizadas
También puede configurar su base de conocimientos en rutas de subcarpeta/subdirectorio distintas de /docs.
Por ejemplo, /help, /support, etc.
Vaya a Configuración () en la barra de navegación izquierda de la Portal de la base de conocimientos.
En el panel de navegación izquierdo, vaya a Sitio de la base de conocimientos > Dominio personalizado > Alojamiento de subcarpetas pestaña.
De forma predeterminada, la ruta de acceso de la subcarpeta se establece en /docs.
Desactive el campo Ruta de la subcarpeta e introduzca la ruta de la subcarpeta personalizada (por ejemplo,
/help).Haga clic en el botón Actualizar a la derecha.
Esta nueva subcarpeta personalizada solo funcionará si la configuración de alojamiento de subcarpetas está habilitada en su proyecto.
Al configurar otras rutas, agregue los idiomas asociados con cada espacio de trabajo en su proyecto. Esta configuración varía en función de los diferentes servidores web.
NOTA
En el caso de los proyectos configurados con alojamiento personalizado de dominios y subcarpetas, aún no se admite la opción Vista previa del artículo .
.png)
Rutas de acceso de API de sitio personalizadas
Para su información (FYI)
La característica de rutas de acceso de la API de sitio personalizado solo está disponible en proyectos de KB site 2.0. Para migrar del sitio de KB 1.0 al sitio de KB 2.0, lea el artículo sobre KB site 2.0 migration.
De forma predeterminada, la ruta de acceso de la API del sitio se establece en /api. También puede personalizar la ruta de la API del sitio desde la pestaña Alojamiento de subcarpetas en la configuración del dominio personalizado.
Por ejemplo, /docs-api, /api-docs, etc.
CAUTELA
En el caso de los proyectos de KB site 2.0 , el alojamiento de subcarpetas solo funcionará cuando se hayan definido tanto la ruta de acceso de la subcarpeta como la ruta de acceso de la API del sitio.
Vaya a Configuración () en la barra de navegación izquierda de la Portal de la base de conocimientos.
En el panel de navegación izquierdo, vaya a Sitio de la base de conocimientos > Dominio personalizado > Alojamiento de subcarpetas pestaña.
De forma predeterminada, la ruta de acceso de la API del sitio se establece en /api.
Desactive el campo Ruta de acceso de la API del sitio e introduzca la ruta de acceso de la API del sitio personalizada (por ejemplo,
/docs-api).Haga clic en el botón Actualizar a la derecha.
Esta nueva ruta de acceso de la API de sitio personalizado solo funcionará si la configuración de alojamiento de subcarpetas está habilitada en el proyecto.
NOTA
La ruta de acceso de la API del sitio personalizado no es la ruta de acceso de la documentación de la API.
.png)
Servidores web
Estos son algunos de los servidores web más utilizados:
Servidor HTTP Apache
Servidor Nginx
Servidor ASP.NET Core
Microsoft - Servidor IIS
Servidor OpenResty
Servidor LiteSpeed
Servidor de 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 más común de cliente es un programa de navegador web.
¿Qué pasa después?
Una vez que el servidor web se haya configurado correctamente, el sitio de la base de conocimientos estará activo en la subcarpeta/subdirectorio personalizado. Sin embargo, la URL existente de tu proyecto atenderá las solicitudes.
Por ejemplo, example.document360.io y example.com/docs (si /docs es la ruta de la carpeta) apuntará al sitio de la base de conocimientos.
Esto provocará contenido duplicado en los motores de búsqueda (Google, Bing, etc.). Para ello, deberá habilitar una redirección de URL.
NOTA
Para habilitar la redirección desde
example.document360.iohastaexample.com/docs, póngase en contacto con nosotros en support@document360.com.
Solución de problemas
La URL sigue mostrando '/docs' a pesar de que el alojamiento de subcarpetas está deshabilitado
De forma predeterminada, la documentación se aloja en la /docs subcarpeta y esta ruta permanece visible en la dirección URL, independientemente de si la configuración de alojamiento de subcarpetas está activada o desactivada.
Pasos para resolverlo:
Para cambiar la ruta,
Crea una nueva subcarpeta en tu proyecto.
Habilite la configuración de alojamiento de subcarpetas para la subcarpeta recién creada.
Complete la configuración necesaria 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, agregar la URL canónica hace que aparezca dos veces en la URL final (por ejemplo, /docs nombre del artículo/documentos/documentos/), lo que lleva a un error 404.
Pasos para resolverlo:
Para solucionar el problema, actualice la URL canónica para incluir solo el dominio sin la
/docsruta. Por ejemplo, establece la URL canónica de la siguiente manera:https://yourdomain.com/article-nameEsto garantiza que la
/docssubcarpeta se agregue solo una vez, manteniendo la estructura de URL correcta y evitando errores 404.
Preguntas 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 de búsqueda cuando hay varias URL para el mismo contenido. Esto ayuda a evitar problemas de contenido duplicado y garantiza que la URL preferida se clasifique correctamente en los resultados de búsqueda.
Por ejemplo:
Si se puede acceder a tu página a través de varias URL, como las siguientes:
https://example.com/pagehttps://www.example.com/pagehttps://example.com/page?utm=123
Puede establecer uno de ellos (por ejemplo, https://www.example.com/page) como URL canónica para indicar a los motores de búsqueda que la prioricen.
¿Cómo puedo configurar la URL canónica en Document360?
Puede usar la configuración Dominio canónico para reemplazar globalmente el subdominio del proyecto con el dominio especificado para las URL canónicas en todos los artículos. Esto es especialmente útil si desea indicar a los motores de búsqueda que indexen su dominio personalizado (por ejemplo, www.yourdomain.com) en lugar del dominio de Document360.
Para cambiar la URL canónica globalmente, sigue los pasos que se indican a continuación:
Vaya a la pestaña > Sitio de la base de conocimientos > Dominio personalizado > Alojamiento de subcarpetas Configuración () en el portal de la base de conocimientos.
En Alojamiento de subcarpetas pestaña, busque la opción Dominio canónico.
Introduzca el dominio deseado (por ejemplo,
https://www.yourdomain.com).Haga clic en Salvar para guardar los cambios.