Dictionnaire Discourse Plugin 🆎

Greffon
1

Résumé: Le plugin Discourse Dictionary permet à un utilisateur d’ajouter la définition d’un mot au premier message d’un sujet. Voici une courte vidéo pour démontrer son fonctionnement.

:link: GitHub: GitHub - fzngagan/discourse-dictionary: A discourse plugin to add meanings of a given word to the post
:arrow_right: Installer: Suivez le guide d’installation de plugin.

Fonctionnalités

  • Permet Ă  un utilisateur (par dĂ©faut TL2) de sĂ©lectionner la dĂ©finition d’un mot via l’éditeur. Le mot sĂ©lectionnĂ©, lorsqu’il est survolĂ©, affichera une infobulle montrant la dĂ©finition sĂ©lectionnĂ©e.
  • Prend actuellement en charge l’API du dictionnaire Oxford.
  • Prend actuellement en charge la forme singulière des mots, c’est-Ă -dire que fungi ne fonctionnera pas, vous devrez utiliser fungus.
  • Les dĂ©finitions sont mises en cache dans la base de donnĂ©es pour des chargements rapides Ă  l’avenir et pour Ă©viter d’épuiser les seuils de l’API.
  • Vous pouvez ajuster les valeurs une fois qu’elles sont chargĂ©es dans l’éditeur.

Configuration

  • Obtenez vos identifiants d’API sur https://developer.oxforddictionaries.com/
  • Utilisez l’app id pour le paramètre du site discourse dictionary oxford app id
  • Utilisez la api key pour le paramètre du site discourse dictionary oxford api key
  • Vous pouvez dĂ©finir le niveau de confiance minimum des utilisateurs qui peuvent accĂ©der Ă  cette fonctionnalitĂ© en utilisant discourse dictionary min trust level

Ă€ faire

  • Prise en charge des formes plurielles des mots
  • Prise en charge d’autres API de dictionnaire
  • Inclure des tests

Crédits

Un grand merci Ă  @sam

  • Je me suis inspirĂ© du code des infobulles du plugin discourse-footnote.
  • La documentation markdown sur meta a Ă©tĂ© indispensable pour l’écriture de ce plugin.
21 « J'aime »
3

Merci beaucoup pour cela @fzngagan ! Si les guides peuvent être améliorés d’une quelconque manière, n’hésitez pas à nous le faire savoir ! :tada:

7 « J'aime »
4

Je suis très enthousiaste à l’idée d’essayer ce plugin. Je ne sais pas encore comment, mais je trouverai probablement un moyen de l’intégrer.

Une chose qui m’est venue à l’esprit était l’utilité de cela pour l’apprentissage des langues. Je suis allé consulter la documentation d’Oxford Dictionary et j’ai vu qu’il semble possible de rechercher des mots dans d’autres langues également : https://developer.oxforddictionaries.com/documentation/languages

Je n’y connais pas grand-chose en programmation Ruby, mais d’après ce que je vois, il semble qu’il me serait facile de modifier le plugin pour utiliser l’espagnol ou le swahili en changeant simplement la ligne dataset: 'en-us' en es ou sw dans ce bloc de code :

    def self.fetch_from_api(word)
      response = client().entry(
        word: word,
        dataset: 'en-us',
        params: { fields: 'definitions' }
      )
  1. Pensez-vous que ce soit tout ce que j’aurais à changer ?
  2. Avez-vous pensé à ajouter la possibilité d’utiliser d’autres langues ?

Merci de l’avoir créé !

1 « J'aime »
5

Je pense que oui. :slight_smile:

1 « J'aime »
6

Mon intention était de le lancer et de voir s’il y avait de l’intérêt dans la communauté. Ce plugin me tient un peu à cœur car j’en ai rédigé le cahier des charges il y a près de 3 ans, à une époque où je ne savais pas encore comment le construire. :slight_smile:

Voici mon post

1 « J'aime »
7

@jimkleiber
J’ai également veillé à ce que de nouvelles sources de dictionnaire puissent être ajoutées facilement. Je suis également heureux d’accepter des PR à cet égard.

2 « J'aime »
8

Alors peut-être que ce plugin pourra m’aider aussi à apprendre comment créer un plugin (et faire un PR) :smiling_face: J’y jetterai un œil un de ces jours et je vous tiendrai au courant. Merci !

1 « J'aime »
9

La seule chose que je n’ai pas touchée était l’API de lemmatisation pour récupérer la forme singulière des mots. C’est important car l’API d’Oxford en particulier (et probablement d’autres) fonctionne avec la forme singulière. Ce serait également précieux.

1 « J'aime »
10

Salut @fzngagan … J’ai un cas d’utilisation intéressant, et je me demande si votre plugin pourrait m’aider.

J’administre un forum destiné aux personnes malentendantes et il y a beaucoup de termes que les nouveaux venus doivent apprendre. Nous avons un wiki avec quelques définitions, mais ce serait très utile si nous pouvions ajouter des définitions système et que les termes et acronymes définis soient automatiquement soulignés sans que l’utilisateur n’ait à définir la balise [dict]. Avoir les définitions suggérées par Oxford est pratique, mais j’imagine que beaucoup de ces mots auront besoin de définitions personnalisées.

Merci !

1 « J'aime »
11

Nous avons le composant de thème Auto-Linkify Words, mais il ne fait que convertir l’apparence d’un mot en un lien. Il peut certainement être adapté pour réaliser ce que vous suggérez. Vous pouvez engager un développeur sur Marketplace si vous souhaitez parrainer le travail.

12

@abrambailey avez-vous envisagé… le composant de thème abbrify words (with styling) ? Je l’utilise pour fournir des définitions en ligne au survol sur mon site… vous pouvez le voir en action ici : The Future of the Metaverse in Daily Life - Tech News and Tips - n👀bish.me

1 « J'aime »