Convertire LaTeX in HTML

Cos'è LaTeX?

LaTeX è un sistema di composizione di documenti molto usato negli ambienti scientifici, accademici e tecnici. Inventato da Leslie Lamport all'inizio degli anni 1980, si basa sul motore tipografico TeX di Donald Knuth. Invece di scrivere un documento con un editor WYSIWYG (come Word), l'autore descrive la struttura logica del contenuto tramite comandi: \section{Introduction}, \textbf{important}, \begin{itemize}... Il compilatore produce poi un PDF di una qualità tipografica notevole, particolarmente adatto alle formule matematiche, agli articoli scientifici e alle opere lunghe.

Se LaTeX è imbattibile per la produzione di PDF accademici, è invece poco compatibile con il web: un browser non legge il LaTeX, legge HTML. Il nostro strumento LaTeX verso HTML risponde precisamente a questa esigenza: prendere un frammento di sorgente LaTeX e restituirlo in HTML direttamente integrabile in un blog, un CMS, una pagina di un sito o un'email.

L'inverso del nostro HTML verso LaTeX

La nostra cassetta degli attrezzi propone già un convertitore HTML verso LaTeX che prende HTML e produce un PDF tramite pdflatex. Il presente strumento è l'operazione inversa: da LaTeX a HTML. I due strumenti si usano insieme in catene editoriali:

• Scrivete un articolo scientifico in LaTeX, ne volete pubblicare la versione web: LaTeX verso HTML.
• Recuperate un testo HTML da un CMS, volete farne un PDF accademico pulito: HTML verso LaTeX.
• Volete mantenere una sola sorgente LaTeX e declinarla in PDF + pagina web: combinate i due strumenti o usate LaTeX verso HTML per generare la versione web.

Mappatura LaTeX verso HTML

Il nostro convertitore riconosce i comandi LaTeX comuni e applica la seguente mappatura:

• \section{Titre} e \section*{Titre} → <h1>Titre</h1>
• \subsection{Titre} → <h2>Titre</h2>
• \subsubsection{Titre} → <h3>Titre</h3>
• \paragraph{Titre} → <h4>Titre</h4>
• \textbf{x} → <strong>x</strong>
• \textit{x} e \emph{x} → <em>x</em>
• \underline{x} → <u>x</u>
• \texttt{x} → <code>x</code>
• \begin{itemize} \item ... \end{itemize} → <ul><li>...</li></ul>
• \begin{enumerate} \item ... \end{enumerate} → <ol><li>...</li></ol>
• \begin{quote} ... \end{quote} → <blockquote>...</blockquote>
• Righe vuote che separano paragrafi → <p>...</p>
• \\ e \newline → <br>
• Escape \&, \%, \$, \#, \_, \{, \} → caratteri corrispondenti
• Preambolo (\documentclass, \usepackage, \begin{document}, \end{document}) → rimosso silenziosamente

Esempio di utilizzo

Sorgente LaTeX:

\section*{Introduction}
Voici un \textbf{exemple} de document avec une liste :

\begin{itemize}
\item premier point
\item deuxième point
\end{itemize}

Et une \textit{citation} pour finir.

Risultato HTML:

<h1>Introduction</h1>
<p>Voici un <strong>exemple</strong> de document avec une liste :</p>
<ul><li>premier point</li><li>deuxième point</li></ul>
<p>Et une <em>citation</em> pour finir.</p>

Casi d'uso

• Migrazione di una tesi verso un blog: avete redatto la vostra tesi in LaTeX, ne volete pubblicare alcuni capitoli sul vostro blog o sito personale. Il convertitore fa l'essenziale del grosso del lavoro, vi resta solo da curare la formattazione finale.
• Estrazione di contenuto di un paper scientifico: riprendere l'introduzione, l'abstract o la conclusione di un articolo LaTeX esistente per ripubblicarla sul web (pagina progetto, comunicazione di laboratorio).
• Preparazione di supporto pedagogico: un corso redatto in LaTeX può essere riversato in HTML per alimentare un Moodle, un wiki o una piattaforma di e-learning.
• Documentazione tecnica: passare una nota tecnica LaTeX in HTML per diffonderla su Confluence, GitHub Pages o un intranet.
• Anteprima rapida: visualizzare come apparirebbe un frammento LaTeX in HTML, senza lanciare una compilazione pdflatex completa.

Limitazioni

Il nostro convertitore è volutamente pragmatico: mira a coprire il 90% dei casi comuni con un'implementazione semplice, piuttosto che pretendere una copertura esaustiva di tutta la sintassi LaTeX. Concretamente:

• Niente formule matematiche complesse. Le espressioni $x^2$ e \begin{equation}...\end{equation} sono preservate così come sono. Per una resa matematica web, integrate MathJax o KaTeX nella vostra pagina.
• Niente figure, tabelle o bibliografie. I comandi \includegraphics, \begin{table}, \bibliography non sono tradotti.
• Niente macro personalizzate. Un \newcommand{\miafunzione} non è interpretato: il convertitore riconosce solo i comandi standard di LaTeX.
• Stile minimo. L'output è HTML semantico senza CSS incorporato: libero a voi di aggiungere il vostro foglio di stile.

Per conversioni più avanzate, strumenti come Pandoc coprono una superficie LaTeX maggiore. Il nostro strumento mira al bisogno comune: recuperare rapidamente HTML pulito da un frammento LaTeX, senza installare software.

Come usare il convertitore

1. Incollate la vostra sorgente LaTeX nel campo di testo (un frammento o un documento completo, il preambolo sarà ignorato).
2. Cliccate su convertire.
3. Ottenete l'HTML corrispondente: copiatelo nel vostro editor, CMS o file statico.
4. Per l'operazione inversa, usate il nostro convertitore HTML verso LaTeX.

Domande frequenti

Esempio di richiesta

curl -X POST https://cdrn.fr/api/v1/tools/latex-to-html-converter/execute \
  -H "Content-Type: application/json" \
  -d '{"latex":"..."}'

Schema di input

Endpoint

• GET https://cdrn.fr/api/v1/tools - elenca tutti gli strumenti disponibili
• GET https://cdrn.fr/api/v1/tools/latex-to-html-converter - recupera lo schema di questo strumento
• POST https://cdrn.fr/api/v1/tools/latex-to-html-converter/execute - esegue questo strumento con un payload JSON