Plans supporting the use of custom domain for knowledge base site
Professional | Business | Enterprise |
---|---|---|
Le serveur Web HTTP Apache , également connu sous le nom de serveur Apache, est un serveur Web gratuit et open-source. Apache est très flexible et personnalisable. Vous pouvez facilement activer ou désactiver diverses fonctionnalités.
NOTE
Remplacez l’exemple de domaine par votre domaine fourni par document360/domaine personnalisé.
Exemple de domaine représenté à l’aide de
example.document360.io
Chemin d’accès au sous-dossier/sous-répertoire (/v1) représenté par
example.document360.io/v1
Subfolder/subdirectory home page path (/help) représenté par
example.document360.io/help
Configuration du chemin d’accès à un sous-dossier
Assurez-vous que les modules de serveur Apache suivants sont activés. Ces modules font partie de l’installation du serveur Apache.
•procuration
• proxy_http
•En-têtes
•substituer
• proxy_html
Exécutez la commande bash suivante pour activer les modules :
sudo a2enmod proxy proxy_http headers substitute proxy_html
Page d’accueil
Configurez les blocs d’emplacement de configuration de l’hôte virtuel suivants.
Par exemple
Bloc d’emplacement - Proxy toutes les demandes dont le chemin commence à partir de « /help ».
Ce bloc permettra de proxy les requêtes pour la page d’accueil.
<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>
Bloc de redirection pour corriger les liens d’aperçu de l’article pour l’hébergement de sous-dossiers
Les liens d’aperçu de l’article dans le portail Document360 contiennent l’espace de travail et le slug de langue dans l’URL.
Par exemple
URL de l’article :
docs.example.com/getting-started
Liens d’aperçu dans le portail de la base de connaissances :
docs.example.com/v1/en/getting-started
Vous pouvez soit ajouter un bloc d’emplacement supplémentaire pour gérer /v1/en
le chemin, (ou) avoir une redirection définie de /v1/en
à /
.
Veuillez vous référer à l’extrait de code ci-dessous pour définir la redirection :
RewriteEngine on
RewriteRule ^v1/en$ / [R=301,L,NC]
Vous devez installer le rewrite
module pour que la redirection fonctionne. Utilisez le code suivant pour installer le rewrite
module.
sudo a2enmod rewrite
Pages d’articles/catégories
Configurez les blocs d’emplacement de configuration de l’hôte virtuel suivants.
Par exemple
Bloc d’emplacement - Proxy pour toutes les requêtes dont le chemin commence à partir de « /help/ »
Ce blocage permettra de proxy les requêtes pour toutes les pages d’articles/catégories.
<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>
Redémarrer le serveur Apache
Par exemple, si vous utilisez Nginx sous Linux, utilisez la commande
$ sudo systemctl restart nginx
NOTE
Si vous êtes sur KB Site 2.0 et que vous souhaitez héberger votre base de connaissances en tant que sous-dossier, vous devez définir le chemin du sous-dossier ainsi que le chemin de l’API du site.
Génération de sitemap
NOTE
Remplacez l’exemple de domaine par votre domaine fourni par document360/domaine personnalisé.
Exemple de domaine représenté à l’aide de
example.document360.io
Le préfixe du sitemap reste le même, à l’exception du code de langue (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>
Que se passe-t-il ensuite ?
Une fois que vous avez correctement configuré le serveur Web, le site de votre base de connaissances est en ligne dans votre sous-dossier/sous-répertoire personnalisé.
Toutefois, l’URL existante de votre projet servira les demandes.
Par exemple
example.document360.io
etexample.com/docs
(si/docs
est le chemin de votre dossier) pointera vers le site de la base de connaissances.
Cela provoquera du contenu dupliqué dans les moteurs de recherche (Google, Bing, etc.). Pour cela, vous devrez activer une redirection d’URL.
NOTE
Pour activer la redirection de
example.document360.io
àexample.com/docs
, veuillez nous contacter à l’adresse support@document360.com.