Discourse ディクショナリプラグイン 🆎

プラグイン
1

概要: Discourse Dictionary プラグインを使用すると、ユーザーはトピックの最初の投稿に単語の辞書的な意味を追加できます。以下に、動作を示す短いビデオを示します。

:link: GitHub: GitHub - fzngagan/discourse-dictionary: A discourse plugin to add meanings of a given word to the post
:arrow_right: インストール: プラグインのインストールガイドに従ってください。

特徴

  • ユーザー（デフォルトでTL2）がコンポーザー経由で単語の辞書的な意味を選択できます。選択された単語にカーソルを合わせると、選択された意味を示すツールチップが表示されます。
  • 現在、Oxford Dictionary API をサポートしています。
  • 現在、単数形のみをサポートしています。つまり、「fungi」は機能せず、「fungus」を使用する必要があります。
  • 意味はデータベースにキャッシュされ、将来の高速ロードと API のしきい値の枯渇回避に役立ちます。
  • コンポーザーにロードされた値は調整できます。

設定

  • API 資格情報を https://developer.oxforddictionaries.com/ から取得してください。
  • app id をサイト設定 discourse dictionary oxford app id に使用してください。
  • api key をサイト設定 discourse dictionary oxford api key に使用してください。
  • この機能にアクセスできるユーザーの最小信頼レベルを discourse dictionary min trust level で設定できます。

TODO

  • 複数形の単語をサポートする
  • その他の辞書 API をサポートする
  • テストを含める

謝辞

@sam さん、どうもありがとうございます。

  • discourse-footnote プラグインのツールチップコードからインスピレーションを得ました。
  • メタのマークダウンドキュメントは、このプラグインを作成する上で不可欠でした。
「いいね！」 21
3

この @fzngagan さん、本当にありがとうございます！ガイドを改善できる点があれば、遠慮なくお知らせください！:tada:

「いいね！」 7
4

このプラグインを試すのがとても楽しみです。まだ方法がわかりませんが、おそらく何らかの方法で組み込むことができるでしょう。

思いついたことの一つは、これが語学学習にどれほど役立つかということです。オックスフォード辞書のドキュメントを見たところ、他の言語の単語も検索できるようです: https://developer.oxforddictionaries.com/documentation/languages

Rubyプログラミングについてはあまり詳しくありませんが、見たところ、このコードブロックの dataset: 'en-us' の行を es または sw に変更するだけで、スペイン語やスワヒリ語を使用するようにプラグインを調整するのは簡単かもしれません。

    def self.fetch_from_api(word)
      response = client().entry(
        word: word,
        dataset: 'en-us',
        params: { fields: 'definitions' }
      )
  1. それだけで変更する必要があるのはそれだけだと思いますか？
  2. 他の言語を使用するオプションを追加することを検討しましたか？

これを作ってくれてありがとう！

「いいね！」 1
5

そう思います。 :slight_smile:

「いいね！」 1
6

私の意図は、単にそれを公開して、コミュニティからの関心があるかどうかを確認することでした。このプラグインは、3年近く前に仕様を作成し、それを構築する方法を知らなかった頃のものなので、私にとって少し特別なものです。:slight_smile:

私の投稿はこちらです

「いいね！」 1
7

@jimkleiber
新しい辞書ソースを簡単に追加できるようにしました。その点についてもPRを歓迎します。

「いいね！」 2
8

では、このプラグインはプラグインの作成方法（PRも）を学ぶのにも役立つかもしれませんね☺️近いうちに見て、お知らせします。ありがとうございます！

「いいね！」 1
9

私が触らなかった唯一のことは、単語の単数形を取得するためのレンマAPIです。オックスフォードAPI（そしておそらく他のAPI）は特に単数形で機能するため、それは重要です。それも価値があるでしょう。

「いいね！」 1
10

こんにちは、@fzngagan さん。興味深いユースケースがあり、あなたのプラグインがお役に立てるかと思っています。

私は聴覚障害のある人々のためのフォーラムを運営しており、初心者が学ぶ必要のある専門用語がたくさんあります。ウィキにいくつかの定義がありますが、システム定義を追加して、定義された用語や頭字語がユーザーが[dict]タグを設定しなくても自動的に下線が引かれるようになると非常に便利です。オックスフォードの提案する定義は便利ですが、これらの単語の多くにはカスタム定義が必要になると思います。

ありがとうございます！

「いいね！」 1
11

We have Auto-Linkify Words Theme Component ですが、単語の外観をリンクに変換する以上のことはできません。ご提案のことを達成するために、確かにフォークすることができます。作業をスポンサーしていただけるのであれば、Marketplace から開発者を雇うことができます。

12

@abrambailey は、abbrify words (with styling) テーマコンポーネントを検討しましたか？ 私はそれを私のサイトでインラインでホバー時に定義を表示するために使用しています… ここで実際に動作を確認できます: The Future of the Metaverse in Daily Life - Tech News and Tips - n👀bish.me

「いいね！」 1