Cliquez sur un tag dans la barre latérale et la liste des sujets se filtre automatiquement selon ce tag. Vous pouvez sélectionner autant de tags que vous le souhaitez, et la liste des tags n’affichera que ceux ajoutés aux sujets filtrés, facilitant ainsi la navigation dans de nombreuses documentations.
Vous souhaitez effectuer une recherche ? Il suffit de taper un terme dans la zone de saisie. Les résultats de recherche sont également limités aux tags que vous avez sélectionnés.
Considérations
Les paramètres de site suivants sont nécessaires pour que ce composant fonctionne : tagging enabled (balisage activé) et show filter by tag (afficher le filtre par tag).
Ce composant de thème ne dispose pas actuellement d’une vue mobile.
Cela étant dit, nous travaillons à la création d’une version plus avancée de cette fonctionnalité. Nous ne manquerons pas de vous en informer ici sur Meta lorsqu’elle sera prête !
Ce commit ajoute désormais une vue mobile de base.
Notez que ce n’est pas parfait, car s’il y a beaucoup d’étiquettes, vous devez faire défiler au-dessus d’elles. J’envisage quelques idées pour corriger cela.
Nous utilisons Discourse comme base de connaissances depuis plus de 4 ans et comptons environ 350 publications spécifiques à la base de connaissances, c’est donc très excitant !
Je ne sais pas si cela est possible via un composant de thème, mais existe-t-il un moyen que cette « vue » soit la valeur par défaut lorsqu’une personne ouvre une catégorie ? Ainsi, au lieu d’accéder à : /c/knowledge-base, elle se chargerait automatiquement sous la forme /c/knowledge-base?kb=active ?
Nous avons activé le composant de thème KB et nous l’apprécions beaucoup, mais nous craignons que les utilisateurs ne voient pas la vue KB car ils utilisent le lien /c/knowledge-base qu’ils ont précédemment enregistré dans leurs favoris.
Merci beaucoup pour cela ! Nous avons une catégorie dans notre communauté qui serait parfaite pour appliquer ce composant, mais nous rencontrons un problème : les catégories n’apparaissent pas dans la liste déroulante « kb categories », nous empêchant ainsi de choisir la catégorie à laquelle appliquer le composant. Un conseil ?
Vous pouvez simplement saisir le slug de la catégorie pour la créer. Ce n’est pas extrêmement intuitif. Je n’ai pas réussi à comprendre comment créer des sous-catégories, mais si votre catégorie est au premier niveau, c’est assez facile.
Ok, vraiment pas intuitif. J’ai saisi et « créé » la catégorie, et ça a fonctionné. Mais elle n’apparaît toujours pas comme prévu.
J’ai effectué une installation fraîche de Discourse pour tester, en configurant les deux composants :
(D.I.Y. / diy est la catégorie pour laquelle je souhaite activer la base de connaissances, et elle dispose d’un lien principal spécifique créé avec le composant Liens de navigation principaux personnalisés)
Mais la catégorie D.I.Y. s’affiche avec une vue normale :
Aucune syntaxe spéciale — il suffit de saisir l’identifiant (slug) de la catégorie (sous-catégorie ou non) dans le paramètre du thème kb categories, de rafraîchir votre navigateur, et cela devrait fonctionner.
C’est une limitation des paramètres du thème pour le moment — vous devrez saisir l’identifiant (slug) comme l’a suggéré @Sean_R.
Avez-vous résolu ce problème, @TowerBR ? Avez-vous rafraîchi la page après avoir ajouté la catégorie au paramètre ? Avez-vous cliqué sur le bouton KB ? Désolé pour ces questions simplistes, mais je tente de comprendre ce qui se passe.
Avez-vous activé l’option « Par défaut, utiliser la vue KB » ? Je viens de tester cela sur l’un de mes sites et cela semblait fonctionner avec les sous-catégories.
Étrange, d’accord. Si vous pouvez le reproduire de manière cohérente, faites-le-moi savoir et je regarderai. Je n’ai pas réussi à déclencher ce comportement en utilisant la liste déroulante des sous-catégories.
Oui, je l’avais déjà fait, voyez la capture d’écran du message ci-dessus :
J’ai supprimé le composant « Liens de navigation supérieure personnalisés ». Il s’agit maintenant d’une installation entièrement « propre » :
Oui, et j’ai vidé le cache.
Oui. Lorsque je sélectionne la catégorie via le menu déroulant principal, la page de la catégorie se charge déjà avec /c/diy?kb=active à la fin de l’URL. Lorsque je passe la souris sur le bouton KB, l’URL « normale » s’affiche sans cet « ajout », mais lorsque je clique dessus, rien ne se produit.
Ça arrive à chaque fois. Je peux simplement cliquer sur « KB » ou rafraîchir la page pour que cela se corrige, mais pas lorsque je vais dans la catégorie via le menu déroulant.
C’est génial ! Je viens de l’installer pour jeter un coup d’œil, et je constate qu’il est déjà très utile.
Ce composant de thème semble entrer en conflit avec https://meta.discourse.org/t/knowledge-base-plugin/115288 par @angus. Je peux confirmer que le plugin doit être désinstallé avant d’activer ce composant de thème, sinon voici ce qui se produit lorsque vous consultez une catégorie de base de connaissances. Remarquez la ligne horizontale étrange à côté du menu et le cercle qui tourne.
J’aimerais en savoir plus sur la version avancée et sur vos projets. Voici quelques retours :
bug ? Lorsque vous sélectionnez un tag dans le menu de gauche pour filtrer par ce tag, puis que vous cliquez sur une autre catégorie ou sur « Derniers », etc., lorsque vous cliquez à nouveau sur kb pour revenir à la base de connaissances, vous constaterez que le filtrage par ce tag est toujours actif.
lorsque vous cliquez sur le tag sous un titre, cela vous emmène à la page du tag pour ce tag, et non à une vue filtrée de la base de connaissances comme lorsque vous cliquez sur le tag dans le menu de gauche.
cliquez sur le titre de la catégorie de tags dans le menu de gauche, et vous êtes redirigé vers la vue « Derniers » de la catégorie. Je suggère de ne pas lier cela à un endroit. Le titre de la catégorie ne devrait probablement pas non plus contenir de #, ce qui est distrayant.
il serait pratique de voir le nombre de sujets associés à chaque tag dans le menu de gauche.
il serait pratique de pouvoir trier les sujets de la base de connaissances par ordre alphabétique ou même dans un ordre personnalisé.
La fonctionnalité de ce composant de thème a été remplacée par le plugin Discourse Docs
Lien vers le dépôt
