 |
Riepilogo | Discourse Math utilizza MathJax (predefinito) o KaTeX per rendere le formule matematiche nel tuo forum Discourse. |
 |
Guida all’installazione | Questo plugin è incluso nel nucleo di Discourse. Non è necessario installarlo separatamente. |
Abilitare la Matematica
Il plugin Matematica può essere abilitato dalle sue impostazioni, accessibili dalla pagina admin/plugins:
Funzionalità
Una volta abilitato, puoi rendere la matematica inline avvolgendo l’espressione con un singolo $, ad esempio: $E=mc^2$.
Puoi rendere blocchi di matematica avvolgendoli con $$:
$$
\sqrt{(-1)} \; 2^3 \; \sum \; \pi
$$
Discourse Math utilizza un’euristica per assicurarsi che frasi come: “Ho speso 20$ e altri 100$” non vengano convertite.
Delimitatori LaTeX
Se abilitato tramite le impostazioni del sito, puoi utilizzare anche i delimitatori LaTeX standard:
- Inline:
\(...\)- Esempio:\(E=mc^2\) - Blocco:
\[...\]- Esempio:\[ \frac{1}{2} \]
AsciiMath (solo MathJax)
Quando si utilizza MathJax, puoi abilitare l’elaborazione asciimath che utilizza % come delimitatore: %E=mc^2%
Integrazione con il Compositore
Il compositore include un pulsante Inserisci Matematica nella barra degli strumenti con la scorciatoia da tastiera \u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eM\u003c/kbd\u003e. Questo apre una finestra modale in cui puoi:
- Passare dalla modalità inline a quella a blocco
- Scrivere la tua espressione LaTeX
- Anteprimare e inserire nel tuo post
Nell’editor di testo ricco, le espressioni matematiche appaiono come nodi modificabili con un pulsante di modifica per cambiare l’espressione.
Supporto Chat
Le espressioni matematiche vengono anche renderizzate nei messaggi di Discourse Chat utilizzando le stesse impostazioni e lo stesso motore di rendering.
Motori di Rendering
MathJax (Predefinito)
- Versione: 4.1
- Formati di output: HTML (predefinito) o SVG
- Funzionalità:
- Menu contestuale (clic destro sulla formula)
- Arricchimento dell’accessibilità per i lettori di schermo
- Zoom con Alt+clic (zoom al 175%)
- Supporto AsciiMath
KaTeX (Alternativa)
- Funzionalità:
Impostazioni del Sito
Visualizza tutte le impostazioni del sito pertinenti cercando “math” nelle impostazioni di amministrazione.
| Nome | Descrizione |
|---|---|
| discourse math enabled | Abilita il plugin Discourse Math (aggiunge elaborazione speciale ai blocchi $ e $$) |
| discourse math provider | Fornitore di rendering matematico: mathjax (predefinito) o katex |
| discourse math enable latex delimiters | Abilita i delimitatori in stile LaTeX: \(...\) per l’inline e \[...\] per i blocchi di matematica |
| discourse math mathjax output | Formato di output MathJax: html (predefinito) o svg (solo MathJax) |
| discourse math enable menu | Abilita il menu contestuale per le espressioni matematiche (solo MathJax) |
| discourse math enable accessibility | Abilita le funzionalità di accessibilità come l’arricchimento del testo (solo MathJax con menu) |
| discourse math zoom on click | Zoom al 175% con l’interazione Alt+clic (solo MathJax con menu) |
| discourse math enable asciimath | Abilita l’elaborazione asciimath con il delimitatore % (solo MathJax) |
Ospitato da noi? Questo plugin è disponibile su tutti i nostri livelli di hosting Math | Discourse - Civilized Discussion