Hébergement de Document360 dans un sous-répertoire

Plans prenant en charge l’hébergement de Document360 dans un sous-répertoire

Qu’est-ce que l’hébergement de sous-dossiers ?

L’hébergement de sous-dossiers est une méthode d’organisation et d’affichage du contenu d’un site Web à l’aide de dossiers sous le domaine principal (racine). Un sous-dossier (également appelé sous-répertoire) apparaît après le domaine racine dans une URL et est utilisé pour structurer le contenu de manière logique.
Par exemple, le domaine racine de Document360 est document360.com. Par conséquent, l’URL d’un chemin d’accès à un sous-dossier/sous-répertoire peut être document360.com/docs/.

La plupart des entreprises hébergent leur documentation dans un sous-dossier/sous-répertoire sur le domaine de leur site Web.
Par exemple : example.com/docs, example.com/support, etc.

En effet, l’hébergement d’une base de connaissances sur un sous-répertoire/sous-dossier d’un site Web (example.com/docs) plutôt que sur un sous-domaine (docs.example.com) est meilleur pour l’optimisation des moteurs de recherche (SEO).

NOTE

L’hébergement de sous-dossiers/sous-répertoires peut être activé pour les domaines fournis par Document360 et les domaines personnalisés mappés.

Activation de l’hébergement de sous-dossiers

Pour activer l’hébergement de sous-dossiers pour votre projet,

1. Accédez à Settings () dans la barre de navigation de gauche du Knowledge base portal.

2. Dans le volet de navigation de gauche, accédez à Knowledge base site > Custom domain > Subfolder hosting onglet.

   Par défaut, le chemin d’accès au sous-dossier est défini sur /docs.

3. Activez le bouton à côté de « La base de connaissances est hébergée en tant que sous-dossier ».
   Lorsque la bascule est activée, l’aperçu public des articles sera visible. Cela empêche également l’insertion du slug de l’espace de travail lors de l’insertion de liens dans les articles.

Chemins d’accès aux sous-dossiers personnalisés

Vous pouvez également configurer votre base de connaissances sur des chemins de sous-dossier/sous-répertoire autres que /docs.

Par exemple, /help, , /supportetc.

1. Accédez à Settings () dans la barre de navigation de gauche de la Knowledge base portal.

2. Dans le volet de navigation de gauche, accédez à Knowledge base site > Custom domain > Subfolder hosting onglet.

   Par défaut, le chemin d’accès au sous-dossier est défini sur /docs.

3. Effacez le champ Chemin du sous-dossier et entrez le chemin d’accès de votre sous-dossier personnalisé (par exemple, /help).

4. Cliquez sur le bouton Update à droite.

   Ce nouveau sous-dossier personnalisé ne fonctionnera que si le paramètre d’hébergement du sous-dossier est activé dans votre projet.

Lors de la configuration d’autres chemins, ajoutez les langues associées à chaque espace de travail de votre projet. Cette configuration varie en fonction des différents serveurs web.

NOTE

Pour les projets configurés avec un hébergement de domaine et de sous-dossier personnalisé, l’option d’aperçu de l’article n’est pas encore prise en charge.

Chemins d’accès à l’API du site personnalisé

Pour votre information (pour info)

La fonctionnalité Chemins d’accès à l’API de site personnalisé n’est disponible que dans les projets de site KB 2.0. Pour migrer du site de la base de connaissances 1.0 vers le site de la base de connaissances 2.0, consultez l’article sur KB site 2.0 migration.

Par défaut, le chemin d’accès à l’API du site est défini sur /api. Vous pouvez également personnaliser le chemin d’accès à l’API du site à partir de l’onglet Hébergement du sous-dossier dans les paramètres du domaine personnalisé.

Par exemple, /docs-api, , /api-docsetc.

PRUDENCE

Pour les projets de site de la base de connaissances 2.0 , l’hébergement de sous-dossiers ne fonctionne que lorsque le chemin d’accès au sous-dossier et le chemin d’accès à l’API du site ont été définis.

1. Accédez à Settings () dans la barre de navigation de gauche de la Knowledge base portal.

2. Dans le volet de navigation de gauche, accédez à Knowledge base site > Custom domain > Subfolder hosting onglet.

   Par défaut, le chemin d’accès à l’API du site est défini sur /api.

3. Effacez le champ Chemin d’accès à l’API du site et entrez le chemin d’accès à l’API de votre site personnalisé (par exemple, /docs-api).

4. Cliquez sur le bouton Update à droite.

   Ce nouveau chemin d’accès à l’API du site personnalisé ne fonctionnera que si le paramètre d’hébergement de sous-dossiers est activé dans votre projet.

NOTE

Le chemin d’accès à l’API du site personnalisé n’est pas le chemin d’accès à la documentation de l’API.

Serveurs Web

Voici quelques-uns des serveurs Web les plus couramment utilisés

• Serveur HTTP Apache

• Serveur Nginx

• ASP.NET Serveur central

• Microsoft - Serveur IIS

• Serveur OpenResty

• Serveur LiteSpeed

• Serveur Cloudflare

NOTE

Qu’est-ce qu’un serveur web ?
Un serveur Web stocke et fournit le contenu d’un site Web, tel que du texte, des images, des vidéos et des données d’application, aux clients qui en font la demande. Le type de client le plus courant est un programme de navigateur Web.

Que se passe-t-il ensuite ?

Une fois le serveur Web configuré avec succès, le site de votre base de connaissances sera 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 et example.com/docs (si /docs c’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.

Dépannage

L’URL affiche toujours '/docs' malgré la désactivation de l’hébergement des sous-dossiers

Par défaut, la documentation est hébergée dans le /docs sous-dossier, et ce chemin d’accès reste visible dans l’URL, que le paramètre d’hébergement du sous-dossier soit activé ou désactivé.

Étapes à résoudre :

Pour modifier le chemin,

1. Créez un sous-dossier dans votre projet.

2. Activez le paramètre d’hébergement du sous-dossier pour le sous-dossier nouvellement créé.

3. Effectuez la configuration requise pour appliquer le chemin d’URL personnalisé.

Erreur 404 due à un '/docs' dupliqué dans l’URL canonique

Lorsque votre site est hébergé dans un /docs sous-dossier, l’ajout /docs de l’URL canonique fait apparaître deux fois dans l’URL finale (par exemple, nom-article/docs/docs/), ce qui entraîne une erreur 404.

Étapes à résoudre :

1. Pour résoudre le problème, mettez à jour l’URL canonique pour inclure uniquement le domaine sans le chemin d’accès /docs . Par exemple, définissez l’URL canonique comme suit : https://yourdomain.com/article-name

2. Cela garantit que le sous-dossier n’est /docs ajouté qu’une seule fois, ce qui permet de conserver la structure d’URL correcte et d’éviter les erreurs 404.