Уравнение латекса Haskell Haddock в комментариях

Я хотел бы использовать латексную нотацию для уравнений в моем исходном коде. Например, я бы написал следующий комментарий в какой-нибудь исходный файл Haskell Equations.hs:

-- | $v = \frac{dx}{dt}$

В каталоге doc это отображается пикшей в Equations.tex как:

{\char '44}v = frac{\char '173}dx{\char '175}{\char '173}dt{\char '175}{\char '44}

Я нашел эту функцию в исходном коде для латексного бэкенда Haddock, которая заменяет многие символы, используемые в латексном форматировании:

latexMunge :: Char -> String -> String
...
latexMunge '$'  s = "{\\char '44}" ++ s

Есть ли какие-либо существующие функции, которые позволяют мне обойти это и вставить латексные уравнения в комментарии?


person Maarten    schedule 15.06.2014    source источник


Ответы (1)


Нет. Основная причина, по которой этой (и подобных функций) не существует, заключается в том, что неясно, что делать с разметкой в ​​других бэкендах, будь то HTML, Hoogle или что-то еще, что кто-то может использовать. Это довольно часто запрашивается, но нет общего соглашения и, что более важно, нет исправлений.

Технически мы не поддерживаем серверную часть LaTeX, она компилируется, чтобы можно было создать отчет Haskell. Если вы или кто-то другой хотите дать ему новую жизнь (и функции), мы с радостью примем исправления.

tl;dr: нет, не могу. Я знаю, что люди просто предварительно визуализируют LaTeX и вставляют полученные изображения с синтаксисом изображения.

person Mateusz Kowalczyk    schedule 31.08.2014
comment
Обратите внимание, что после этого ответа была добавлена ​​поддержка mathjax, которая будет отображать LaTeX через ваш браузер. - person Mateusz Kowalczyk; 03.03.2017