Muunna LaTeX HTML:ksi

Mikä on LaTeX?

LaTeX on asiakirjojen ladontajärjestelmä, jota käytetään laajalti tieteellisissä, akateemisissa ja teknisissä piireissä. Leslie Lamportin 1980-luvun alussa keksimä järjestelmä perustuu Donald Knuthin TeX-typografiseen moottoriin. Sen sijaan, että kirjoittaja kirjoittaisi asiakirjan WYSIWYG-editorilla (kuten Word), hän kuvailee sisällön loogisen rakenteen komentojen avulla: \section{Introduction}, \textbf{important}, \begin{itemize}... Kääntäjä tuottaa tällöin typografisesti erinomaisen PDF-tiedoston, joka soveltuu erityisen hyvin matemaattisille kaavoille, tieteellisille artikkeleille ja pitkille teoksille.

Vaikka LaTeX on lyömätön akateemisten PDF-tiedostojen tuottamisessa, se on huonosti yhteensopiva verkon kanssa : selain ei lue LaTeXia, vaan se lukee HTML:ää. Meidän **LaTeXista HTML:ksi** -työkalumme vastaa juuri tähän tarpeeseen : ottaa LaTeX-lähdekoodin osan ja muuntaa sen HTML:ksi, joka on suoraan integroitavissa blogiin, CMS-järjestelmään, verkkosivulle tai sähköpostiin.

HTML:stä LaTeXiksi -muuntimemme vastakohta

Työkalupakkimme tarjoaa jo muuntimen HTML:stä LaTeXiksi joka ottaa HTML:ää ja tuottaa PDF-tiedoston pdflatexin kautta. Tämä työkalu on käänteinen toiminto : LaTeXista HTML:ksi. Molempia työkaluja käytetään yhdessä toimitusketjuissa :

• Kirjoitat tieteellistä artikkelia LaTeXilla ja haluat julkaista siitä verkkoversion : LaTeXista HTML:ksi.
• Haet HTML-tekstiä CMS-järjestelmästä ja haluat tehdä siitä siistin akateemisen PDF-tiedoston : HTML:stä LaTeXiksi.
• Haluat ylläpitää vain yhtä LaTeX-lähdettä ja tehdä siitä sekä PDF- että verkkosivuversion : yhdistä molemmat työkalut tai käytä LaTeXista HTML:ksi -muunninta verkkoversion luomiseen.

Mapping LaTeXista HTML:ksi

Muuntimemme tunnistaa yleiset LaTeX-komennot ja soveltaa seuraavaa vastaavuutta :

• \section{Otsikko} ja \section*{Otsikko} → <h1>Otsikko</h1>
• \subsection{Otsikko} → <h2>Otsikko</h2>
• \subsubsection{Otsikko} → <h3>Otsikko</h3>
• \paragraph{Otsikko} → <h4>Otsikko</h4>
• \textbf{x} → <strong>x</strong>
• \textit{x} ja \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>
• Kappaleita erottavat tyhjät rivit → <p>...</p>
• \\ ja \newline → <br>
• Échappements \&, \%, \$, \#, \_, \{, \} → vastaavat merkit
• Esipuhe (\documentclass, \usepackage, \begin{document}, \end{document}) → poistetaan hiljaisesti

Käyttöesimerkki

LaTeX-lähde :

\section*{Introduction}
Tässä on \textbf{esimerkki} dokumentista, jossa on luettelo :

\begin{itemize}
\item ensimmäinen kohta
\item toinen kohta
\end{itemize}

Ja \textit{sitaatti} lopuksi.

HTML-tulos:

<h1>Johdanto</h1>
<p>Tässä on <strong>esimerkki</strong> dokumentista, jossa on luettelo:</p>
<ul><li>ensimmäinen kohta</li><li>toinen kohta</li></ul>
<p>Ja <em>sitaatti</em> lopuksi.</p>

Käyttötapaukset

• Väitöskirjan siirtäminen blogiin : olet kirjoittanut väitöskirjasi LaTeXilla, haluat julkaista lukuja siitä blogissasi tai henkilökohtaisella sivustollasi. Muunnin tekee suurimman osan työstä, sinun tarvitsee vain viimeistellä muotoilu.
• Sisällön poimiminen tieteellisestä artikkelista : LaTeX-artikkelin johdannon, tiivistelmän tai johtopäätösten ottaminen uudelleenjulkaisua varten verkossa (projektisivu, laboratorion viestintä).
• Opetusmateriaalin valmistelu : LaTeXilla kirjoitettu kurssi voidaan muuntaa HTML-muotoon Moodlen, wikin tai e-oppimisalustan käyttöön.
• Tekninen dokumentaatio : LaTeX-muotoisen teknisen muistion muuntaminen HTML-muotoon Confluenceen, GitHub Pagesiin tai intranetiin julkaisemista varten.
• Pikakatselu : visualisoida, miltä LaTeX-katkelma näyttäisi HTML-muodossa ilman täydellistä pdflatex-käännöstä.

Rajoitukset

Muuntimemme on tietoisesti pragmaattinen : sen tavoitteena on kattaa 90 % yleisistä tapauksista yksinkertaisella toteutuksella sen sijaan, että se pyrkisi kattamaan kaiken LaTeX-syntaksin. Käytännössä :

• Ei monimutkaisia matemaattisia kaavoja. Ilmaisut $x^2$ ja \begin{equation}...\end{equation} säilytetään sellaisenaan. Matemaattista verkkonäyttöä varten integroi MathJax tai KaTeX sivullesi.
• Ei kuvioita, taulukoita tai bibliografioita. Komentoja \includegraphics, \begin{table}, \bibliography ei käännetä.
• Ei mukautettuja makroja. Komentoa \newcommand{\mafonction} ei tulkita : muunnin tunnistaa vain LaTeXin vakiokomennot.
• Minimaalinen tyyli. Tuloste on semanttista HTML:ää ilman upotettua CSS:ää : voit vapaasti lisätä oman tyylitiedostosi.

Edistyneempiä muunnoksia varten työkalut kuten Pandoc kattavat laajemman LaTeX-alueen. Työkalumme vastaa yleiseen tarpeeseen : puhtaan HTML:n nopea saaminen LaTeX-katkelmasta ilman ohjelmistojen asennusta.

Kuinka muunninta käytetään

1. Liitä LaTeX-lähteesi tekstikenttään (katkelma tai kokonainen dokumentti, esipuhe jätetään huomioimatta).
2. Napsauta muunna.
3. Saat vastaavan HTML-koodin : kopioi se editoriisi, julkaisujärjestelmääsi tai staattiseen tiedostoosi.
4. Käänteistä toimintoa varten käytä HTML-LaTeX-muunnintamme.

Usein kysytyt kysymykset

Pyyntöesimerkki

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

Syöteskeema

Päätepisteet

• GET https://cdrn.fr/api/v1/tools - listaa kaikki saatavilla olevat työkalut
• GET https://cdrn.fr/api/v1/tools/latex-to-html-converter - hakee tämän työkalun skeeman
• POST https://cdrn.fr/api/v1/tools/latex-to-html-converter/execute - suorittaa tämän työkalun JSON-payloadilla