MiniLaTeX

The MiniLatex package renders a subset of LaTeX to Html. For a demo, see MiniLatex Live or www.knode.io. There is a technical discussion in the see the Hackernoon article, Towards LaTeX in the Browser.

Example

import MiniLatex
import MiniLatex.Render exposing(MathJaxRenderOption(..))


text = "Pythagoras says: $a^2 + b^2 = c^2$"

MiniLatex.render "" NoDelay text

See the code in ./example

NOTES. The first parameter is `selectedId', used for highlighting selected elements. It can be left empty. The second parameter determines how MathJax renders text. The third parameter is the source text.

For interactive editors and live rendering, you may want to use the functions in MiniLaTeX.Edit. For an example of how this is done, see the code in ./demo

This release

• Eliminated macros as a parameter of render

• Added an svg environment. See demo.minilatex.app for an example of how it is used.

Recent releases

• Changed MiniLatex.Edit.get so as to be able to highlight paragraphs in the rendered tex. There are two parts to this. First, when get retrieves rendered text from a Data value, it adds click handlers to each paragraph. When a paragraph is clicked, it sends the message IDClicked id, where a typical ID is a string like "p.1.10", meaning paragaph 10, version 1. The version of a paragraph is incremented when it is edited. Second, a call to MiniLatex.Edit.get takes the form get selectedId data. If the selectedId is found in the data, the corresponding paragraph is highlighted. The get function is used in conjunction with a host app to synchronize source and rendered text.

• Both math-mode and text-mode macros can be defined in the source text using \begin{mathmacro} ... \end{mathmacro} and \begin{textmacro} ... \end{textmacro}

• New method for using math-mode macros. See MiniLaTeX Demo, section on math-mode macros.

• Added a source map. This is a dictionary whose keys are pieces of source text and whose values are the ids of the corresponding rendered text. With a little more work, this will allow one to have bidirectional sync between source and rendered text: click on something in one to bring the corresponding part of the other into focus.

• Better LaTeX error reporting (to be still further improved).

• The below is used to optimize rendering by MathJax

    type MathJaxRenderOption = Delay | NoDelay

  This is necessitated by the single-threaded nature of Javascript.

Acknowledgments

I wish to acknowledge the generous help that I have received throughout this project from the community at elmlang.slack.com, with special thanks to Evan Czaplicki, Ilias van Peer, and Luke Westby. I also wish to thank Davide Cervone (MathJax.org) for indispensible help with MathJax.