Convertirea LaTeX în HTML

Ce este LaTeX?

LaTeX este un sistem de compunere a documentelor foarte utilizat în mediile științifice, academice și tehnice. Inventat de Leslie Lamport la începutul anilor 1980, se bazează pe motorul tipografic TeX al lui Donald Knuth. În loc să scrii un document cu un editor WYSIWYG (precum Word), autorul descrie structura logică a conținutului prin comenzi: \section{Introducere}, \textbf{important}, \begin{itemize}... Compilatorul produce apoi un PDF de o calitate tipografică remarcabilă, deosebit de adaptat formulelor matematice, articolelor științifice și lucrărilor lungi.

Dacă LaTeX este de neegalat pentru producția de PDF academic, este în schimb puțin compatibil cu web-ul: un browser nu citește LaTeX, citește HTML. Instrumentul nostru LaTeX spre HTML răspunde exact acestei nevoi: a lua un fragment de sursă LaTeX și a-l reda în HTML direct integrabil într-un blog, un CMS, o pagină de site sau un email.

Inversul nostru HTML spre LaTeX

Setul nostru de instrumente propune deja un convertor HTML spre LaTeX care ia HTML și produce un PDF prin pdflatex. Instrumentul prezent este operația inversă: din LaTeX spre HTML. Cele două instrumente se utilizează împreună în lanțuri editoriale:

• Redactezi un articol științific în LaTeX, vrei să publici versiunea sa web: LaTeX spre HTML.
• Recuperezi un text HTML dintr-un CMS, vrei să faci din el un PDF academic curat: HTML spre LaTeX.
• Vrei să menții o singură sursă LaTeX și să o declini în PDF + pagină web: combină cele două instrumente sau utilizează LaTeX spre HTML pentru a genera versiunea web.

Mapping LaTeX spre HTML

Convertorul nostru recunoaște comenzile LaTeX curente și aplică mapping-ul următor:

• \section{Titlu} și \section*{Titlu} → <h1>Titlu</h1>
• \subsection{Titlu} → <h2>Titlu</h2>
• \subsubsection{Titlu} → <h3>Titlu</h3>
• \paragraph{Titlu} → <h4>Titlu</h4>
• \textbf{x} → <strong>x</strong>
• \textit{x} și \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>
• Linii goale separând paragrafe → <p>...</p>
• \\ și \newline → <br>
• Escape-uri \&, \%, \$, \#, \_, \{, \} → caractere corespunzătoare
• Preambul (\documentclass, \usepackage, \begin{document}, \end{document}) → suprimat silențios

Exemplu de utilizare

Sursă LaTeX:

\section*{Introducere}
Iată un \textbf{exemplu} de document cu o listă:

\begin{itemize}
\item primul punct
\item al doilea punct
\end{itemize}

Și un \textit{citat} pentru a încheia.

Rezultat HTML:

<h1>Introducere</h1>
<p>Iată un <strong>exemplu</strong> de document cu o listă:</p>
<ul><li>primul punct</li><li>al doilea punct</li></ul>
<p>Și un <em>citat</em> pentru a încheia.</p>

Cazuri de utilizare

• Migrarea unei teze spre un blog: ai redactat teza ta în LaTeX, vrei să publici capitole pe blog-ul tău sau site-ul personal. Convertorul face esențialul lucrării grele, mai trebuie doar să îngrijești punerea în formă finală.
• Extracție de conținut dintr-un articol științific: a relua introducerea, abstractul sau concluzia unui articol LaTeX existent pentru a-l republica pe web (pagină proiect, comunicare de laborator).
• Pregătire de suport pedagogic: un curs redactat în LaTeX poate fi basculat în HTML pentru a alimenta un Moodle, un wiki sau o platformă e-learning.
• Documentație tehnică: trecerea unei note tehnice LaTeX în HTML pentru a o difuza pe Confluence, GitHub Pages sau un intranet.
• Previzualizare rapidă: vizualizarea cum ar arăta un fragment LaTeX în HTML, fără a lansa o compilare pdflatex completă.

Limitări

Convertorul nostru este intenționat pragmatic: vizează acoperirea a 90% din cazurile curente cu o implementare simplă, în loc de a pretinde o acoperire exhaustivă a întregii sintaxe LaTeX. Concret:

• Fără formule matematice complexe. Expresiile $x^2$ și \begin{equation}...\end{equation} sunt păstrate ca atare. Pentru o randare matematică web, integrează MathJax sau KaTeX în pagina ta.
• Fără figuri, tabele, sau bibliografii. Comenzile \includegraphics, \begin{table}, \bibliography nu sunt traduse.
• Fără macros personalizate. Un \newcommand{\functia_mea} nu este interpretat: convertorul recunoaște doar comenzile standard LaTeX.
• Stil minim. Ieșirea este HTML semantic fără CSS încorporat: rămâne să adaugi propria foaie de stil.

Pentru conversii mai avansate, instrumente precum Pandoc acoperă o suprafață mai mare LaTeX. Instrumentul nostru vizează nevoia curentă: a recupera rapid HTML curat dintr-un fragment LaTeX, fără a instala software.

Cum să utilizezi convertorul

1. Lipește sursa ta LaTeX în câmpul text (un fragment sau un document complet, preambulul va fi ignorat).
2. Apasă pe convertește.
3. Obții HTML-ul corespunzător: copiază-l în editorul tău, în CMS-ul tău sau în fișierul tău static.
4. Pentru operația inversă, utilizează convertorul nostru HTML spre LaTeX.

Întrebări frecvente

Exemplu de cerere

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

Schema de intrare

Puncte de acces

• GET https://cdrn.fr/api/v1/tools - listează toate instrumentele disponibile
• GET https://cdrn.fr/api/v1/tools/latex-to-html-converter - obține schema acestui instrument
• POST https://cdrn.fr/api/v1/tools/latex-to-html-converter/execute - execută acest instrument cu un payload JSON