CDRN

Konverzia LaTeXu na HTML

  • Dashboard
  • Dokumentácia
  • API
konvertuje váš LaTeX zdroj do HTML, ideálne na publikovanie vašich článkov, rovníc a akademických dokumentov na webe

Čo je LaTeX?

LaTeX je systém na sadzbu dokumentov veľmi používaný vo vedeckých, akademických a technických prostrediach. Vynašiel ho Leslie Lamport na začiatku 80. rokov, opiera sa o typografický engine TeX od Donalda Knutha. Namiesto písania dokumentu vo WYSIWYG editore (ako Word) autor opisuje logickú štruktúru obsahu cez príkazy: \section{Introduction}, \textbf{important}, \begin{itemize}... Kompilátor potom produkuje PDF pozoruhodnej typografickej kvality, obzvlášť vhodný pre matematické vzorce, vedecké články a dlhé diela.

Ak je LaTeX nepriestrelný pre produkciu akademického PDF, je naopak málo kompatibilný s webom: prehliadač nečíta LaTeX, číta HTML. Náš nástroj LaTeX na HTML presne odpovedá na túto potrebu: zobrať fragment LaTeX zdroja a obnoviť ho v HTML priamo integrovateľnom do blogu, CMS, stránky alebo emailu.

Opak nášho HTML na LaTeX

Náš toolbox už ponúka konvertor HTML na LaTeX, ktorý berie HTML a produkuje PDF cez pdflatex. Tento nástroj je opačná operácia: z LaTeX na HTML. Oba nástroje sa používajú spolu v redakčných reťazcoch:

  • Napíšete vedecký článok v LaTeX, chcete publikovať jeho web verziu: LaTeX na HTML.
  • Získate HTML text z CMS, chcete z neho urobiť čisté akademické PDF: HTML na LaTeX.
  • Chcete udržiavať jediný LaTeX zdroj a derivovať PDF + webovú stránku: kombinujte oba nástroje alebo použite LaTeX na HTML pre generovanie web verzie.

Mapping LaTeX na HTML

Náš konvertor rozpoznáva bežné LaTeX príkazy a aplikuje nasledujúci mapping:

  • \section{Titul} a \section*{Titul} → <h1>Titul</h1>
  • \subsection{Titul} → <h2>Titul</h2>
  • \subsubsection{Titul} → <h3>Titul</h3>
  • \paragraph{Titul} → <h4>Titul</h4>
  • \textbf{x} → <strong>x</strong>
  • \textit{x} a \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>
  • Prázdne riadky oddeľujúce odseky → <p>...</p>
  • \\ a \newline → <br>
  • Escapovania \&, \%, \$, \#, \_, \{, \} → zodpovedajúce znaky
  • Preambula (\documentclass, \usepackage, \begin{document}, \end{document}) → ticho odstránená

Príklad použitia

LaTeX zdroj:

\section*{Uvod}
Tu je \textbf{priklad} dokumentu so zoznamom:

\begin{itemize}
\item prvy bod
\item druhy bod
\end{itemize}

A \textit{citacia} na zaver.

HTML výsledok:

<h1>Uvod</h1>
<p>Tu je <strong>priklad</strong> dokumentu so zoznamom:</p>
<ul><li>prvy bod</li><li>druhy bod</li></ul>
<p>A <em>citacia</em> na zaver.</p>

Prípady použitia

  • Migrácia dizertácie na blog: napísali ste dizertáciu v LaTeX, chcete publikovať kapitoly na vašom blogu alebo osobnej stránke. Konvertor robí podstatu hrubej práce, vám stačí len doladiť finálne formátovanie.
  • Extrakcia obsahu vedeckého papiera: prevziať úvod, abstrakt alebo záver z existujúceho LaTeX článku pre jeho opätovné publikovanie na webe (projektová stránka, laboratórna komunikácia).
  • Príprava pedagogického materiálu: kurz napísaný v LaTeX môže byť prepnutý do HTML pre napájanie Moodle, wiki alebo e-learningovej platformy.
  • Technická dokumentácia: previesť technickú LaTeX poznámku do HTML pre distribúciu na Confluence, GitHub Pages alebo intranete.
  • Rýchly náhľad: vizualizovať, ako by vyzeral LaTeX fragment v HTML, bez spustenia kompletnej pdflatex kompilácie.

Obmedzenia

Náš konvertor je zámerne pragmatický: cieli pokryť 90 % bežných prípadov jednoduchou implementáciou, namiesto pretendovania na vyčerpávajúce pokrytie celej LaTeX syntaxe. Konkrétne:

  • Žiadne komplexné matematické vzorce. Výrazy $x^2$ a \begin{equation}...\end{equation} sú zachované tak, ako sú. Pre webový matematický render integrujte MathJax alebo KaTeX do vašej stránky.
  • Žiadne figury, tabuľky alebo bibliografie. Príkazy \includegraphics, \begin{table}, \bibliography nie sú preložené.
  • Žiadne vlastné makrá. \newcommand{\mojafunkcia} nie je interpretovaná: konvertor rozpoznáva iba štandardné LaTeX príkazy.
  • Minimálny štýl. Výstup je sémantický HTML bez embedovaného CSS: slobodne pridajte vlastný stylesheet.

Pre pokročilejšie konverzie nástroje ako Pandoc pokrývajú väčšiu plochu LaTeXu. Náš nástroj cieli bežnú potrebu: rýchlo získať čistý HTML z LaTeX fragmentu, bez inštalácie softvéru.

Ako používať konvertor

  1. Vložte váš LaTeX zdroj do textového poľa (fragment alebo kompletný dokument, preambula bude ignorovaná).
  2. Kliknite na konvertovať.
  3. Získate zodpovedajúci HTML: skopírujte ho do vášho editora, CMS alebo statického súboru.
  4. Pre opačnú operáciu použite náš HTML na LaTeX konvertor.

Často kladené otázky

Spravuje konvertor matematické vzorce?

Matematický LaTeX ($x^2 + y^2$, \begin{equation}) je zachovaný tak, ako je, vo HTML výstupe. Pre vizuálny render pridajte MathJax alebo KaTeX do vašej webovej stránky: tieto knižnice renderujú matematický LaTeX na strane prehliadača.

Moje vlastné príkazy (\newcommand) nie sú preložené, prečo?

Konvertor nespúšťa TeX engine, robí syntaktický mapping. Macro definované cez \newcommand nie je rozvinuté. Pred konverziou nahraďte vaše makrá ich explicitnou definíciou, alebo použite Pandoc, ktorý má kompletnejší parser.

Je LaTeX preambula povinná vo vstupe?

Nie. Môžete vložiť fragment bez \documentclass alebo \begin{document}. Ak váš zdroj obsahuje kompletnú preambulu, je napriek tomu ignorovaná: konvertovaný je iba užitočný obsah.

Sú akcentované znaky správne spravované?

Áno, za podmienky, že váš LaTeX zdroj je v UTF-8 (s alebo bez \usepackage[utf8]{inputenc}). Staré LaTeX notácie ako \'e pre é nie sú explicitne preložené, preferujte priame UTF-8.

Sú moje dáta odosielané a ukladané?

LaTeX je spracovaný na strane servera počas trvania konverzie, potom je výsledok vrátený vášmu prehliadaču. Žiadne dáta nie sú uložené, indexované ani zdieľané.

Prečo získať HTML skôr než PDF?

HTML je natívny formát webu: stránky, blogy, emaily, CMS. Ak je vaša finálna potreba PDF, použite radšej náš HTML na LaTeX konvertor, ktorý produkuje PDF cez pdflatex.

Ukážka požiadavky

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

Vstupná schéma

Pole Typ Povinné Predvolené
latex text ✓ –

Koncové body

  • GET https://cdrn.fr/api/v1/tools - vypíše všetky dostupné nástroje
  • GET https://cdrn.fr/api/v1/tools/latex-to-html-converter - získa schému tohto nástroja
  • POST https://cdrn.fr/api/v1/tools/latex-to-html-converter/execute - spustí tento nástroj s JSON payloadom