Le bloc Catégories de la base de connaissances permet de faire apparaître des catégories de votre documentation directement sur la page d’accueil sous forme de cartes visuelles. Plutôt que d’attendre que les lecteurs naviguent dans l’arbre de catégories pour trouver ce dont ils ont besoin, ce bloc met en avant vos sections les plus importantes, offrant aux lecteurs un aperçu visuel et cliquable de ce que contient la base de connaissances dès qu’ils arrivent sur la page d’accueil.
Le bloc catégories de la base de connaissances ne prend en charge que les catégories - pas les articles individuels. Lorsqu’une catégorie est sélectionnée, le premier article de cette catégorie est affiché par défaut. Une catégorie n’apparaîtra dans le bloc que si elle contient au moins un article publié.
Quand utiliser le bloc catégories de la base de connaissances
- Grandes bases de connaissances – Lorsque votre documentation comporte de nombreuses catégories, mettre en avant les plus importantes comme des cartes de page d’accueil aide les lecteurs à naviguer directement sans chercher dans l’arbre des catégories.
- Types d’audience multiples - Utilisez des cartes séparées pour « Démarrer », « Référence API » et « Dépannage » pour diriger immédiatement différents types de lecteurs vers la bonne section.
- Navigation avec consentement - Contrairement aux liens statiques ou au HTML personnalisé, ce bloc respecte les permissions d’accès des lecteurs. Les lecteurs ne voient que les cartes de catégorie auxquelles ils ont la permission d’accéder, évitant ainsi les erreurs 404 pour le contenu restreint.
- Remplacer une introduction de style table des matières - Au lieu d’écrire une liste de texte des sections principales, laissez les cartes de catégories faire le travail visuellement.
Comment ajouter un bloc de catégories dans la base de connaissances
- Naviguez dans () dans la barre de navigation de gauche du portail de la base de connaissances.
- Dans le panneau de navigation de gauche, allez vers Knowledge base site > Personnalisation du site.
- Cliquez sur le bouton Personnaliser le site .
- Dans le menu déroulant de gauche, sélectionnez Page d’accueil . La section Corps affiche la liste des blocs corporels.
- Cliquez sur Ajouter la section et sélectionnez les catégories de la base de connaissances. Le bloc est ajouté à la liste.
- Cliquez sur le bloc catégories de la base de connaissances pour modifier le titre de la section et la couleur générale des icônes.
- Cliquez sur Ajouter un élément pour ajouter des cartes de catégorie au bloc.
- Sélectionnez les catégories souhaitées dans votre base de connaissances. Utilisez l’option Filtrer la catégorie pour rechercher par nom.
- Utilisez l’icône de Réordre () pour réarranger les éléments. Les icônes de Réordre et de Masquer () apparaissent lorsque vous survolez un bloc de corps.
Comment configurer les éléments de catégorie
Cliquez sur n’importe quel élément de catégorie pour modifier les attributs suivants :
| Attribut | Ce que vous pouvez configurer |
|---|---|
| Icône | Cliquez sur Modifier pour sélectionner une icône Document360 ou Font Awesome depuis l’onglet Icônes, ou téléchargez/saisissez l’URL d’une image personnalisée dans l’onglet Image |
| Titre | Entrez un titre d’affichage pour la fiche catégorie |
| Couleur des icônes | Choisissez une couleur pour l’icône |
| Texte du paragraphe | Ajoutez une brève description en utilisant la syntaxe Markdown |
| Couleur du texte | Sélectionnez la couleur du texte pour le titre et le paragraphe |
Utilisez des fichiers image en dimension carrée (par exemple, 30×30px ou 50×50px) pour des icônes personnalisées afin d’éviter les distorsions.
Comment sauvegarder et publier
- Utilisez le bouton Aperçu à droite pour revoir vos modifications.
- Cliquez sur Enregistrer pour sauvegarder vos modifications.
- Cliquez sur Publier pour faire des changements en direct...
Meilleures pratiques
- Mettez en avant vos catégories les plus visitées – vérifiez vos analyses pour identifier celles que les lecteurs consultent le plus, et montrez-les en premier.
- Gardez les descriptions des cartes courtes – une phrase par carte suffit. Des paragraphes plus longs encombrent la mise en page des cartes.
- Utilisez des styles d’icônes cohérents – mélanger les types d’icônes entre les cartes dans le même bloc semble incohérent. Tenez-vous aux icônes Document360, Font Awesome ou images personnalisées.
- Commandez les cartes par parcours de lecteur – mettez les catégories fondamentales (Démarrage, Installation) avant les avancées (Référence API, Dépannage) pour guider naturellement les nouveaux lecteurs.
- Utilisez ce bloc au lieu du HTML personnalisé pour les liens de catégorie – le bloc intégré respecte les permissions du lecteur ; Les liens statiques dans un HTML personnalisé ne le font pas.
FAQ
Comment supprimer le bloc des catégories de la base de connaissances ?
Naviguez vers {{variable. Settings}} () > {{variable. Site de la base de connaissances}} > Personnalisation du site et cliquez sur Personnaliser le site. Dans le menu déroulant de gauche, sélectionnez Page d’accueil . Sélectionnez le bloc de catégories de la base de connaissances souhaité dans la section Corps. Cliquez sur Supprimer () sous la barre de navigation, puis cliquez sur Oui dans l’invite de confirmation Supprimer. Pour supprimer un élément de catégorie spécifique, sélectionnez cet élément et suivez les mêmes étapes. Cliquez sur Enregistrer puis sur Publier pour appliquer les modifications.
Pourquoi ne puis-je pas modifier le titre des catégories dans le bloc des catégories de la base de connaissances ?
Les cartes de catégorie de ce bloc sont directement liées aux catégories de votre section Documentation — leurs titres reflètent les noms réels des catégories et ne peuvent pas être modifiés à partir du bloc. Seul le champ de texte Paragraphe est modifiable ici.
Pour renommer une catégorie, naviguez jusqu’à {{variable. Documentation}} () dans la barre de navigation de gauche. Dans le volet Catégories et articles, localisez la catégorie, cliquez sur l’icône Plus () à côté et sélectionnez Renommer, ou double-cliquez sur le nom de la catégorie pour la modifier en ligne. Appuyez sur Entrée pour enregistrer.
Y a-t-il une limite au nombre de blocs de catégories que je peux ajouter à la page d’accueil ?
Non — il n’y a pas de limite au nombre de blocs de catégories de la base de connaissances que vous pouvez ajouter à la page d’accueil.
Puis-je montrer les cartes de catégorie uniquement aux lecteurs qui y ont accès ?
Oui. Le bloc des catégories de la base de connaissances respecte automatiquement les autorisations des lecteurs — les lecteurs ne voient que les cartes de catégorie auxquelles ils sont autorisés à accéder. C’est pourquoi ce bloc est recommandé plutôt que des liens statiques ou du HTML personnalisé pour faire apparaître des catégories sur la page d’accueil. Lorsque des catégories sont ajoutées via du HTML personnalisé ou des liens codés en dur, ces liens apparaissent à tous les lecteurs, indépendamment des permissions, ce qui peut entraîner 404 erreurs pour les lecteurs sans accédre.