package
API's for calling MathJax from node.js
npm install mathjax-nodeGitHub-flavored package documentation.
Across all versions.
Download trend unavailable.
Runtime metadata.
Tagged topics.
This repository contains a library that provides an API to call MathJax from Node.js programs. The API converts individual math expressions (in any of MathJax's input formats) into HTML (with CSS), SVG, or MathML code.
Use
npm install mathjax-nodeto install mathjax-node and its dependencies.
Note: The current version of mathjax-node requires Node.js v6 or later, and uses jsdom version 11.
mathjax-node provides a library, ./lib/main.js. Below is a very minimal example for using it - the tests and the examples mentioned above provide more advanced examples.
// a simple TeX-input example
var mjAPI = require("mathjax-node");
mjAPI.config({
MathJax: {
// traditional MathJax configuration
}
});
mjAPI.start();
var yourMath = 'E = mc^2';
mjAPI.typeset({
math: yourMath,
format: "TeX", // or "inline-TeX", "MathML"
mml:true, // or svg:true, or html:true
}, function (data) {
if (!data.errors) {console.log(data.mml)}
// will produce:
// <math xmlns="http://www.w3.org/1998/Math/MathML" display="block">
// <mi>E</mi>
mathjax-node exports three methods, config, start, typeset.
config(options)The config method is used to set global configuration options. Its default options are
{
displayMessages: false, // determines whether Message.Set() calls are logged
displayErrors: true, // determines whether error messages are shown on the console
undefinedCharError: false, // determines whether "unknown characters" (i.e., no glyph in the configured fonts) are saved in the error array
extensions: '', // a convenience option to add MathJax extensions
fontURL: 'https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/fonts/HTML-CSS', // for webfont urls in the CSS for HTML output
paths: {}, // configures custom path variables (e.g., for third party extensions, cf. test/config-third-party-extensions.js)
MathJax: { } // standard MathJax configuration options, see https://docs.mathjax.org for more detail.
}Note. Changes to these options require a restart of the API using the start() method (see below).
start()The start method start (and restarts) mathjax-node. This allows reconfiguration.
Note. This is done automatically when typeset is first called (see below).
typeset(options[, callback])The typeset method is the main method of mathjax-node. It expects a configuration object options and optionally a callback.
If no callback is passed, it will return a Promise.
Once called, typeset can be called repeatedly and will optionally store information across calls (see state below).
The following are the default input options.
{
ex: 6, // ex-size in pixels
width: 100, // width of container (in ex) for linebreaking and tags
useFontCache: true, // use <defs> and <use> in svg output?
useGlobalCache: false, // use common <defs> for all equations?
linebreaks: false, // automatic linebreaking
equationNumbers: "none", // automatic equation numbering ("none", "AMS" or "all")
cjkCharWidth: 13, // width of CJK character
math: "", // the math string to typeset
format: "TeX", // the input format (TeX, inline-TeX, AsciiMath, or MathML)
xmlns: "mml",
Promise.resolve(result,options) / Promise.reject(errors) / callback(result, options)mathjax-node returns two objects to Promise.resolve or callback: a result object and the original input options.
The result object will contain (at most) the following structure:
{
errors: // an array of MathJax error messages if any errors occurred
mml: // a string of MathML markup if requested
mmlNode: // a jsdom node of MathML markup if requested
html: // a string of HTML markup if requested
htmlNode: // a jsdom node of HTML markup if requested
css: // a string of CSS if HTML was requested
svg: // a string of SVG markup if requested
svgNode: // a jsdom node of SVG markup if requested
style: // a string of CSS inline style if SVG requested
height: // a string containing the height of the SVG output if SVG was requested
width: // a string containing the width of the SVG output if SVG was requested
speakText: // a string of speech text if requested
state: {
If the errors array is non-empty, the Promise will reject, and be passed the errors array.
The options contains the configuration object passed to typeset; this can be useful for passing other data along or for identifying which typeset() call is associated with this (callback) call (in case you use the same callback function for more than one typeset()).
mathjax-node v2.0 makes breaking changes as follows:
mathjax-node v1.0 makes breaking changes to the following features from the pre-releases.
lib/mj-single.js has been renamed to lib/main.js (and set as main in package.json, i.e., require('mathjax-node') will load it.lib/mj-page.js (API for processing HTML-fragments) and related CLI toolsbin/These features can easily be recreated in separate modules for greater flexibility. For examples, see
Be sure to also check out other projects on NPM that depend on mathjax-node.
Estimated unpacked size across 31 packages.
83.7 MB
Includes dependencies.
3 direct · 3 outdated