Alojar tu base de conocimientos de Document360 en una subcarpeta en Apache, como example.com/docs, requiere habilitar módulos de Apache y configurar reglas de proxy y redirección. Este artículo trata sobre cómo habilitar los módulos requeridos, enrutar la página principal, las páginas de artículos y categorías, y la ruta de la API del sitio, la generación de mapas del sitio y la gestión de la redirección de URL para evitar contenido duplicado en los motores de búsqueda.
Sustituye el dominio de ejemplo a lo largo de este artículo por tu propio dominio proporcionado por Document360 o dominio personalizado. Por ejemplo, example.document360.io representa tu dominio, example.document360.io/v1 representa la ruta de una subcarpeta de espacio de trabajo y example.document360.io/help representa la ruta de la página principal de una subcarpeta.
Antes de que empieces
El alojamiento de subcarpetas solo funciona cuando tanto la ruta de subcarpeta (por ejemplo, /docs o /help) como la ruta de la API del sitio (por ejemplo, /api) están definidas en Document360, con la configuración correspondiente en tu servidor.
Asegúrate de que los siguientes módulos de Apache estén habilitados — estos forman parte de la instalación estándar de Apache:
proxyproxy_httpheaderssubstituteproxy_html
Habilitalos con:
sudo a2enmod proxy proxy_http headers substitute proxy_html
Cómo configurar la página principal
Configura el siguiente bloque de ubicación del Host Virtual para que proxy las solicitudes de la página principal, donde la ruta comienza con /help:
<Location /help>
ProxyPreserveHost off
RequestHeader set Host example.document360.io
RequestHeader set requested-by proxy
RequestHeader unset Accept-Encoding
ProxyPass https://example.document360.io/v1
ProxyPassReverse https://example.document360.io/v1
AddOutputFilterByType SUBSTITUTE text/html
substitute 's|href="/docs|href="/help|ni'
substitute 's|href="/v1/docs|href="/help|ni'
substitute 's|href="https://example.document360.io/docs|href="https://docs.example.com/help|ni'
</Location>
Corrección de enlaces de vista previa de artículos para alojamiento de subcarpetas
Los enlaces de vista previa del artículo en el portal Document360 incluyen el espacio de trabajo y el lenguaje en la URL. Por ejemplo, la URL del artículo en activo podría ser docs.example.com/getting-started, mientras que el enlace de vista previa del portal es docs.example.com/v1/en/getting-started. Puedes añadir un bloque de ubicación para gestionar el /v1/en camino, o establecer una redirección desde /v1/en a:/
RewriteEngine on
RewriteRule ^v1/en$ / [R=301,L,NC]
Esta redirección requiere el rewrite módulo:
sudo a2enmod rewrite
Cómo configurar páginas de artículos y categorías
Añadir los siguientes bloques de ubicación al mismo archivo de configuración de Apache Virtual Host para proxy artículo, categoría y solicitudes de API:
<Location /help/>
ProxyPreserveHost off
RequestHeader set Host example.document360.io
RequestHeader set requested-by proxy
ProxyPass https://example.document360.io/docs/
ProxyPassReverse https://example.document360.io/docs/
AddOutputFilterByType SUBSTITUTE text/html
substitute 's|href="/docs|href="/help|ni'
substitute 's|href="/v1/docs|href="/help|ni'
substitute 's|href="https://example.document360.io/docs|href="https://docs.example.com/help|ni'
</Location>
<Location /api>
ProxyPreserveHost off
RequestHeader set Host example.document360.io
RequestHeader set requested-by proxy
RequestHeader unset Accept-Encoding
ProxyPass https://example.document360.io/api
ProxyPassReverse https://example.document360.io/api
AddOutputFilterByType SUBSTITUTE application/json
substitute 's|href="/docs/|href="/help/|ni'
substitute 's|href="/v1/docs/|href="/help/|ni'
substitute 's|href="https://example.document360.io/docs/|href="https://docs.example.com/help/|ni'
</Location>
Reinicia el servidor Apache una vez configurado:
sudo systemctl restart apache2
Sustituye /docs y /api con los valores exactos configurados en ruta de subcarpeta y ruta de API del sitio en el portal Document360.
Cómo configurar la generación de mapas del sitio
El prefijo del sitemap se mantiene igual excepto por el código del idioma (en, fr, de, etc.).
<Location /sitemap.xml.en>
RequestHeader set Host example.document360.io
RequestHeader set requested-by proxy
ProxyPass https://example.document360.io/sitemap.xml.en
ProxyPassReverse https://example.document360.io/sitemap.xml.en
</Location>
¿Qué pasa después?
Una vez configurado Apache, tu sitio de la base de conocimientos estará activo en tu subcarpeta personalizada. La URL existente de Document360 sigue atendiendo solicitudes también — por ejemplo, ambas example.document360.io y example.com/docs apuntará a tu sitio de base de conocimiento. Esto provoca contenido duplicado en motores de búsqueda como Google y Bing.
Para evitar contenido duplicado, activa el interruptor Restringir acceso a subdominio en Configuración > Sitio de la base de conocimientos > Dominio personalizado personalizado > Alojamiento de subcarpetas. Asegúrate de que un dominio canónico esté configurado antes de habilitarlo: una vez habilitado, tu subdominio Document360 redirige automáticamente a tu dominio canónico.
Mejores prácticas
- Activa los cinco módulos Apache requeridos (
proxy,proxy_http,headers,substitute,proxy_html) antes de configurar los bloques de ubicación, o proxy y reescritura no funcionará. - Mantén la ruta de subcarpetas y la ruta de la API del sitio idénticas entre el portal Document360 y tu configuración de Apache para evitar enrutamientos rotos.
- Utiliza las
substitutereglas de forma constante en la página principal, artículo/categoría y bloques de ubicación de la API para evitar enlaces mixtos/docs/helpy en el sitio en vivo. - Configura la
/v1/enredirección para los enlaces de vista previa del artículo con antelación, ya que los enlaces de vista previa desajustados pueden causar confusión para los autores de contenido.