Sarmate.net Sarmate.net
Home Funzioni Prezzi Documentazione Contatto
Accedi Si registri
Web scientifico 7 min

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-course> ├── <mp-meta> │ ├── <mp-doc-title> │ ├── <mp-author> │ └── <mp-date> ├── <mp-toc> ← opzionale, indice automatico ├── <mp-chapter> │ ├── <mp-title> │ ├── <mp-section> │ │ ├── <mp-title> │ │ ├── <mp-definition> │ │ ├── <mp-theorem> │ │ ├── <mp-exercise> │ │ └── ... │ └── <mp-subsection> │ └── ... └── <mp-chapter> └── ...
Incapsulamento automatico Se inserisci del contenuto didattico (<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

AttributoValoriDescrizione
langfr | en | de | esLingua delle etichette automatiche (Definizione / Teorema / Esempio…)
themeocean · foret · lavande · corail · rose · ardoise · sepia · nuit · minuit · original · classiquePalette di colori iniziale (predefinito ocean)
theme-pickeron | offMostra o nasconde il pulsante flottante di cambio tema
navigationauto | on | offBarra di navigazione inferiore (predefinito auto = attiva se c'è almeno un <mp-blank>)
creditvisible | hiddenLink «Creato con sarmate.net» (visibile per impostazione predefinita — nascondibile nei piani a pagamento)
vartable-scalenumerisch (0.2 – 3) oder compact | normal | largeDimensione predefinita di tutti i <mp-vartable> figli (può essere sovrascritta per tabella)
exercise-headingstacked | inline«Esercizio 1: Titolo» su una riga (inline) o impilato (predefinito stacked)
HTML
<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>.

HTML
<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:

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.

HTML
<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>
Consiglio dell'editor Nell'editor online, il pulsante Capitolo / Sezione / Sottosezione inserisce uno scheletro precompilato con un commento di aiuto « Inserisci qui le sue sezioni (mp-section) » che ricorda di rispettare la gerarchia. Utile quando arrivi da LaTeX, dove \section / \subsection si susseguono in modo piatto.

<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.

AttributoValoriDescrizione
depth1 | 2 | 31 = solo capitoli · 2 = + sezioni · 3 = + sottosezioni (predefinito 3)
titleTesto liberoSostituisce l'etichetta predefinita « Indice »
layoutsidebarAncora la TOC come barra laterale (evidenziazione della sezione attiva allo scroll)
HTML
<mp-toc depth="3"></mp-toc>

Esempio completo

Ecco una struttura minima: intestazione + indice + un capitolo con due sezioni.

HTML
<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.