Konwertuj LaTeX do HTML

Czym jest LaTeX?

LaTeX to system składu dokumentów bardzo popularny w środowiskach naukowych, akademickich i technicznych. Wynaleziony przez Leslie Lamporta na początku lat 1980, opiera się na silniku typograficznym TeX Donalda Knutha. Zamiast pisać dokument za pomocą edytora WYSIWYG (jak Word), autor opisuje logiczną strukturę treści za pomocą poleceń: \section{Introduction}, \textbf{important}, \begin{itemize}... Kompilator produkuje wtedy PDF o niezwykłej jakości typograficznej, szczególnie odpowiedni dla wzorów matematycznych, artykułów naukowych i długich publikacji.

Choć LaTeX jest niepokonany w produkcji akademickich PDF, jest mało kompatybilny z siecią: przeglądarka nie czyta LaTeX, czyta HTML. Nasze narzędzie LaTeX na HTML odpowiada dokładnie na tę potrzebę: bierze fragment źródła LaTeX i zwraca go w HTML bezpośrednio gotowym do osadzenia w blogu, CMS, stronie internetowej lub e-mailu.

Odwrotność naszego HTML na LaTeX

Nasza skrzynka narzędziowa oferuje już konwerter HTML na LaTeX, który bierze HTML i produkuje PDF przez pdflatex. To narzędzie to operacja odwrotna: z LaTeX na HTML. Oba narzędzia używa się razem w łańcuchach redakcyjnych:

• Piszesz artykuł naukowy w LaTeX, chcesz opublikować jego wersję webową: LaTeX na HTML.
• Pobierasz tekst HTML z CMS, chcesz z niego zrobić czysty PDF akademicki: HTML na LaTeX.
• Chcesz utrzymywać jedno źródło LaTeX i odmieniać je w PDF + stronę internetową: połącz oba narzędzia lub użyj LaTeX na HTML, aby wygenerować wersję webową.

Mapowanie LaTeX na HTML

Nasz konwerter rozpoznaje popularne polecenia LaTeX i stosuje następujące mapowanie:

• \section{Titre} i \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} 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>
• Puste linie oddzielające akapity → <p>...</p>
• \\ i \newline → <br>
• Escapowanie \&, \%, \$, \#, \_, \{, \} → odpowiadające znaki
• Preambuła (\documentclass, \usepackage, \begin{document}, \end{document}) → usuwana w ciszy

Przykład użycia

Źródło 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.

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

Przypadki użycia

• Migracja pracy doktorskiej do bloga: napisałeś swoją pracę w LaTeX, chcesz opublikować jej rozdziały na blogu lub osobistej stronie. Konwerter wykonuje większość ciężkiej pracy, pozostaje tylko dopracować finalne formatowanie.
• Wyodrębnienie treści z naukowego papieru: przejęcie wstępu, streszczenia lub zakończenia istniejącego artykułu LaTeX w celu ponownej publikacji w sieci (strona projektu, komunikacja laboratorium).
• Przygotowanie materiału dydaktycznego: kurs napisany w LaTeX można przerzucić na HTML, aby zasilić Moodle, wiki lub platformę e-learning.
• Dokumentacja techniczna: przeniesienie notatki technicznej LaTeX na HTML, aby rozpowszechnić ją w Confluence, GitHub Pages lub intranecie.
• Szybki podgląd: zwizualizowanie, jak wyglądałby fragment LaTeX w HTML, bez uruchamiania pełnej kompilacji pdflatex.

Ograniczenia

Nasz konwerter jest celowo pragmatyczny: dąży do pokrycia 90% typowych przypadków za pomocą prostej implementacji, zamiast pretendować do wyczerpującego pokrycia całej składni LaTeX. Konkretnie:

• Brak złożonych wzorów matematycznych. Wyrażenia $x^2$ i \begin{equation}...\end{equation} są zachowywane w niezmienionej formie. Dla webowego renderingu matematycznego osadź MathJax lub KaTeX na swojej stronie.
• Brak rysunków, tabel ani bibliografii. Polecenia \includegraphics, \begin{table}, \bibliography nie są tłumaczone.
• Brak niestandardowych makr. \newcommand{\mafonction} nie jest interpretowane: konwerter rozpoznaje tylko standardowe polecenia LaTeX.
• Minimalny styl. Wyjście to semantyczny HTML bez osadzonego CSS: dodaj własny arkusz stylów.

Dla bardziej zaawansowanych konwersji narzędzia takie jak Pandoc pokrywają większą powierzchnię LaTeX. Nasze narzędzie celuje w typową potrzebę: szybkie uzyskanie czystego HTML z fragmentu LaTeX, bez instalowania oprogramowania.

Jak korzystać z konwertera

1. Wklej swoje źródło LaTeX w polu tekstowym (fragment lub kompletny dokument, preambuła zostanie zignorowana).
2. Kliknij konwertuj.
3. Otrzymujesz odpowiadający HTML: skopiuj go do swojego edytora, CMS lub pliku statycznego.
4. Dla operacji odwrotnej użyj naszego konwertera HTML na LaTeX.

Najczęściej zadawane pytania

Przykładowe zapytanie

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

Schemat wejściowy

Punkty końcowe

• GET https://cdrn.fr/api/v1/tools - lista wszystkich dostępnych narzędzi
• GET https://cdrn.fr/api/v1/tools/latex-to-html-converter - zwraca schemat dla tego narzędzia
• POST https://cdrn.fr/api/v1/tools/latex-to-html-converter/execute - uruchamia to narzędzie z payloadem JSON