Plans supporting the use of custom domain for knowledge base site
Professional | Business | Enterprise |
---|---|---|
El servidor web HTTP Apache , también conocido como servidor Apache, es un servidor web gratuito y de código abierto. Apache es muy flexible y personalizable. Puede habilitar o deshabilitar fácilmente varias funcionalidades.
NOTA
Reemplace el dominio de ejemplo por el dominio o dominio personalizado proporcionado por document360.
Ejemplo de dominio representado mediante
example.document360.io
Ruta de acceso de subcarpeta/subdirectorio (/v1) representada como
example.document360.io/v1
Subfolder/subdirectorio ruta de la página de inicio (/help) representada como
example.document360.io/help
Configuración de una ruta de subcarpeta
Asegúrese de que los siguientes módulos de servidor Apache estén habilitados. Estos módulos forman parte de la instalación del servidor Apache.
•proxy
• proxy_http
•Encabezados
•sustituto
• proxy_html
Ejecute el siguiente comando bash para habilitar los módulos:
sudo a2enmod proxy proxy_http headers substitute proxy_html
Página principal
Configure los siguientes bloques de ubicación de configuración de host virtual.
Por ejemplo
Bloque de ubicación : proxy de todas las solicitudes en las que la ruta comienza desde "/help".
Este bloque redirigirá las solicitudes para la página de inicio.
<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>
Bloque de redireccionamiento para corregir los enlaces de vista previa del artículo para el alojamiento de subcarpetas
Los vínculos de vista previa del artículo en el portal de Document360 contienen el espacio de trabajo y el slug de idioma en la dirección URL.
Por ejemplo
URL del artículo:
docs.example.com/getting-started
Vista previa de los vínculos en el portal de la base de conocimientos:
docs.example.com/v1/en/getting-started
Puede agregar un bloque de ubicación más para manejar /v1/en
la ruta, (o) tener un redireccionamiento establecido desde /v1/en
a /
.
Consulte el fragmento de código a continuación para configurar la redirección:
RewriteEngine on
RewriteRule ^v1/en$ / [R=301,L,NC]
Debe instalar el rewrite
módulo para que la redirección funcione. Utilice el siguiente código para instalar el rewrite
módulo.
sudo a2enmod rewrite
Páginas de artículos/categorías
Configure los siguientes bloques de ubicación de configuración de host virtual.
Por ejemplo
Bloque de ubicación : proxy de todas las solicitudes donde la ruta comienza desde "/help/"
Este bloque representará las solicitudes de proxy para todas las páginas de artículos/categorías.
<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>
Reinicie el servidor Apache
Por ejemplo, si está utilizando Nginx en Linux, utilice el comando
$ sudo systemctl restart nginx
NOTA
Si se encuentra en KB Site 2.0 y desea alojar su base de conocimientos como una subcarpeta, debe definir la ruta de la subcarpeta, así como la ruta de la API del sitio.
Generación de mapas del sitio
NOTA
Reemplace el dominio de ejemplo por el dominio o dominio personalizado proporcionado por document360.
Ejemplo de dominio representado mediante
example.document360.io
El prefijo del mapa del sitio sigue siendo el mismo, excepto por el código de idioma (en, fr, de, etc.)
example.document360.io/sitemap.xml.en
<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 que haya configurado correctamente el servidor web, 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
yexample.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.io
hastaexample.com/docs
, póngase en contacto con nosotros en support@document360.com.