||||
-|-|
| Resumo | O Discourse Math usa MathJax (padrão) ou KaTeX para renderizar matemática no seu fórum Discourse.
| Guia de Instalação | Este plugin vem embutido no núcleo do Discourse. Não há necessidade de instalar o plugin separadamente.
Habilitando Matemática
O plugin Math pode ser habilitado em suas configurações, acessadas pela sua página admin/plugins:
Recursos
Uma vez habilitado, 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 habilitado 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 o MathJax, você pode habilitar o processamento asciimath, que usa % como delimitador: %E=mc^2%
Integração com o Composer
O composer inclui um botão Inserir Matemática na barra de ferramentas com o atalho de teclado Shift+M. Isso abre um modal onde você pode:
- Alternar entre modo inline e bloco
- Escrever sua expressão LaTeX
- Pré-visualizar e inserir em sua publicação
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
Expressões matemáticas também são renderizadas nas mensagens do Discourse Chat usando as mesmas configurações e mecanismo de renderização.
Mecanismos de Renderização
MathJax (Padrão)
- Versão: 4.1
- Formatos de saída: HTML (padrão) ou SVG
- Recursos:
- Menu contextual (clique direito na matemática)
- Enriquecimento de acessibilidade para leitores de tela
- Zoom ao clicar com Alt (zoom de 175%)
- Suporte a AsciiMath
KaTeX (Alternativa)
- Recursos:
- Renderização rápida
- Extensão Mhchem para equações químicas
- Extensão CopyTex - clique na matemática para copiar a fonte LaTeX para a área de transferência
- Suporte a referências cruzadas com macros
\label,\refe\eqref
Configurações do Site
Veja todas as configurações relevantes pesquisando nas configurações do administrador por “math”.
| Nome | Descrição |
|---|---|
| discourse math enabled | Habilitar 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 | Habilitar delimitadores estilo LaTeX: \(...\) para inline e \[...\] para bloco |
| discourse math mathjax output | Formato de saída do MathJax: html (padrão) ou svg (apenas MathJax) |
| discourse math enable menu | Habilitar menu contextual para expressões matemáticas (apenas MathJax) |
| discourse math enable accessibility | Habilitar recursos de acessibilidade como enriquecimento de texto (apenas MathJax com menu) |
| discourse math zoom on click | Zoom de 175% na interação com clique Alt (apenas MathJax com menu) |
| discourse math enable asciimath | Habilitar 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