Solicitação de Recurso: Suporte para \nicefrac em Matemática no Discourse (\KaTeX/\MathJax)

:puzzle_piece: Solicitação de Recurso: Adicionar Suporte para \\nicefrac na Renderização de Matemática do Discourse

Resumo

Por favor, adicione suporte para o comando \\nicefrac{a}{b} na renderização de matemática do Discourse. Esta fração de estilo diagonal é compacta e ideal para expressões em linha, melhorando a legibilidade sem interromper o espaçamento entre linhas.


:test_tube: Por que \\nicefrac?

  • Produz frações diagonais (com barra) limpas como $ \\nicefrac{1}{2} $
  • Mais elegante que 1/2 e menos volumoso que \\dfrac{1}{2}
  • Comum em física, estatística e escrita matemática

:package: Notas de Implementação

O Discourse pode suportar matemática via KaTeX ou MathJax, dependendo do plugin instalado. Esta solicitação de recurso descreve a implementação para ambos:

:white_check_mark: MathJax

O MathJax pode suportar \\nicefrac se uma extensão for carregada:

MathJax.Hub.Config({
  TeX: {
    extensions: ["AMSmath.js", "nicefrac.js"]
  }
});

Isso pode significar que nenhuma alteração principal é necessária — então você poderia apenas atualizar a configuração do plugin para habilitar a extensão.

:wrench: KaTeX

O KaTeX não suporta \\nicefrac nativamente. Pode ser possível que o seguinte macro de solução alternativa possa ser adicionado:

macros: {
  "\\\\nicefrac": "\\\\raisebox{.5ex}{\\\\footnotesize #1}/\\\\raisebox{-.25ex}{\\\\footnotesize #2}"
}

Alternativamente, pode valer a pena investigar o suporte através de extensões KaTeX de terceiros, como katex-extension.


:magnifying_glass_tilted_left: Reprodução

Tente renderizar o seguinte:

$\\nicefrac{3}{4}$

Resultado no KaTeX:

`KaTeX parse error: Undefined control sequence: \\nicefrac

Resultado no MathJax (se a extensão não estiver carregada):

LaTeX Error: Command \\nicefrac undefined `MathJax parse error: Undefined control sequence: \\nicefrac


:white_check_mark: Comportamento Esperado

  • $ \\nicefrac{3}{4} $ renderiza uma fração diagonal adequada
  • Pode funcionar de forma consistente em instalações KaTeX e MathJax provedores
  • Esperançosamente, sem erros de análise ou confusão para o usuário

:speech_balloon: Motivação

  • \\nicefrac é amplamente utilizado em documentos LaTeX e materiais de ensino
  • Frações em linha aparecem de forma mais natural no texto
  • Melhora a formatação matemática em comunidades Discourse com forte presença STEM

:link: Referências

Obrigado por considerar esta pequena, mas valiosa melhoria na renderização de matemática no Discourse!