1. Introduzione a LaTeX, Markdown e MathJax
Markdown: un linguaggio di markup leggero, facile da utilizzare e compatibile con la sintassi LaTeX per le formule matematiche.
MathJax: una libreria JavaScript che consente la visualizzazione di formule matematiche su pagine web, rendendole accessibili anche agli utenti con disabilità visive.
2. Prerequisiti
Prima di iniziare, assicurati di avere i seguenti strumenti:
- Un editor di testo come Blocco Note, Visual Studio Code o qualsiasi altro editor a tua scelta.
- Un browser web aggiornato (Chrome, Firefox, Edge, Safari).
- Una conoscenza di base della sintassi LaTeX o Markdown.
3. Conversione di un documento LaTeX o Markdown in HTML
Utilizzeremo Pandoc per convertire documenti in formato LaTeX o Markdown in HTML accessibile con MathJax.
- Installa Pandoc:Scarica e installa Pandoc dal sito ufficiale di Pandoc. Segui le istruzioni specifiche per il tuo sistema operativo.
- Prepara il tuo file:Assicurati che il tuo file sia ben strutturato:
- File LaTeX: utilizza i comandi standard per scrivere formule matematiche.
- File Markdown: scrivi il testo in Markdown includendo le formule matematiche in sintassi LaTeX.
Esempio:Questo è un esempio di formula inline:
$E = mc^2$
. Questo è un esempio di formula in display mode:$ \int_0^\infty e^{-x} \, dx = 1 $
- Conversione con Pandoc:Esegui uno dei seguenti comandi da terminale per generare un file HTML:
pandoc -s --mathjax -o output.html input.tex
Per un file Markdown:
pandoc -s --mathjax -o output.html input.md
Questi comandi generano un file HTML con MathJax incorporato per la gestione delle formule matematiche.
4. Configurazione di MathJax per l’accessibilità
Per garantire che le formule matematiche siano accessibili, è necessario configurare MathJax correttamente. Aggiungi il seguente script nella sezione <head>
del tuo file HTML:
<script>
MathJax = {
loader: {
load: ['a11y/semantic-enrich', 'a11y/explorer', 'a11y/complexity', 'a11y/assistive-mml']
},
options: {
ignoreHtmlClass: 'tex2jax_ignore|editor-rich-text',
enableEnrichment: true,
sre: {
speech: 'none',
domain: 'mathspeak',
style: 'default',
locale: 'it'
}
},
tex: {
inlineMath: [['
5. Verifica dell’accessibilità
Utilizza strumenti come:
6. Risorse aggiuntive
, ‘
5. Verifica dell’accessibilità
Utilizza strumenti come:
6. Risorse aggiuntive
], [‘\\(‘, ‘\\)’]], processEscapes: true } }; </script> <script src=”https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js”></script>
5. Verifica dell’accessibilità
Utilizza strumenti come: