Mein selbst geschriebenes CMS bietet schon länger die Möglichkeit, TeX-Formeln zu Illustrationszwecken zu rendern und in Artikel einzubinden. Nachdem ich in einem meiner Projekte die Möglichkeit in GitLab eingebaut habe, habe ich nun beschlossen, die zugrundeliegende Technik etwas zu verfeinern.

In diesem Vorhaben wurde ich noch bestärkt, nachdem ich herausfand, dass dieses Feature natürlich auch in Jupyter-Notebooks zur Verfügung steht - wenn man weiß, wie man es aktiviert...

Bisher war es lediglich möglich, TeX-Formeln zu setzen und ein Bild daraus zu rendern, das dann - zum Beispiel - in Webseiten integriert werden konnte. Neulich fragte ich mich aber, wie man eines der vielen TeX-Features für Formelsatz integrieren könnte: Formelnummern. Nachdem ich einige Hintergründe recherchiert hatte, verbesserte ich die bisher dafür von mir angewendete Technik - ich erweiterte das Template formula.tex folgendermaßen:

\ifdefined\formula
\else
    \def\formula{E = m c^2}
\fi
\documentclass[border=2pt]{standalone}
\usepackage{amsmath}
\usepackage{varwidth}
\begin{document}
\begin{varwidth}{\linewidth}
\ifdefined\formulaCounter
        \setcounter{equation}{\formulaCounter}
        \begin{align} \formula \end{align}
\else
        \[ \formula \]
\fi
\end{varwidth}
\end{document}

Ruft man pdflatex unter Verwendung dieses Templates wie folgt auf:

pdflatex \\def\\formula{a=b}\\input{/location/of/formula.tex}

erhält man das bisherige Ergebnis - die in Display Mode erstellte TeX-Formel:

Mit dem alternativen, um formulaCounter ergänzten Aufruf:

pdflatex \\def\\formulaCounter{12}\\def\\formula{a=b}\\input{/location/of/formula.tex}

ändert sich das Ergebnis: Die Formel wird im Display Mode gesetzt, erhält aber zusätzlich die Nummer 13.

Diese Erweiterung wurde auch in das entsprechende GitLab-Projekt eingebaut und in einer neuen Release zur Verfügung gestellt.

Artikel, die hierher verlinken