Какво е LaTeX?

LaTeX е система за съставяне на документи, широко използвана в научни, академични и технически. Изобретен от Лесли Лампорт в началото на 80-те години, той се базира на TeX типографската машина на Donald Knuth. Вместо да напишете документ с WYSIWYG редактор (подобно на Word), авторът описва логическата структура на съдържанието чрез команди: \section{Въведение}, extbf{important}, egin{itemize}... След това компилаторът създава PDF файл със забележително типографско качество, особено подходящ за математически формули, научни статии и дълги трудове.

Ако LaTeX е непобедим за създаване на академични PDF файлове, той обаче не е много съвместим с уеб: браузърът не чете LaTeX, той чете HTML. Нашият инструмент LaTeX към HTML отговаря точно на тази нужда: вземете изходен фрагмент на LaTeX и изобразете го в HTML, който може да бъде директно интегриран в блог, CMS, страница на сайт или имейл.

Обратното на нашия HTML към LaTeX

Нашата кутия с инструменти вече предлага конвертор HTML към LaTeX, който взема HTML и създава PDF чрез pdflatex. Този инструмент е обратната операция: от LaTeX към HTML. Използват се и двата инструмента заедно в редакционните канали:

• Вие пишете научна статия в LaTeX, искате да публикувате уеб версията: LaTeX vers HTML.
• Вие извличате HTML текст от CMS, искате да го превърнете в чист академичен PDF: HTML към LaTeX.
• Искате да поддържате един източник на LaTeX и да го преведете в PDF + уеб страница: комбинирайте двете инструменти или използвайте LaTeX към HTML за генериране на уеб версията.

Съпоставяне на LaTeX срещу HTML

Нашият конвертор разпознава често срещаните команди на LaTeX и прилага следното картографиране:

• \section{Заглавие} и \section*{Заглавие} →

  Заглавие

• \subsection{Заглавие} →

  Заглавие

• \subsubsection{Заглавие} →

  Заглавие

• \paragraph{Заглавие} →

  Заглавие

• extbf{x} → x
• exit{x} и mph{x} → x
• \underline{x} → x
• exttt{x} → x
• egin{itemize} \item ... nd{itemize} →
  • ...
• egin{enumerate} \item ... nd{enumerate} →
  1. ...
• egin{quote} ... nd{quote} →

  ...

• Празни редове, разделящи абзаци →

  ...

• \ и ewline →

• Escapes \&, \%, \$, \#, \_, \{, \} → съответстващи знаци
• Преамбюл (\documentclass, \usepackage, egin{document}, nd{document}) → тихо изтрит

Пример за използване

Източник на LaTeX:

\section*{Въведение}
Ето extbf{example} документ със списък:

egin{itemize}
\item първа точка
\item втора точка
nd{itemize}

И extit{quote} за завършване.

HTML резултат:

Въведение
Ето пример за документ със списък:
първа точка 
втора точка 
И цитат за завършек.

Случаи на употреба

• Мигриране на дипломна работа в блог: написали сте дипломната си работа в LaTeX, искате да публикувате глави във вашия блог или личен сайт. Конверторът го прави по-голямата част от структурната работа, всичко, което трябва да направите, е да се погрижите за крайния формат.
• Извличане на съдържание от научна статия: повторете въведението, резюмето или заключение на съществуваща статия в LaTeX, за да я публикувате отново в мрежата (страница на проекта, комуникация лаборатория).
• Подготовка на образователна подкрепа: може да се премине към курс, написан на LaTeX HTML за захранване на Moodle, wiki или платформа за електронно обучение.
• Техническа документация: предайте техническа бележка на LaTeX в HTML, за да я разпространявате в Confluence, GitHub Pages или интранет.
• Бърз преглед: визуализирайте как би изглеждал LaTeX фрагмент в HTML, без стартирайте пълна pdflatex компилация.

Ограничения

Нашият конвертор е съзнателно прагматичен: цели да покрие 90% от случаите общи с проста реализация, вместо да се претендира за изчерпателно покритие на всички Синтаксис на LaTeX. Конкретно:

• Без сложни математически формули. Изразите $x^2$ и egin{equation}... nd{equation} се запазват такива, каквито са. За рендиране уеб математика, интегрирайте MathJax или KaTeX във вашата страница.
• Без фигури, таблици или библиографии. Командите \includegraphics, egin{table}, ibliography не са преведени.
• Без персонализирани макроси. A ewcommand{\myfunction} не е интерпретиран: конверторът разпознава само стандартни LaTeX команди.
• Минимален стил. Резултатът е семантичен HTML без вграден CSS: зависи от вас за да добавите свой собствен стилов лист.

За по-задълбочени преобразувания инструменти като Pandoc покриват по-голяма област LaTeX. Нашият инструмент е насочен към общата нужда: бързо възстановяване на чист HTML от фрагмент LaTeX, без инсталиране на софтуер.

Как да използвате конвертора

1. Поставете вашия източник на LaTeX в текстовото поле (фрагмент или пълен документ, преамбюла ще бъдат игнорирани).
2. Щракнете върху конвертиране.
3. Получавате съответния HTML: копирайте го във вашия редактор, вашата CMS или във вашия файл статичен.
4. За обратната операция използвайте нашия Конвертор от HTML към LaTeX.

Често задавани въпроси

Пример за заявка

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

Входна схема

Крайни точки

• GET https://cdrn.fr/api/v1/tools - изброява всички достъпни инструменти
• GET https://cdrn.fr/api/v1/tools/latex-to-html-converter - извлича схемата на този инструмент
• POST https://cdrn.fr/api/v1/tools/latex-to-html-converter/execute - изпълнява този инструмент с JSON payload