Dicionário do Discourse Plugin 🆎

Plugin
1

Resumo: O plugin Discourse Dictionary permite que um usuário adicione o significado de dicionário de uma palavra à primeira postagem de um tópico. Aqui está um vídeo curto para demonstrar o funcionamento.

:link: GitHub: GitHub - fzngagan/discourse-dictionary: A discourse plugin to add meanings of a given word to the post
:arrow_right: Instalar: Siga o guia de instalação de plugins.

Funcionalidades

  • Permite que um usuário (padrão para TL2) selecione o significado de dicionário de uma palavra através do compositor. A palavra selecionada, quando pairada, exibirá uma dica mostrando o significado selecionado.
  • Atualmente suporta a API do Dicionário Oxford.
  • Atualmente suporta a forma singular das palavras, ou seja, fungi não funcionará, você terá que usar fungus.
  • Os significados são armazenados em cache no banco de dados para carregamentos rápidos no futuro e para evitar esgotar os limites da API.
  • Você pode ajustar os valores depois que eles forem carregados no compositor.

Configuração

  • Obtenha suas credenciais de API em https://developer.oxforddictionaries.com/
  • Use o app id para a configuração do site discourse dictionary oxford app id
  • Use a api key para a configuração do site discourse dictionary oxford api key
  • Você pode definir o nível de confiança mínimo de usuários que podem acessar este recurso usando discourse dictionary min trust level

A FAZER

  • Suportar formas plurais de palavras
  • Suportar outras APIs de Dicionário
  • Incluir testes

Créditos

Muito obrigado @sam

  • Tirei inspiração do código de dica na plugin discourse-footnote.
  • Os documentos de markdown no meta foram indispensáveis para escrever este plugin.
21 curtidas
3

Muito obrigado por isso @fzngagan! Se os guias puderem ser aprimorados de alguma forma, não hesite em nos informar! :tada:

7 curtidas
4

Estou bastante animado para experimentar este plugin. Ainda não sei como, mas provavelmente encontrarei uma maneira de integrá-lo.

Uma coisa que me ocorreu foi o quão útil isso pode ser para o aprendizado de idiomas. Fui à documentação do Oxford Dictionary e vi que parece possível procurar palavras em outros idiomas também: https://developer.oxforddictionaries.com/documentation/languages

Não sei muito sobre programação em Ruby, mas pelo que posso ver, parece que pode ser fácil para mim ajustar o plugin para usar espanhol ou suaíli apenas alterando a linha dataset: 'en-us' para es ou sw neste bloco de código:

    def self.fetch_from_api(word)
      response = client().entry(
        word: word,
        dataset: 'en-us',
        params: { fields: 'definitions' }
      )
  1. Você acha que é só isso que eu teria que mudar?
  2. Você pensou em adicionar a opção de usar outros idiomas?

Obrigado por fazer isso!

1 curtida
5

Eu acho que sim. :slight_smile:

1 curtida
6

Minha intenção era apenas lançá-lo e ver se havia interesse na comunidade. Este plugin é um pouco especial para mim porque fiz a especificação dele há quase 3 anos, quando eu não tinha o conhecimento de como construí-lo. :slight_smile:

Aqui está meu post

1 curtida
7

@jimkleiber
Também me certifiquei de que novas fontes de dicionário possam ser adicionadas facilmente. Ficarei feliz em aceitar PRs nesse sentido também.

2 curtidas
8

Então talvez este plugin possa me ajudar também a aprender como construir um plugin (e fazer um PR) :smiling_face: Vou dar uma olhada um dia desses e te aviso. Obrigado!

1 curtida
9

A única coisa que não toquei foi a API de lema para buscar a forma singular das palavras. É importante porque a API da Oxford especialmente (e provavelmente outras) funciona com a forma singular. Isso também seria valioso.

1 curtida
10

Olá @fzngagan … Tenho um caso de uso interessante e gostaria de saber se seu plugin poderia me ajudar.

Eu administro um fórum para pessoas com perda auditiva e há muitos termos que os novatos precisam aprender. Temos uma wiki com algumas definições, mas seria muito útil se pudéssemos adicionar definições do sistema e ter termos e acrônimos definidos sublinhados automaticamente sem que o usuário precise definir a tag [dict]. Ter as definições sugeridas pelo Oxford é útil, mas imagino que muitas dessas palavras precisarão de definições personalizadas.

Obrigado!

1 curtida
11

Temos o componente de tema Auto-Linkify Words, mas ele vai apenas até converter a aparência de uma palavra em um link. Certamente pode ser adaptado para alcançar o que você está sugerindo. Você pode contratar um desenvolvedor em Marketplace se estiver feliz em patrocinar o trabalho.

12

@abrambailey você considerou… o componente de tema abbrify words (with styling)? Estou usando-o para fornecer definições inline ao passar o mouse no meu site… você pode vê-lo em ação aqui: The Future of the Metaverse in Daily Life - Tech News and Tips - n👀bish.me

1 curtida