Struttura di un documento mathpad
Ogni documento mathpad segue una gerarchia semplice e semantica: una radice <mp-course>, un blocco di intestazione <mp-meta>, poi capitoli e sezioni. Questa pagina descrive ogni tag di struttura e i suoi attributi — l'ossatura comune a tutti i suoi documenti.
Anatomia di un documento
Ecco la gerarchia tipica di un documento mathpad — semplificata. Gli elementi obbligatori sono in grassetto, quelli opzionali in normale:
<mp-definition>, <mp-exercise>…) direttamente nel <body> senza avvolgerlo in <mp-course> / <mp-chapter>, mathpad.js lo avvolge automaticamente per ereditare il sistema di temi, navigazione e numerazione. Può iniziare con pochissimi tag. <mp-course> — la radice
Avvolge tutto il documento. Attiva la numerazione automatica (Definizione 1, Teorema 2…), il sistema di temi, la barra di navigazione inferiore e il selettore di tema.
Attributi importanti
| Attributo | Valori | Descrizione |
|---|---|---|
| lang | fr | en | de | es | Lingua delle etichette automatiche (Definizione / Teorema / Esempio…) |
| theme | ocean · foret · lavande · corail · rose · ardoise · sepia · nuit · minuit · original · classique | Palette di colori iniziale (predefinito ocean) |
| theme-picker | on | off | Mostra o nasconde il pulsante flottante di cambio tema |
| navigation | auto | on | off | Barra di navigazione inferiore (predefinito auto = attiva se c'è almeno un <mp-blank>) |
| credit | visible | hidden | Link «Creato con sarmate.net» (visibile per impostazione predefinita — nascondibile nei piani a pagamento) |
| vartable-scale | numerisch (0.2 – 3) oder compact | normal | large | Dimensione predefinita di tutti i <mp-vartable> figli (può essere sovrascritta per tabella) |
| exercise-heading | stacked | inline | «Esercizio 1: Titolo» su una riga (inline) o impilato (predefinito stacked) |
<mp-course lang="it" theme="ocean" exercise-heading="inline" vartable-scale="0.85">
...
</mp-course>
<mp-meta> — l'intestazione del documento
Genera un grande blocco-titolo con gradiente (equivalente a \maketitle in LaTeX). Accetta <mp-doc-title>, opzionale <mp-author>, opzionale <mp-date>.
<mp-meta>
<mp-doc-title>Funzioni affini</mp-doc-title>
<mp-author>Nome Cognome</mp-author>
<mp-date>24-08-2026</mp-date>
</mp-meta>
<mp-chapter>, <mp-section>, <mp-subsection>
Tre livelli gerarchici numerati automaticamente:
<mp-chapter>— livello più alto, numerazione romana (I, II, III…)<mp-section>— numerata in arabo per capitolo (1, 2, 3…)<mp-subsection>— numerata cap.sez.sott (1.1.1, 1.1.2…)
Ogni livello prende un <mp-title> come primo figlio. Importante: un <mp-section> deve essere figlio diretto di un <mp-chapter> (non fratello), altrimenti non appare nell'indice.
<mp-chapter><mp-title>Studio di funzione</mp-title>
<mp-section><mp-title>Insieme di definizione</mp-title>
<!-- contenuto -->
</mp-section>
<mp-section><mp-title>Variazioni</mp-title>
<mp-subsection><mp-title>Calcolo della derivata</mp-title>
<!-- ... -->
</mp-subsection>
</mp-section>
</mp-chapter>
<mp-toc> — indice automatico
Genera un indice navigabile a partire dai <mp-chapter> / <mp-section> / <mp-subsection> presenti. Compatibile con le formule KaTeX nei titoli.
| Attributo | Valori | Descrizione |
|---|---|---|
| depth | 1 | 2 | 3 | 1 = solo capitoli · 2 = + sezioni · 3 = + sottosezioni (predefinito 3) |
| title | Testo libero | Sostituisce l'etichetta predefinita « Indice » |
| layout | sidebar | Ancora la TOC come barra laterale (evidenziazione della sezione attiva allo scroll) |
<mp-toc depth="3"></mp-toc>
Esempio completo
Ecco una struttura minima: intestazione + indice + un capitolo con due sezioni.
<mp-course lang="it" theme="ocean">
<mp-meta>
<mp-doc-title>Leggi di probabilità</mp-doc-title>
<mp-author>Nome Cognome</mp-author>
<mp-date>24-08-2026</mp-date>
</mp-meta>
<mp-toc depth="2"></mp-toc>
<mp-chapter><mp-title>Leggi discrete</mp-title>
<mp-section><mp-title>Legge binomiale</mp-title>
<!-- definizioni, teoremi, esercizi… -->
</mp-section>
<mp-section><mp-title>Legge di Poisson</mp-title>
<!-- ... -->
</mp-section>
</mp-chapter>
</mp-course>
Pronto a provare mathpad?
Crei il suo primo documento scientifico in HTML nell'editor online, o importi il suo corso LaTeX esistente con un solo clic.