Paversti LaTeX į HTML
- Skydelis
- Dokumentacija
- API
Kas yra LaTeX?
LaTeX yra plačiai naudojama dokumentų sudarymo sistema
mokslinis, akademinis ir techninis. Devintojo dešimtmečio pradžioje išrado Leslie Lamport, jis pagrįstas
Donaldo Knutho TeX tipografiniame variklyje. Užuot rašę dokumentą naudodami WYSIWYG redaktorių
(kaip ir Word), autorius aprašo loginę turinio struktūrą komandomis:
\section{Introduction}, extbf{important}, egin{itemize}...
Tada kompiliatorius sukuria nepaprastos tipografinės kokybės PDF, ypač tinkantį
matematines formules, mokslinius straipsnius ir ilgus darbus.
Jei LaTeX yra nepralenkiamas kuriant akademinius PDF failus, jis nėra labai suderinamas žiniatinklis: naršyklė neskaito LaTeX, ji skaito HTML. Mūsų įrankis LaTeX į HTML tiksliai reaguoja į šį poreikį: paimkite LaTeX šaltinio fragmentą ir pateikti jį HTML formatu, kuris gali būti tiesiogiai integruotas į tinklaraštį, TVS, svetainės puslapį arba el.
Mūsų HTML atvirkštinis LaTeX
Mūsų įrankių rinkinyje jau yra keitiklis HTML į LaTeX, kuri paima HTML ir sukuria PDF per pdflatex. Šis įrankis yra atvirkštinis: nuo LaTeX iki HTML. Naudojami abu įrankiai kartu redakcijos kanaluose:
- Rašote mokslinį straipsnį LaTeX, norite paskelbti žiniatinklio versiją: LaTeX vers HTML.
- Gaunate HTML tekstą iš TVS ir norite jį paversti švariu akademiniu PDF formatu: HTML į LaTeX.
- Norite išlaikyti vieną LaTeX šaltinį ir išversti jį į PDF + tinklalapį: sujunkite abu įrankiai arba naudokite LaTeX į HTML, kad sukurtumėte žiniatinklio versiją.
LaTeX susiejimas su HTML
Mūsų keitiklis atpažįsta įprastas LaTeX komandas ir taiko tokį atvaizdavimą:
\section{Title}ir\section*{Title}→Pavadinimas
\subsection{Title}→Pavadinimas
\subsubsection{Title}→Pavadinimas
\paragraph{Title}→Pavadinimas
extbf{x}→xextit{x}irmph{x}→x\underline{x}→xexttt{x}→xegin{itemize} \item ... nd{itemize}→- ...
egin{enumerate} \item ... nd{enumerate}→- ...
egin{quote} ... nd{quote}→...
- Tuščios eilutės, skiriančios pastraipas →
...
\irewline→- Pabėgimas:
\&,\%,\$,\#,\_,\{,\}→ atitinkantys simboliai - Preambulė (
\documentclass,\usepackage,egin{document},nd{document}) → tyliai ištrinta
Naudojimo pavyzdys
LaTeX šaltinis:
\section*{Įvadas}
Čia yra extbf{example} dokumentas su sąrašu:
egin{itemize}
\item pirmasis taškas
\item antras taškas
nd{itemize}
Ir išėjimas{quote}, kad užbaigtumėte.
HTML rezultatas:
Įvadas
Čia yra pavyzdys dokumento su sąrašu:
- pirmas taškas
- antrasis taškas
Ir citata pabaigai.
Naudojimo atvejai
- Dezės perkėlimas į tinklaraštį: baigiamąjį darbą parašėte LaTeX, norite skelbti skyrius savo tinklaraštyje arba asmeninėje svetainėje. Keitiklis tai daro didžiąją dalį konstrukcinių darbų, tereikia pasirūpinti galutiniu formatu.
- Turinio ištraukimas iš mokslinio darbo: pakartokite įvadą, santrauką arba esamo LaTeX straipsnio išvada, norint jį pakartotinai paskelbti internete (projekto puslapyje, komunikacijoje laboratorija).
- Mokymosi pagalbos parengimas: galima pereiti prie LaTeX parašyto kurso HTML, kad palaikytų Moodle, wiki ar el. mokymosi platformą.
- Techninė dokumentacija: perduokite LaTeX techninę pastabą HTML, kad ją platintumėte „Confluence“, „GitHub“ puslapiuose arba intranete.
- Greita peržiūra: vizualizuokite, kaip LaTeX fragmentas atrodytų HTML, be paleiskite visą pdflatex kompiliaciją.
Apribojimai
Mūsų keitiklis yra sąmoningai pragmatiškas: juo siekiama padengti 90 proc. bendras su paprastu įgyvendinimu, o ne reikalauti, kad būtų visapusiškai aprėpta LaTeX sintaksė. Konkrečiai:
- Jokių sudėtingų matematinių formulių. Išraiškos
$x^2$iregin{equation}... nd{equation}išsaugomi tokie, kokie yra. Dėl atvaizdavimo žiniatinklio matematiką, į savo puslapį integruoti MathJax arba KaTeX. - Jokių paveikslų, lentelių ar bibliografijų. Komandos
\includegraphics,egin{table},ibliographynėra išverstos. - Nėra tinkintų makrokomandų. A
ewcommand{\myfunction}nėra interpretuojama: keitiklis atpažįsta tik standartines LaTeX komandas. - Minimalus stilius. Išvestis yra semantinis HTML be įterptosios CSS: tai priklauso nuo jūsų kad pridėtumėte savo stiliaus lapą.
Norėdami atlikti išsamesnes konversijas, įrankiai, tokie kaip Pandoc, apima didesnį plotą LaTeX. Mūsų įrankis skirtas bendram poreikiui: greitai atkurti švarų HTML iš fragmento LaTeX, neįdiegę jokios programinės įrangos.
Kaip naudotis konverteriu
- Įklijuokite LaTeX šaltinį į teksto lauką (fragmentą arba visą dokumentą, preambulę bus nepaisoma).
- Spustelėkite konvertuoti.
- Gaunate atitinkamą HTML: nukopijuokite jį į redaktorių, TVS arba failą statinis.
- Atvirkščiai operacijai naudokite mūsų HTML į LaTeX keitiklis.
Dažnai užduodami klausimai
Ar keitiklis palaiko matematines formules?
Matematinė LaTeX ($x^2 + y^2$, egin{equation}) paliekama tokia, kokia yra
HTML išvestyje. Norėdami vizualiai atvaizduoti, pridėkite MathJax arba KaTeX į savo tinklalapį: tai
Bibliotekos daro LaTeX matematinį naršyklės pusėje.
Mano pasirinktiniai užsakymai ( ewcommand) nėra išverstos, kodėl?
Konverteris neveikia TeX variklio, jis atlieka sintaksinį atvaizdavimą. Makrokomandą apibrėžia
ewcommand nėra išplėstas. Prieš konvertuodami pakeiskite makrokomandas jų
aiškų apibrėžimą arba naudokite „Pandoc“, kuris turi išsamesnį analizatorių.
Ar įvestyje būtina LaTeX preambulė?
Ne. Galite įklijuoti fragmentą be \documentclass arba
egin{document}. Jei jūsų šaltinyje yra visa preambulė, ji vis tiek yra
ignoruojamas: konvertuojamas tik naudingas turinys.
Ar kirčiuoti simboliai tvarkomi teisingai?
Taip, jei jūsų LaTeX šaltinis yra UTF-8 (su arba be \usepackage[utf8]{inputenc}).
Seni LaTeX žymėjimai, pvz., \'e, skirti é, nėra aiškiai nurodyti
išversta, pirmenybę teikia tiesioginiam UTF-8.
Ar mano duomenys siunčiami ir saugomi?
Konvertavimo metu LaTeX apdorojamas serverio pusėje, tada rezultatas siunčiamas atgal jūsų naršyklė. Jokie duomenys nesaugomi, indeksuojami ar bendrinami.
Kodėl verta naudoti HTML, o ne PDF?
HTML yra vietinis žiniatinklio formatas: puslapiai, tinklaraščiai, el. laiškai, TVS. Jei jūsų galutinis poreikis yra PDF, vietoj to naudokite mūsų HTML į LaTeX keitiklį kuri sukuria PDF per pdflatex.
Užklausos pavyzdys
curl -X POST https://cdrn.fr/api/v1/tools/latex-to-html-converter/execute \
-H "Content-Type: application/json" \
-d '{"latex":"..."}'
Įvesties schema
| Laukas | Tipas | Privalomas | Numatytasis |
|---|---|---|---|
latex |
text | ✓ | – |
Galiniai taškai
GET https://cdrn.fr/api/v1/tools- išvardija visus galimus įrankiusGET https://cdrn.fr/api/v1/tools/latex-to-html-converter- gauna šio įrankio schemąPOST https://cdrn.fr/api/v1/tools/latex-to-html-converter/execute- vykdo šį įrankį su JSON payload