Plugin Dizionario Discourse 🆎

Plugin
1

Riepilogo: Il plugin Discourse Dictionary consente a un utente di aggiungere il significato di una parola dal dizionario al primo post di un argomento. Ecco un breve video per dimostrare il funzionamento.

:link: GitHub: GitHub - fzngagan/discourse-dictionary: A discourse plugin to add meanings of a given word to the post
:arrow_right: Installa: Segui la guida all’installazione dei plugin.

Funzionalità

  • Consente a un utente (impostazione predefinita TL2) di selezionare il significato di una parola da un dizionario tramite il compositore. La parola selezionata, quando passata sopra con il mouse, visualizzerà un tooltip che mostra il significato selezionato.
  • Attualmente supporta l’API del dizionario Oxford.
  • Attualmente supporta la forma singolare delle parole, ad esempio fungi non funzionerà, dovrai usare fungus.
  • I significati vengono memorizzati nella cache nel database per caricamenti rapidi in futuro e per evitare di esaurire le soglie dell’API.
  • Puoi modificare i valori una volta caricati nel compositore.

Configurazione

  • Ottieni le tue credenziali API da https://developer.oxforddictionaries.com/
  • Usa l’app id per l’impostazione del sito discourse dictionary oxford app id
  • Usa la api key per l’impostazione del sito discourse dictionary oxford api key
  • Puoi impostare il livello di fiducia minimo degli utenti che possono accedere a questa funzionalità utilizzando discourse dictionary min trust level

TODO

  • Supportare le forme plurali delle parole
  • Supportare altre API di dizionari
  • Includere test

Crediti

Grazie mille @sam

  • Ho tratto ispirazione dal codice del tooltip nel plugin discourse-footnote.
  • La documentazione markdown su meta è stata indispensabile per la scrittura di questo plugin.
21 Mi Piace
3

Grazie mille per questo @fzngagan! Se le guide possono essere migliorate in qualche modo, non esitare a farcelo sapere! :tada:

7 Mi Piace
4

Sono molto entusiasta di provare questo plugin. Non so ancora come, ma probabilmente troverò un modo per integrarlo.

Una cosa che mi è venuta in mente è quanto possa essere utile per l’apprendimento delle lingue. Sono andato alla documentazione dell’Oxford Dictionary e ho visto che sembra possibile cercare parole anche in altre lingue: https://developer.oxforddictionaries.com/documentation/languages

Non so molto sulla programmazione Ruby, ma da quello che posso vedere, sembra che possa essere facile per me modificare il plugin per usare lo spagnolo o lo swahili semplicemente cambiando la riga dataset: 'en-us' in es o sw in questo blocco di codice:

    def self.fetch_from_api(word)
      response = client().entry(
        word: word,
        dataset: 'en-us',
        params: { fields: 'definitions' }
      )
  1. Pensi che sia tutto quello che dovrei cambiare?
  2. Hai pensato di aggiungere l’opzione per usare altre lingue?

Grazie per averlo creato!

1 Mi Piace
5

Penso di sì. :slight_smile:

1 Mi Piace
6

La mia intenzione era solo di lanciarlo e vedere se c’era interesse nella community. Questo plugin è un po’ speciale per me perché ho creato le specifiche quasi 3 anni fa, quando non avevo le conoscenze per costruirlo. :slight_smile:

Ecco il mio post

1 Mi Piace
7

@jimkleiber
Ho anche fatto in modo che nuove origini del dizionario possano essere aggiunte facilmente. Sono felice di accettare anche PR a riguardo.

2 Mi Piace
8

Allora forse questo plugin può aiutarmi anche a imparare a costruire un plugin (e fare un PR) :smiling_face: Darò un’occhiata uno di questi giorni e ti farò sapere. Grazie!

1 Mi Piace
9

L’unica cosa che non ho toccato è stata l’API lemma per recuperare la forma singolare delle parole. È importante perché l’API di Oxford in particolare (e probabilmente altre) funziona con la forma singolare. Anche questo sarebbe prezioso.

1 Mi Piace
10

Ciao @fzngagan … Ho un caso d’uso interessante e mi chiedo se il tuo plugin potrebbe aiutarmi.

Gestisco un forum per persone con problemi di udito e ci sono tantissimi termini che i nuovi arrivati devono imparare. Abbiamo una wiki con alcune definizioni, ma sarebbe molto utile se potessimo aggiungere definizioni di sistema e avere termini e acronimi definiti automaticamente sottolineati senza che l’utente imposti il tag [dict]. Avere le definizioni suggerite da Oxford è utile, ma immagino che molte di queste parole avranno bisogno di definizioni personalizzate.

Grazie!

1 Mi Piace
11

Abbiamo Auto-Linkify Words Theme Component ma si limita a convertire l’aspetto di una parola in un link. Può certamente essere modificato per ottenere ciò che stai suggerendo. Puoi assumere uno sviluppatore da Marketplace se sei felice di sponsorizzare il lavoro.

12

@abrambailey hai preso in considerazione… il componente tematico abbrify words (with styling)? Lo sto usando per fornire definizioni inline al passaggio del mouse sul mio sito… puoi vederlo in azione qui: The Future of the Metaverse in Daily Life - Tech News and Tips - n👀bish.me

1 Mi Piace