Base de connaissances

Merci pour vos retours @tobiaseigen ! J’ai d’autres priorités cette semaine, mais je m’assurerai d’examiner plusieurs de ces points la semaine prochaine.

7 « J'aime »

Autre élément : ce composant de thème n’a aucun sens à côté du composant de thème « Tags populaires », et pour une raison inconnue, le paramètre d’exclusion de catégorie pour ce composant de thème ne semble pas fonctionner pour moi, malgré plusieurs actualisations du navigateur. Je ne sais pas si vous pouvez prendre en compte ce problème dans ce composant de thème… afin que nous puissions toujours utiliser les tags populaires dans d’autres vues et ne pas les afficher ici.

Je ne suis pas trop fier pour révéler comment j’utilise Discourse comme base de connaissances personnelle : sur la capture d’écran ci-dessous, vous pouvez voir comment les tags apparaissent des deux côtés, même avec la catégorie « Tutoriels » définie pour être exclue dans le composant de thème « Tags populaires ».

3 « J'aime »

Tout d’abord, vous devriez être fier. C’est une utilisation experte de Discourse ! Discourse est parfait pour ce genre de choses ! :smiley:

Je vais jeter un coup d’œil avec les autres éléments la semaine prochaine, à un moment donné.

5 « J'aime »

Merci, Justin !

Je viens d’installer cela sur le forum du réseau mondial pour l’autonomisation juridique. Nous disposons d’une catégorie de base de connaissances (KB), avec des sous-catégories à l’intérieur. Chaque sous-catégorie possède ses propres permissions d’accès au niveau du groupe.

C’est plutôt génial de voir que l’activation de ce composant de thème dans la catégorie KB et ses sous-catégories fonctionne ! En fait, cela fonctionne très bien. :rocket:

Deux autres remarques :

  • le menu des étiquettes (tags) ne semble pas fonctionner correctement dans la catégorie KB. Les éléments qui apparaissent dans la liste des sujets des sous-catégories ont clairement des étiquettes, mais le menu des étiquettes est vide, car il n’y a aucun sujet dans la catégorie KB elle-même.
  • il serait très utile d’afficher une liste des sous-catégories dans le menu. Je ne sais pas si cela est techniquement réalisable. Si c’est le cas, peut-être pourrait-on l’afficher juste au-dessus du menu des étiquettes ?
4 « J'aime »

C’est passionnant. Quelqu’un pourrait-il s’il vous plaît créer un message avec un lien vers un thème où KB est installé, montrant exactement ce que KB propose par rapport aux catégories et aux sujets classiques ?

3 « J'aime »

Vous pouvez le voir en action sur notre site de création de thème : https://theme-creator.discourse.org/theme/justindirose/knowledge-base

5 « J'aime »

Cela a été corrigé dans ce commit :


@TowerBR, as-tu fini par trouver ce qui ne fonctionnait pas ? Sinon, envoie-moi un MP et peut-être pourrons-nous regarder cela ensemble.

3 « J'aime »

Il s’agissait d’un conflit de nommage de composant que j’ai résolu.

Je n’ai pas réussi à reproduire ce problème avec les étapes décrites. Essayez de mettre à jour et faites-moi savoir si le problème persiste.

C’est le comportement attendu pour l’instant, car dans cette version du thème, nous nous contentons d’ajouter l’interface utilisateur de la base de connaissances à la liste des sujets existante.

Je pense que c’est une suggestion pertinente et j’ai supprimé à la fois le lien et le hash.

Ces fonctionnalités seront éventuellement incluses dans la version avancée qui sera un plugin.

Les tags populaires se sont bien masqués pour moi lorsque j’ai ajouté une exception.

Je ne suis pas tout à fait sûr de comprendre exactement quel est le problème ici. La catégorie de la base de connaissances possède-t-elle des sous-catégories, mais aucun sujet réel dans la catégorie parente de la base de connaissances ?

Si c’est le cas, cela sort partiellement du cadre de ce composant de thème — nous voulions simplement rendre une catégorie particulière filtrable. Il en va de même pour le filtre des sous-catégories. Certains de ces éléments seront possibles dans la version avancée.

6 « J'aime »

Malheureusement non, le problème persiste. Le bouton KB ne semble rien faire. Je t’envoie un MP.

Avec un peu d’aide de la part de @justin, tout fonctionne désormais.

Je n’avais pas activé tagging_enabled et show_filter_by_tag sur l’instance que j’utilise pour tester.

Merci !

2 « J'aime »

Super ! Il y a beaucoup de bonnes choses ici. Merci pour tout le travail fourni pour que ce composant de thème fonctionne aussi bien. Vous mentionnez une version avancée qui est un plugin — existe-t-il une feuille de route quelque part pour tout cela, afin que je puisse ajuster mes attentes et donner mon avis ? Nous avons également https://meta.discourse.org/t/knowledge-base-plugin/115288 de @angus, qui présente certaines fonctionnalités qui se chevauchent, et il serait utile de savoir sur quel cheval miser. J’aime des aspects des deux.

Je vais faire quelques tests et revenir vers vous.

Non, malheureusement. Mais je peux vous dire que le plugin sur lequel je travaille est d’une nature très différente — pensez au composant thématique sous stéroïdes. Je pense que le plugin et le plugin de base de connaissances de @angus auront des cas d’utilisation utiles.

5 « J'aime »

J’ai apporté une modification intéressante : le paramètre kb categories se remplit désormais automatiquement avec les catégories. Cette fonctionnalité était disponible dans notre API de thème depuis le début, mais je l’ignorais ! @tshenry m’a mis au courant.

Une petite mise en garde : si vous l’avez déjà configuré, vous devrez à nouveau ajouter vos catégories après la mise à jour.

7 « J'aime »

Super ! Cela fonctionne bien… vous recevrez moins de demandes de support maintenant. :slight_smile:

Une petite remarque, mais j’ai remarqué que le paramètre kb categories recherche les noms des catégories, mais pas le nom court (slug).

Ah oui, tu n’auras plus à t’inquiéter du slug. Le composant du thème s’en occupe désormais. J’ai peut-être oublié de modifier certains textes, cependant…

Édité : oui, c’est le cas. J’ai commité une modification pour corriger cela.

2 « J'aime »

J’apprécie beaucoup ce composant de thème ! Merci encore de l’avoir créé. J’attends avec impatience le plugin, car il s’agit d’une fonctionnalité extrêmement précieuse qui encouragera mon équipe à utiliser davantage Discourse. Je ne peux pas en être certain, mais je pense que tant que les sujets wiki ressemblent à des posts de forum, les utilisateurs seront intimidés et moins enclins à les modifier pour les améliorer en tant que ressource partagée.

Voici quelques points sur lesquels je bute :

  1. Le menu des tags apparaît sur l’un de mes sites, mais pas sur l’autre. Je n’ai pas réussi à identifier le conflit. Il s’agit probablement d’un plugin non officiel. Avez-vous des suggestions sur où chercher ?
  2. Il n’y a pas de bouton + NOUVEAU SUJET en haut de la vue de catégorie de la base de connaissances (KB), contrairement à ce qui se fait pour Derniers. Ce serait utile d’en avoir un pour ajouter un nouveau sujet wiki dans la catégorie. Pour l’instant, vous devez cliquer sur Derniers pour démarrer un sujet dans la catégorie.
  3. Ce n’est pas un gros problème, mais cela semble être un bug — reproductible sur mes deux sites et sur le créateur de thème :
    • Accédez à la vue KB
    • Sélectionnez un tag pour filtrer par celui-ci
    • Passez à l’onglet TOP dans le menu supérieur
    • Revenez à l’onglet KB dans le menu supérieur
    • Le filtre par tag est toujours actif
  4. Sur le même site où le menu des tags n’apparaît pas, je rencontre un autre problème étrange que je ne parviens pas à reproduire sur mon autre site ni sur le créateur de thème. Lorsque j’accède à une catégorie KB via le menu déroulant des catégories, je suis redirigé vers Derniers, alors que la valeur par défaut devrait être KB. Le fait de sélectionner KB dans le menu n’a aucun effet… mais lorsque je rafraîchis manuellement le navigateur, je suis bien dirigé vers KB.
4 « J'aime »

Merci, Justin. C’est un composant super utile qui permet d’organiser beaucoup mieux les catégories de la base de connaissances.
Je l’ai ajouté hier à une installation neuve, mais je rencontre deux problèmes :

  1. Les étiquettes ne s’affichent pas dans la barre latérale.
  2. Lorsque je sélectionne une catégorie, la vue de la base de connaissances ne s’affiche pas par défaut (bien que j’aie coché Les catégories sélectionnées affichent automatiquement la vue de la base de connaissances par défaut).

J’ai désactivé tous les autres composants et j’ai activé à la fois tagging_enabled et show_filter_by_tag, mais ces problèmes persistent.

Voyez-vous des erreurs dans la console du navigateur ? Et avez-vous également actualisé la page après avoir activé ces deux paramètres ?

3 « J'aime »

Entendez-vous par là rafraîchir la page — bien sûr que je l’ai fait ?

Je ne vois aucune erreur, juste ces alertes :

Est-ce sur un forum public ? J’ai quelques soupçons, mais il vaudrait mieux pouvoir jeter un coup d’œil.

MODIF : Le numéro 2 est certainement dû à nos récents changements de routage des catégories. Je travaille sur une correction, mais je dois encore contourner certaines complexités.

Pour le numéro 1, je n’arrive pas à reproduire le problème. Il est fort probable que vous voyiez des sujets provenant de sous-catégories dans la liste. Comme ces sujets ne se trouvent pas dans la catégorie que vous avez sélectionnée, les tags n’apparaîtront pas dans la barre latérale.

1 « J'aime »