 |
Resumo | Discourse Math usa MathJax (padrão) ou KaTeX para renderizar fórmulas matemáticas no seu fórum Discourse. |
 |
Guia de Instalação | Este plugin já vem incluído no núcleo do Discourse. Não há necessidade de instalá-lo separadamente. |
Ativando Matemática
O plugin de Matemática pode ser ativado em suas configurações, acessadas pela página admin/plugins:
Funcionalidades
Após ativado, você pode renderizar matemática inline envolvendo-a com um único $, assim: $E=mc^2$.
Você pode renderizar blocos de matemática envolvendo-os com $$:
$$
\sqrt{(-1)} \; 2^3 \; \sum \; \pi
$$
O Discourse Math usa uma heurística para garantir que frases como: “Gastei 20$ e mais 100$” não sejam convertidas.
Delimitadores LaTeX
Quando ativado nas configurações do site, você também pode usar delimitadores LaTeX padrão:
- Inline:
\(...\)- Exemplo:\(E=mc^2\) - Bloco:
\[...\]- Exemplo:\[ \frac{1}{2} \]
AsciiMath (apenas MathJax)
Ao usar MathJax, você pode ativar o processamento asciimath, que usa % como delimitador: %E=mc^2%
Integração com o Editor (Composer)
O editor inclui um botão Inserir Matemática na barra de ferramentas com o atalho de teclado \u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eM\u003c/kbd\u003e. Isso abre uma janela modal onde você pode:
- Alternar entre modo inline e bloco
- Escrever sua expressão LaTeX
- Visualizar e inserir no seu post
No editor de texto rico, as expressões matemáticas aparecem como nós editáveis com um botão de edição para modificar a expressão.
Suporte no Chat
As expressões matemáticas também são renderizadas nas mensagens do Chat do Discourse, usando as mesmas configurações e engine de renderização.
Engines de Renderização
MathJax (Padrão)
- Versão: 4.1
- Formatos de saída: HTML (padrão) ou SVG
- Funcionalidades:
- Menu contextual (clique direito na fórmula)
- Enriquecimento de acessibilidade para leitores de tela
- Zoom ao clicar com Alt (zoom de 175%)
- Suporte a AsciiMath
KaTeX (Alternativa)
- Funcionalidades:
- Renderização rápida
- Extensão Mhchem para equações químicas
- Extensão CopyTex - clique na fórmula para copiar o código LaTeX para a área de transferência
- Suporte a referências cruzadas com as macros
\label,\refe\eqref
Configurações do Site
Veja todas as configurações relevantes do site pesquisando por “math” nas configurações de administrador.
| Nome | Descrição |
|---|---|
| discourse math enabled | Ativa o plugin Discourse Math (adiciona processamento especial aos blocos $ e $$) |
| discourse math provider | Provedor de renderização matemática: mathjax (padrão) ou katex |
| discourse math enable latex delimiters | Ativa delimitadores estilo LaTeX: \(...\) para inline e \[...\] para blocos de matemática |
| discourse math mathjax output | Formato de saída do MathJax: html (padrão) ou svg (apenas MathJax) |
| discourse math enable menu | Ativa menu contextual para expressões matemáticas (apenas MathJax) |
| discourse math enable accessibility | Ativa recursos de acessibilidade como enriquecimento de texto (apenas MathJax com menu) |
| discourse math zoom on click | Zoom de 175% ao clicar com Alt (apenas MathJax com menu) |
| discourse math enable asciimath | Ativa processamento asciimath com delimitador % (apenas MathJax) |
Hospedado por nós? Este plugin está disponível em todos os nossos planos de hospedagem: Math | Discourse - Civilized Discussion