No commit activity in last 3 years
No release in over 3 years
kramdown-math-mathjaxnode uses mathjax-node to convert math elements to MathML
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 2.0
 Project Readme

Important: This repo and gem are unmaintained! If you are interested in maintaining, please contact me at t_leitner@gmx.at.

kramdown math engine for conversion to MathML

This is a converter for kramdown that uses Mathjax-Node to convert math formulas to MathML.

Note: Until kramdown version 2.0.0 this math engine was part of the kramdown distribution.

Installation

gem install kramdown-math-mathjaxnode

Usage

require 'kramdown'
require 'kramdown-math-mathjaxnode

Kramdown::Document.new(text, math_engine: :mathjaxnode).to_html

Documentation

To use Mathjax-Node, set the option math_engine to 'mathjaxnode' and make sure that both Node.js and Mathjax-Node are available. The Mathjax-Node library can be installed, e.g., via npm by running npm install -g mathjax-node. Instructions for installing Node.js can be found in the joyent/node wiki.

The Mathjax-Node engine supports the following keys of the option math_engine_opts:

  • semantics:

    Specifies whether TeX code should be added in a <semantics> tag. It defaults to false but if set to true, a <semantics> tag with the LaTeX code itself is added.

  • texhints:

    Specifies whether TeX-specific classes should be added. It defaults to true but if set to false, the TeX-specific classes, like MJX-TeXAtom-ORD, will not be added. These classes provide styling hints to the MathJax browser library.

Development

Clone the git repository and you are good to go. You probably want to install rake so that you can use the provided rake tasks.

License

MIT - see the COPYING file.