Olá a todos, estou interessado em criar um glossário de comunidade dentro do Discourse. Algo como isso:
Entendo que essa funcionalidade não faz parte do núcleo, mas já existe algum plugin que já faça isso? Ou alguém encontrou uma maneira criativa de implementar isso no seu fórum?
Para esclarecer, quero adicionar um glossário ao meu fórum — não quero transformar um fórum em um glossário.
Obrigado!
Fazer disso um post wiki é o que você quer?
Uma postagem de wiki (para o conteúdo) com DiscoTOC (para a navegação entre as letras) seria uma combinação muito boa
Me pergunto se este plugin pode ajudar de alguma forma
Isso poderia fazer o trabalho, de certo modo, mas não exatamente o que estou pensando. Com uma página de glossário, cada palavra seria um link para sua definição, ou poderia ter a definição logo abaixo da palavra (talvez em um acordeão para ver a definição). No primeiro caso, criar links em todo o site poderia redirecionar o usuário para a página de definição da palavra, e no segundo caso, para o acordeão aberto.
O acima poderia ser feito com wikis e um framework planejado, mas a facilidade de uso pela comunidade aumentaria se houvesse uma maneira mais direta de adicionar uma palavra, em vez de um tópico. Além disso, o classificador alfabético no topo da página é um recurso muito bom.
Ainda não trabalhei com o DiscoTOC. Isso pode ser o caminho para fazer isso funcionar. O plugin Knowledge Explorer é fantástico, mas preciso pensar em como integrá-lo ao glossário e ao restante do site.
Existe um componente de tema linkify. Ele pode fazer o que você precisa se forem apenas algumas palavras. Se você for ter dezenas ou centenas, será necessário usar um plugin.
Acabei de brincar um pouco com isso e adicionei algum CSS ao meu tema para fazer os links do glossário aparecerem na cor padrão do texto, com um sublinhado pontilhado.
a.linkify-word {
text-decoration-line: underline;
text-decoration-style: dotted;
color: $primary;
text-underline-offset: 0.1em;
}
(A compatibilidade com navegadores para text-underline-offset ainda não é muito boa, mas pelo menos no Firefox (Desktop) e no Safari isso deixa a aparência um pouco mais agradável.)
Exemplos:
Tenho trabalhado em uma seção de Glossário para o fórum https://discourse.igkt.net/, e fiz da seguinte forma:
Crie uma categoria para as entradas do Glossário (no meu caso, #glossary)
Comece a criar Tópicos de Glossário, no meu caso criei um Tópico por conceito no Glossário, mas outra forma de fazer isso seria usar menos Tópicos e usar títulos Markdown para que você possa usar links no estilo âncora para eles. Qualquer coisa que tenha um link exclusivo funcionará.
Use o recurso integrado Watched Words para vincular a palavra do glossário (e quaisquer sinônimos) ao Tópico relevante. (infelizmente isso precisa ser feito manualmente, a menos que eu crie uma automação para isso)
Este é um novo recurso para esse fórum, então tenho certeza de que haverá feedback sobre se é útil e se conseguimos cobertura de glossário suficiente, e se isso interfere na capacidade do usuário de adicionar seus próprios links para essas palavras.
Gostaria de ouvir de outras pessoas que implementaram um Glossário e saber como fizeram.
Eu também tentei fazer isso; é surpreendentemente difícil fazê-lo funcionar por razões técnicas e sociais.
Minhas dicas:
Ao usar palavras monitoradas, use Regex restritivo - ou você o aplicará em momentos inoportunos
Modelos de tópico podem ser muito úteis para incentivar uma boa estrutura para as contribuições
Você precisará de um campeão. Ou esteja preparado para ser o campeão você mesmo. Trabalho duro!
Você pode achar estes 2 Theme component úteis.
Um glossário como parte da documentação do site é uma boa ideia. Para esse fim, o plugin Doc Categories é bastante útil. Eu costumo copiar alguns dos vários tópicos de Documentação sobre a interface do usuário e coisas assim como um Guia Prático (Hot-to).
https://meta.discourse.org/t/auto-linkify-words/82193
https://meta.discourse.org/t/add-abbr-tags-to-words-in-posts/88394