MathJax in Puppeteer

├── .gitignore ├── LICENSE ├── README.md ├── component ├── README.md ├── am2chtml ├── am2chtml-page ├── am2mml ├── mml2chtml ├── mml2chtml-page ├── mml2svg ├── mml2svg-page ├── tex2chtml ├── tex2chtml-page ├── tex2mml ├── tex2mml-page ├── tex2svg └── tex2svg-page ├── custom-tex-extension ├── README.md ├── mml.js └── tex2mml ├── direct ├── README.md ├── am2chtml ├── am2chtml-page ├── am2mml ├── mml2chtml ├── mml2chtml-page ├── mml2svg ├── mml2svg-page ├── tex2chtml ├── tex2chtml-page ├── tex2mml ├── tex2mml-page ├── tex2svg └── tex2svg-page ├── jsdom ├── README.md ├── adaptor │ ├── adaptor.js │ ├── adaptor.min.js │ └── webpack.config.js ├── package.json ├── tex2chtml ├── tex2chtml-page ├── tex2svg └── tex2svg-page ├── package.json ├── preload ├── README.md ├── am2chtml ├── am2chtml-page ├── am2mml ├── mml2chtml ├── mml2chtml-page ├── mml2svg ├── mml2svg-page ├── tex2chtml ├── tex2chtml-page ├── tex2mml ├── tex2mml-page ├── tex2svg └── tex2svg-page ├── puppeteer ├── README.md ├── package.json ├── puppeteer.html └── tex2svg ├── simple ├── README.md ├── am2chtml ├── am2chtml-page ├── am2mml ├── mml2chtml ├── mml2chtml-page ├── mml2svg ├── mml2svg-page ├── tex2chtml ├── tex2chtml-page ├── tex2mml ├── tex2mml-page ├── tex2svg └── tex2svg-page └── speech ├── README.md ├── action.js ├── mml2mml ├── mml2svg ├── mml2svg-page ├── tex2chtml ├── tex2chtml-speech ├── tex2chtml-speech-page ├── tex2mml ├── tex2speech ├── tex2svg └── tex2svg-page /.gitignore: -------------------------------------------------------------------------------- 1 | *~ 2 | node_modules 3 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | GitHub release version

2 | 3 | A repository with examples using [MathJax version 3](https://github.com/mathjax/MathJax-src) in node applications. 4 | 5 | See the [MathJax Web Demos](https://github.com/mathjax/MathJax-demos-web) for examples of how to use MathJax in web pages. See the [MathJax documentation](https://docs.mathjax.org/) for complete details of how to use MathJax in web browsers and node. 6 | 7 | ## The Example files 8 | 9 | This repository contains examples of how to use MathJax v3 in your node projects. These are divided into three main categories: ones based on the MathJax v3 components and its loading system, ones based on the MathJax v3 components that you preload by hand (for easier synchronous use), and ones that use the base MathJax files directly without using the MathJax components. 10 | 11 | All three groups include examples of conversion from the various input formats to the various output formats, both for individual expressions, and for complete pages containing math. Each category includes the following executables: 12 | 13 | * `tex2chtml` 14 | * `tex2svg` 15 | * `tex2mml` 16 | * `mml2chtml` 17 | * `mml2svg` 18 | * `am2chtml` 19 | * `am2mml` 20 | * `tex2chtml-page` 21 | * `tex2svg-page` 22 | * `tex2mml-page` 23 | * `mml2chtml-page` 24 | * `mml2svg-page` 25 | * `am2chtml-page` 26 | 27 | The first seven convert an expression from either a TeX, MathML, or AsciiMath string (given as its first argument) to a CommonHTML, SVG, or MathML string. The ones ending in `-page` take an HTML file and convert the math in it from the given input format to the specified output format and output the modified page. 28 | 29 | Use the `--help` option to get a list of all the possible options for each command. 30 | 31 | The three categories of commands are stored in the directories called [`component`](component), [`simple`](simple), [`preload`](preload), and [`direct`](direct). Both the `component` and `simple` directories are examples of the component-based approach, with the `component` directory containing versions that mirror the approach needed when MathJax is used in web pages, and the `simple` directory containing examples that take advantage of some simplifications available in node. Each of those directories contain additional information about the example files they contain. 32 | 33 | There is also a directory [`speech`](speech) that give examples of converters that add speech strings to their results, which illustrate more sophisticated operations in MathJax. This is described in more detail in that directory. 34 | 35 | The [`custom-tex-extension`](custom-tex-extension) directory contains an example of how to create your own custom TeX extension and load it as a component. Again, see the directory for more details. 36 | 37 | The [`puppeteer`](puppeteer) directory contains an example of how to use the [Puppeteer](https://developers.google.com/web/tools/puppeteer) library to use a headless Chrome instance to do server-side conversion of mathematics using MathJax. This is useful in situations where you are using characters that are not included in the main MathJax fonts, as Chrome will be able to measure the widths of these characters so that they can be displayed more reliably. 38 | 39 | ## Installation 40 | 41 | In order to try out these examples, clone this repository, enter the directory, and install the dependencies: 42 | 43 | The examples should be executable files that you can run. On non-unix systems, you may need to call 44 | 45 | ``` bash 46 | node -r esm 47 | ``` 48 | 49 | where `` is the name of the example file. Some examples take an argument (like a TeX string) that follows the `` above. 50 | -------------------------------------------------------------------------------- /component/am2chtml: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env -S node -r esm 2 | 3 | /************************************************************************* 4 | * 5 | * component/am2chtml 6 | * 7 | * Uses MathJax v3 to convert an AsciiMath string to an HTML string. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2019 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | 27 | // 28 | // Get the command-line arguments 29 | // 30 | var argv = require('yargs') 31 | .demand(0).strict() 32 | .usage('$0 [options] "math" > file.html') 33 | .options({ 34 | em: { 35 | default: 16, 36 | describe: 'em-size in pixels' 37 | }, 38 | ex: { 39 | default: 8, 40 | describe: 'ex-size in pixels' 41 | }, 42 | width: { 43 | default: 80 * 16, 44 | describe: 'width of container in pixels' 45 | }, 46 | css: { 47 | boolean: true, 48 | describe: 'output the required CSS rather than the HTML itself' 49 | }, 50 | fontURL: { 51 | default: 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/output/chtml/fonts/woff-v2', 52 | describe: 'the URL to use for web fonts' 53 | }, 54 | assistiveMml: { 55 | boolean: true, 56 | default: false, 57 | describe: 'whether to include assistive MathML output' 58 | }, 59 | dist: { 60 | boolean: true, 61 | default: false, 62 | describe: 'true to use webpacked version, false to use MathJax source files' 63 | } 64 | }) 65 | .argv; 66 | 67 | // 68 | // Configure MathJax 69 | // 70 | MathJax = { 71 | options: { 72 | enableAssistiveMml: argv.assistiveMml 73 | }, 74 | loader: { 75 | paths: {mathjax: 'mathjax-full/es5'}, 76 | source: (argv.dist ? {} : require('mathjax-full/components/src/source.js').source), 77 | require: require, 78 | load: ['input/asciimath', 'output/chtml', 'adaptors/liteDOM', 'a11y/assistive-mml'] 79 | }, 80 | chtml: { 81 | fontURL: argv.fontURL 82 | }, 83 | startup: { 84 | typeset: false 85 | } 86 | } 87 | 88 | // 89 | // Load the MathJax startup module 90 | // 91 | require('mathjax-full/' + (argv.dist ? 'es5' : 'components/src/startup') + '/startup.js'); 92 | 93 | // 94 | // Wait for MathJax to start up, and then typeset the math 95 | // 96 | MathJax.startup.promise.then(() => { 97 | MathJax.asciimath2chtmlPromise(argv._[0] || '', { 98 | display: !argv.inline, 99 | em: argv.em, 100 | ex: argv.ex, 101 | containerWidth: argv.width 102 | }).then((node) => { 103 | const adaptor = MathJax.startup.adaptor; 104 | // 105 | // If the --css option was specified, output the CSS, 106 | // Otherwise, output the typeset math as HTML 107 | // 108 | if (argv.css) { 109 | console.log(adaptor.textContent(MathJax.chtmlStylesheet())); 110 | } else { 111 | console.log(adaptor.outerHTML(node)); 112 | }; 113 | }); 114 | }).catch(err => console.log(err)); 115 | -------------------------------------------------------------------------------- /component/am2chtml-page: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env -S node -r esm 2 | 3 | /************************************************************************* 4 | * 5 | * component/am2chtml-page 6 | * 7 | * Uses MathJax v3 to convert all AsciiMath in an HTML document. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2019 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | // 27 | // Get the command-line arguments 28 | // 29 | var argv = require('yargs') 30 | .demand(0).strict() 31 | .usage('$0 [options] file.html > converted.html') 32 | .options({ 33 | em: { 34 | default: 16, 35 | describe: 'em-size in pixels' 36 | }, 37 | ex: { 38 | default: 8, 39 | describe: 'ex-size in pixels' 40 | }, 41 | fontURL: { 42 | default: 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/output/chtml/fonts/woff-v2', 43 | describe: 'the URL to use for web fonts' 44 | }, 45 | dist: { 46 | boolean: true, 47 | default: false, 48 | describe: 'true to use webpacked version, false to use MathJax source files' 49 | } 50 | }) 51 | .argv; 52 | 53 | // 54 | // Read the HTML file 55 | // 56 | const htmlfile = require('fs').readFileSync(argv._[0], 'utf8'); 57 | 58 | // 59 | // Configure MathJax 60 | // 61 | MathJax = { 62 | loader: { 63 | paths: {mathjax: 'mathjax-full/es5'}, 64 | source: (argv.dist ? {} : require('mathjax-full/components/src/source.js').source), 65 | require: require, 66 | load: ['input/asciimath', 'output/chtml', 'adaptors/liteDOM', 'a11y/assistive-mml'] 67 | }, 68 | chtml: { 69 | fontURL: argv.fontURL, 70 | exFactor: argv.ex / argv.em 71 | }, 72 | 'adaptors/liteDOM': { 73 | fontSize: argv.em 74 | }, 75 | startup: { 76 | document: htmlfile 77 | } 78 | } 79 | 80 | // 81 | // Load the MathJax startup module 82 | // 83 | require('mathjax-full/' + (argv.dist ? 'es5' : 'components/src/startup') + '/startup.js'); 84 | 85 | // 86 | // Wait for MathJax to start up, and then typeset the math 87 | // 88 | MathJax.startup.promise.then(() => { 89 | const adaptor = MathJax.startup.adaptor; 90 | const html = MathJax.startup.document; 91 | if (Array.from(html.math).length === 0) adaptor.remove(html.outputJax.chtmlStyles); 92 | console.log(adaptor.doctype(html.document)); 93 | console.log(adaptor.outerHTML(adaptor.root(html.document))); 94 | }).catch(err => console.log(err)); 95 | -------------------------------------------------------------------------------- /component/am2mml: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env -S node -r esm 2 | 3 | /************************************************************************* 4 | * 5 | * component/am2mml 6 | * 7 | * Uses MathJax v3 to convert an AsciiMath string to a MathML string. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2019 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | 27 | // 28 | // Get the command-line arguments 29 | // 30 | var argv = require('yargs') 31 | .demand(0).strict() 32 | .usage('$0 [options] "math"') 33 | .options({ 34 | em: { 35 | default: 16, 36 | describe: 'em-size in pixels' 37 | }, 38 | ex: { 39 | default: 8, 40 | describe: 'ex-size in pixels' 41 | }, 42 | width: { 43 | default: 80 * 16, 44 | describe: 'width of container in pixels' 45 | }, 46 | dist: { 47 | boolean: true, 48 | default: false, 49 | describe: 'true to use webpacked version, false to use MathJax source files' 50 | } 51 | }) 52 | .argv; 53 | 54 | // 55 | // Configure MathJax 56 | // 57 | MathJax = { 58 | loader: { 59 | paths: {mathjax: 'mathjax-full/es5'}, 60 | source: (argv.dist ? {} : require('mathjax-full/components/src/source.js').source), 61 | require: require, 62 | load: ['input/asciimath', 'adaptors/liteDOM'] 63 | } 64 | } 65 | 66 | // 67 | // Load the MathJax startup module 68 | // 69 | require('mathjax-full/' + (argv.dist ? 'es5' : 'components/src/startup') + '/startup.js'); 70 | 71 | // 72 | // Wait for MathJax to start up, and then typeset the math 73 | // 74 | MathJax.startup.promise.then(() => { 75 | MathJax.asciimath2mmlPromise(argv._[0] || '', { 76 | display: !argv.inline, 77 | em: argv.em, 78 | ex: argv.ex, 79 | containerWidth: argv.width 80 | }).then(mml => console.log(mml)); 81 | }).catch(err => console.log(err)); 82 | -------------------------------------------------------------------------------- /component/mml2chtml: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env -S node -r esm 2 | 3 | /************************************************************************* 4 | * 5 | * component/mml2chtml 6 | * 7 | * Uses MathJax v3 to convert a MathML string to an HTML string. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2019 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | 27 | // 28 | // Get the command-line arguments 29 | // 30 | var argv = require('yargs') 31 | .demand(0).strict() 32 | .usage('$0 [options] "math" > file.html') 33 | .options({ 34 | inline: { 35 | boolean: true, 36 | describe: "process as inline math" 37 | }, 38 | em: { 39 | default: 16, 40 | describe: 'em-size in pixels' 41 | }, 42 | ex: { 43 | default: 8, 44 | describe: 'ex-size in pixels' 45 | }, 46 | width: { 47 | default: 80 * 16, 48 | describe: 'width of container in pixels' 49 | }, 50 | css: { 51 | boolean: true, 52 | describe: 'output the required CSS rather than the HTML itself' 53 | }, 54 | fontURL: { 55 | default: 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/output/chtml/fonts/woff-v2', 56 | describe: 'the URL to use for web fonts' 57 | }, 58 | assistiveMml: { 59 | boolean: true, 60 | default: false, 61 | describe: 'whether to include assistive MathML output' 62 | }, 63 | dist: { 64 | boolean: true, 65 | default: false, 66 | describe: 'true to use webpacked version, false to use MathJax source files' 67 | } 68 | }) 69 | .argv; 70 | 71 | // 72 | // Configure MathJax 73 | // 74 | MathJax = { 75 | options: { 76 | enableAssistiveMml: argv.assistiveMml 77 | }, 78 | loader: { 79 | paths: {mathjax: 'mathjax-full/es5'}, 80 | source: (argv.dist ? {} : require('mathjax-full/components/src/source.js').source), 81 | require: require, 82 | load: ['adaptors/liteDOM', 'input/mml/entities'] 83 | }, 84 | chtml: { 85 | fontURL: argv.fontURL 86 | }, 87 | startup: { 88 | typeset: false 89 | } 90 | } 91 | 92 | // 93 | // Load the MathJax startup module 94 | // 95 | require('mathjax-full/' + (argv.dist ? 'es5' : 'components/src/mml-chtml') + '/mml-chtml.js'); 96 | 97 | // 98 | // Wait for MathJax to start up, and then typeset the math 99 | // 100 | MathJax.startup.promise.then(() => { 101 | MathJax.mathml2chtmlPromise(argv._[0] || '', { 102 | display: !argv.inline, 103 | em: argv.em, 104 | ex: argv.ex, 105 | containerWidth: argv.width 106 | }).then((node) => { 107 | const adaptor = MathJax.startup.adaptor; 108 | // 109 | // If the --css option was specified, output the CSS, 110 | // Otherwise, output the typeset math as HTML 111 | // 112 | if (argv.css) { 113 | console.log(adaptor.textContent(MathJax.chtmlStylesheet())); 114 | } else { 115 | console.log(adaptor.outerHTML(node)); 116 | }; 117 | }); 118 | }).catch(err => console.log(err)); 119 | -------------------------------------------------------------------------------- /component/mml2chtml-page: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env -S node -r esm 2 | 3 | /************************************************************************* 4 | * 5 | * component/mml2chtml-page 6 | * 7 | * Uses MathJax v3 to convert all MathML in an HTML document. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2019 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | // 27 | // Get the command-line arguments 28 | // 29 | var argv = require('yargs') 30 | .demand(0).strict() 31 | .usage('$0 [options] file.html > converted.html') 32 | .options({ 33 | em: { 34 | default: 16, 35 | describe: 'em-size in pixels' 36 | }, 37 | ex: { 38 | default: 8, 39 | describe: 'ex-size in pixels' 40 | }, 41 | fontURL: { 42 | default: 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/output/chtml/fonts/woff-v2', 43 | describe: 'the URL to use for web fonts' 44 | }, 45 | dist: { 46 | boolean: true, 47 | default: false, 48 | describe: 'true to use webpacked version, false to use MathJax source files' 49 | } 50 | }) 51 | .argv; 52 | 53 | // 54 | // Read the HTML file 55 | // 56 | const htmlfile = require('fs').readFileSync(argv._[0], 'utf8'); 57 | 58 | // 59 | // Configure MathJax 60 | // 61 | MathJax = { 62 | loader: { 63 | paths: {mathjax: 'mathjax-full/es5'}, 64 | source: (argv.dist ? {} : require('mathjax-full/components/src/source.js').source), 65 | require: require, 66 | load: ['adaptors/liteDOM', 'input/mml/entities'] 67 | }, 68 | chtml: { 69 | fontURL: argv.fontURL, 70 | exFactor: argv.ex / argv.em 71 | }, 72 | 'adaptors/liteDOM': { 73 | fontSize: argv.em 74 | }, 75 | startup: { 76 | document: htmlfile 77 | } 78 | } 79 | 80 | // 81 | // Load the MathJax startup module 82 | // 83 | require('mathjax-full/' + (argv.dist ? 'es5' : 'components/src/mml-chtml') + '/mml-chtml.js'); 84 | 85 | // 86 | // Wait for MathJax to start up, and then typeset the math 87 | // 88 | MathJax.startup.promise.then(() => { 89 | const adaptor = MathJax.startup.adaptor; 90 | const html = MathJax.startup.document; 91 | if (Array.from(html.math).length === 0) adaptor.remove(html.outputJax.chtmlStyles); 92 | console.log(adaptor.doctype(html.document)); 93 | console.log(adaptor.outerHTML(adaptor.root(html.document))); 94 | }).catch(err => console.log(err)); 95 | -------------------------------------------------------------------------------- /component/mml2svg-page: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env -S node -r esm 2 | 3 | /************************************************************************* 4 | * 5 | * component/mml2svg-page 6 | * 7 | * Uses MathJax v3 to convert all MathML in an HTML document. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2019 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | // 27 | // Get the command-line arguments 28 | // 29 | var argv = require('yargs') 30 | .demand(0).strict() 31 | .usage('$0 [options] file.html > converted.html') 32 | .options({ 33 | em: { 34 | default: 16, 35 | describe: 'em-size in pixels' 36 | }, 37 | ex: { 38 | default: 8, 39 | describe: 'ex-size in pixels' 40 | }, 41 | fontCache: { 42 | default: 'global', 43 | describe: 'cache type: local, global, none' 44 | }, 45 | dist: { 46 | boolean: true, 47 | default: false, 48 | describe: 'true to use webpacked version, false to use MathJax source files' 49 | } 50 | }) 51 | .argv; 52 | 53 | // 54 | // Read the HTML file 55 | // 56 | const htmlfile = require('fs').readFileSync(argv._[0], 'utf8'); 57 | 58 | // 59 | // Configure MathJax 60 | // 61 | MathJax = { 62 | loader: { 63 | paths: {mathjax: 'mathjax-full/es5'}, 64 | source: (argv.dist ? {} : require('mathjax-full/components/src/source.js').source), 65 | require: require, 66 | load: ['adaptors/liteDOM', 'input/mml/entities'] 67 | }, 68 | svg: { 69 | fontCache: argv.fontCache, 70 | exFactor: argv.ex / argv.em 71 | }, 72 | 'adaptors/liteDOM': { 73 | fontSize: argv.em 74 | }, 75 | startup: { 76 | document: htmlfile 77 | } 78 | } 79 | 80 | // 81 | // Load the MathJax startup module 82 | // 83 | require('mathjax-full/' + (argv.dist ? 'es5' : 'components/src/mml-svg') + '/mml-svg.js'); 84 | 85 | // 86 | // Wait for MathJax to start up, and then typeset the math 87 | // 88 | MathJax.startup.promise.then(() => { 89 | const adaptor = MathJax.startup.adaptor; 90 | const html = MathJax.startup.document; 91 | if (Array.from(html.math).length === 0) { 92 | adaptor.remove(html.outputJax.svgStyles); 93 | const cache = adaptor.elementById(adaptor.body(html.document), 'MJX-SVG-global-cache'); 94 | if (cache) adaptor.remove(cache); 95 | } 96 | console.log(adaptor.doctype(html.document)); 97 | console.log(adaptor.outerHTML(adaptor.root(html.document))); 98 | }).catch(err => console.log(err)); 99 | -------------------------------------------------------------------------------- /component/tex2chtml: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env -S node -r esm 2 | 3 | /************************************************************************* 4 | * 5 | * component/tex2chtml 6 | * 7 | * Uses MathJax v3 to convert a TeX string to an HTML string. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2019 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | 27 | // 28 | // The default TeX packages to use 29 | // 30 | const PACKAGES = 'base, autoload, require, ams, newcommand'; 31 | 32 | // 33 | // Get the command-line arguments 34 | // 35 | var argv = require('yargs') 36 | .demand(0).strict() 37 | .usage('$0 [options] "math" > file.html') 38 | .options({ 39 | inline: { 40 | boolean: true, 41 | describe: "process as inline math" 42 | }, 43 | em: { 44 | default: 16, 45 | describe: 'em-size in pixels' 46 | }, 47 | ex: { 48 | default: 8, 49 | describe: 'ex-size in pixels' 50 | }, 51 | width: { 52 | default: 80 * 16, 53 | describe: 'width of container in pixels' 54 | }, 55 | packages: { 56 | default: PACKAGES, 57 | describe: 'the packages to use, e.g. "base, ams"; use "*" to represent the default packages, e.g, "*, bbox"' 58 | }, 59 | css: { 60 | boolean: true, 61 | describe: 'output the required CSS rather than the HTML itself' 62 | }, 63 | fontURL: { 64 | default: 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/output/chtml/fonts/woff-v2', 65 | describe: 'the URL to use for web fonts' 66 | }, 67 | assistiveMml: { 68 | boolean: true, 69 | default: false, 70 | describe: 'whether to include assistive MathML output' 71 | }, 72 | dist: { 73 | boolean: true, 74 | default: false, 75 | describe: 'true to use webpacked version, false to use MathJax source files' 76 | } 77 | }) 78 | .argv; 79 | 80 | // 81 | // Configure MathJax 82 | // 83 | MathJax = { 84 | options: { 85 | enableAssistiveMml: argv.assistiveMml 86 | }, 87 | loader: { 88 | paths: {mathjax: 'mathjax-full/es5'}, 89 | source: (argv.dist ? {} : require('mathjax-full/components/src/source.js').source), 90 | require: require, 91 | load: ['adaptors/liteDOM'] 92 | }, 93 | tex: { 94 | packages: argv.packages.replace('\*', PACKAGES).split(/\s*,\s*/) 95 | }, 96 | chtml: { 97 | fontURL: argv.fontURL 98 | }, 99 | startup: { 100 | typeset: false 101 | } 102 | } 103 | 104 | // 105 | // Load the MathJax startup module 106 | // 107 | require('mathjax-full/' + (argv.dist ? 'es5' : 'components/src/tex-chtml') + '/tex-chtml.js'); 108 | 109 | // 110 | // Wait for MathJax to start up, and then typeset the math 111 | // 112 | MathJax.startup.promise.then(() => { 113 | MathJax.tex2chtmlPromise(argv._[0] || '', { 114 | display: !argv.inline, 115 | em: argv.em, 116 | ex: argv.ex, 117 | containerWidth: argv.width 118 | }).then((node) => { 119 | const adaptor = MathJax.startup.adaptor; 120 | // 121 | // If the --css option was specified, output the CSS, 122 | // Otherwise, output the typeset math as HTML 123 | // 124 | if (argv.css) { 125 | console.log(adaptor.textContent(MathJax.chtmlStylesheet())); 126 | } else { 127 | console.log(adaptor.outerHTML(node)); 128 | }; 129 | }); 130 | }).catch(err => console.log(err)); 131 | -------------------------------------------------------------------------------- /component/tex2chtml-page: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env -S node -r esm 2 | 3 | /************************************************************************* 4 | * 5 | * component/tex2chtml-page 6 | * 7 | * Uses MathJax v3 to convert all TeX in an HTML document. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2019 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | // 27 | // The default TeX packages to use 28 | // 29 | const PACKAGES = 'base, autoload, require, ams, newcommand'; 30 | 31 | // 32 | // Get the command-line arguments 33 | // 34 | var argv = require('yargs') 35 | .demand(0).strict() 36 | .usage('$0 [options] file.html > converted.html') 37 | .options({ 38 | em: { 39 | default: 16, 40 | describe: 'em-size in pixels' 41 | }, 42 | ex: { 43 | default: 8, 44 | describe: 'ex-size in pixels' 45 | }, 46 | packages: { 47 | default: PACKAGES, 48 | describe: 'the packages to use, e.g. "base, ams"; use "*" to represent the default packages, e.g, "*, bbox"' 49 | }, 50 | fontURL: { 51 | default: 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/output/chtml/fonts/woff-v2', 52 | describe: 'the URL to use for web fonts' 53 | }, 54 | dist: { 55 | boolean: true, 56 | default: false, 57 | describe: 'true to use webpacked version, false to use MathJax source files' 58 | } 59 | }) 60 | .argv; 61 | 62 | // 63 | // Read the HTML file 64 | // 65 | const htmlfile = require('fs').readFileSync(argv._[0], 'utf8'); 66 | 67 | // 68 | // Configure MathJax 69 | // 70 | MathJax = { 71 | loader: { 72 | paths: {mathjax: 'mathjax-full/es5'}, 73 | source: (argv.dist ? {} : require('mathjax-full/components/src/source.js').source), 74 | require: require, 75 | load: ['adaptors/liteDOM'] 76 | }, 77 | tex: { 78 | packages: argv.packages.replace('\*', PACKAGES).split(/\s*,\s*/) 79 | }, 80 | chtml: { 81 | fontURL: argv.fontURL, 82 | exFactor: argv.ex / argv.em 83 | }, 84 | 'adaptors/liteDOM': { 85 | fontSize: argv.em 86 | }, 87 | startup: { 88 | document: htmlfile 89 | } 90 | } 91 | 92 | // 93 | // Load the MathJax startup module 94 | // 95 | require('mathjax-full/' + (argv.dist ? 'es5' : 'components/src/tex-chtml') + '/tex-chtml.js'); 96 | 97 | // 98 | // Wait for MathJax to start up, and then typeset the math 99 | // 100 | MathJax.startup.promise.then(() => { 101 | const adaptor = MathJax.startup.adaptor; 102 | const html = MathJax.startup.document; 103 | if (Array.from(html.math).length === 0) adaptor.remove(html.outputJax.chtmlStyles); 104 | console.log(adaptor.doctype(html.document)); 105 | console.log(adaptor.outerHTML(adaptor.root(html.document))); 106 | }).catch(err => console.log(err)); 107 | -------------------------------------------------------------------------------- /component/tex2mml: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env -S node -r esm 2 | 3 | /************************************************************************* 4 | * 5 | * component/tex2mml 6 | * 7 | * Uses MathJax v3 to convert a TeX string to a MathML string. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2019 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | 27 | // 28 | // The default TeX packages to use 29 | // 30 | const PACKAGES = 'base, autoload, ams, newcommand, require'; 31 | 32 | // 33 | // Get the command-line arguments 34 | // 35 | var argv = require('yargs') 36 | .demand(0).strict() 37 | .usage('$0 [options] "math"') 38 | .options({ 39 | inline: { 40 | boolean: true, 41 | describe: "process as inline math" 42 | }, 43 | em: { 44 | default: 16, 45 | describe: 'em-size in pixels' 46 | }, 47 | ex: { 48 | default: 8, 49 | describe: 'ex-size in pixels' 50 | }, 51 | width: { 52 | default: 80 * 16, 53 | describe: 'width of container in pixels' 54 | }, 55 | packages: { 56 | default: PACKAGES, 57 | describe: 'the packages to use, e.g. "base, ams"; use "*" to represent the default packages, e.g, "*, bbox"' 58 | }, 59 | dist: { 60 | boolean: true, 61 | default: false, 62 | describe: 'true to use webpacked version, false to use MathJax source files' 63 | } 64 | }) 65 | .argv; 66 | 67 | // 68 | // Configure MathJax 69 | // 70 | MathJax = { 71 | loader: { 72 | paths: {mathjax: 'mathjax-full/es5'}, 73 | source: (argv.dist ? {} : require('mathjax-full/components/src/source.js').source), 74 | require: require, 75 | load: ['input/tex-full', 'adaptors/liteDOM'] 76 | }, 77 | tex: { 78 | packages: argv.packages.replace('\*', PACKAGES).split(/\s*,\s*/) 79 | } 80 | } 81 | 82 | // 83 | // Load the MathJax startup module 84 | // 85 | require('mathjax-full/' + (argv.dist ? 'es5' : 'components/src/startup') + '/startup.js'); 86 | 87 | // 88 | // Wait for MathJax to start up, and then typeset the math 89 | // 90 | MathJax.startup.promise.then(() => { 91 | MathJax.tex2mmlPromise(argv._[0] || '', { 92 | display: !argv.inline, 93 | em: argv.em, 94 | ex: argv.ex, 95 | containerWidth: argv.width 96 | }).then(mml => console.log(mml)); 97 | }).catch(err => console.log(err)); 98 | -------------------------------------------------------------------------------- /component/tex2mml-page: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env -S node -r esm 2 | 3 | /************************************************************************* 4 | * 5 | * component/tex2mml-page 6 | * 7 | * Uses MathJax v3 to convert all TeX in an HTML document to MathML. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2020 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | // 27 | // The default TeX packages to use 28 | // 29 | const PACKAGES = 'base, autoload, ams, newcommand, require'; 30 | 31 | // 32 | // Get the command-line arguments 33 | // 34 | var argv = require('yargs') 35 | .demand(0).strict() 36 | .usage('$0 [options] "math"') 37 | .options({ 38 | em: { 39 | default: 16, 40 | describe: 'em-size in pixels' 41 | }, 42 | packages: { 43 | default: PACKAGES, 44 | describe: 'the packages to use, e.g. "base, ams"; use "*" to represent the default packages, e.g, "*, bbox"' 45 | }, 46 | dist: { 47 | boolean: true, 48 | default: false, 49 | describe: 'true to use webpacked version, false to use MathJax source files' 50 | } 51 | }) 52 | .argv; 53 | 54 | // 55 | // Read the HTML file 56 | // 57 | const htmlfile = require('fs').readFileSync(argv._[0], 'utf8'); 58 | 59 | // 60 | // A renderAction to take the place of typesetting. 61 | // It renders the output to MathML instead. 62 | // 63 | function actionMML(math, doc) { 64 | const adaptor = doc.adaptor; 65 | const mml = MathJax.startup.toMML(math.root); 66 | math.typesetRoot = adaptor.firstChild(adaptor.body(adaptor.parse(mml, 'text/html'))); 67 | } 68 | 69 | // 70 | // Configure MathJax 71 | // 72 | MathJax = { 73 | loader: { 74 | paths: {mathjax: 'mathjax-full/es5'}, 75 | source: (argv.dist ? {} : require('mathjax-full/components/src/source.js').source), 76 | require: require, 77 | load: ['input/tex-full', 'adaptors/liteDOM'] 78 | }, 79 | options: { 80 | renderActions: { 81 | typeset: [150, (doc) => {for (const math of doc.math) actionMML(math, doc)}, actionMML] 82 | } 83 | }, 84 | tex: { 85 | packages: argv.packages.replace('\*', PACKAGES).split(/\s*,\s*/) 86 | }, 87 | 'adaptors/liteDOM': { 88 | fontSize: argv.em 89 | }, 90 | startup: { 91 | document: htmlfile 92 | } 93 | } 94 | 95 | // 96 | // Load the MathJax startup module 97 | // 98 | require('mathjax-full/' + (argv.dist ? 'es5' : 'components/src/startup') + '/startup.js'); 99 | 100 | // 101 | // Wait for MathJax to start up, and then render the math. 102 | // Then output the resulting HTML file. 103 | // 104 | MathJax.startup.promise.then(() => { 105 | const adaptor = MathJax.startup.adaptor; 106 | const html = MathJax.startup.document; 107 | html.render(); 108 | console.log(adaptor.doctype(html.document)); 109 | console.log(adaptor.outerHTML(adaptor.root(html.document))); 110 | }).catch(err => console.log(err)); 111 | -------------------------------------------------------------------------------- /component/tex2svg-page: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env -S node -r esm 2 | 3 | /************************************************************************* 4 | * 5 | * component/tex2svg-page 6 | * 7 | * Uses MathJax v3 to convert all TeX in an SVG document. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2019 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | // 27 | // The default TeX packages to use 28 | // 29 | const PACKAGES = 'base, autoload, require, ams, newcommand'; 30 | 31 | // 32 | // Get the command-line arguments 33 | // 34 | var argv = require('yargs') 35 | .demand(0).strict() 36 | .usage('$0 [options] file.html > converted.html') 37 | .options({ 38 | em: { 39 | default: 16, 40 | describe: 'em-size in pixels' 41 | }, 42 | ex: { 43 | default: 8, 44 | describe: 'ex-size in pixels' 45 | }, 46 | packages: { 47 | default: PACKAGES, 48 | describe: 'the packages to use, e.g. "base, ams"; use "*" to represent the default packages, e.g, "*, bbox"' 49 | }, 50 | fontCache: { 51 | default: 'global', 52 | describe: 'cache type: local, global, or none' 53 | }, 54 | dist: { 55 | boolean: true, 56 | default: false, 57 | describe: 'true to use webpacked version, false to use MathJax source files' 58 | } 59 | }) 60 | .argv; 61 | 62 | // 63 | // Read the HTML file 64 | // 65 | const htmlfile = require('fs').readFileSync(argv._[0], 'utf8'); 66 | 67 | // 68 | // Configure MathJax 69 | // 70 | MathJax = { 71 | loader: { 72 | paths: {mathjax: 'mathjax-full/es5'}, 73 | source: (argv.dist ? {} : require('mathjax-full/components/src/source.js').source), 74 | require: require, 75 | load: ['adaptors/liteDOM'] 76 | }, 77 | tex: { 78 | packages: argv.packages.replace('\*', PACKAGES).split(/\s*,\s*/) 79 | }, 80 | svg: { 81 | fontCache: argv.fontCache, 82 | exFactor: argv.ex / argv.em 83 | }, 84 | 'adaptors/liteDOM': { 85 | fontSize: argv.em 86 | }, 87 | startup: { 88 | document: htmlfile 89 | } 90 | } 91 | 92 | // 93 | // Load the MathJax startup module 94 | // 95 | require('mathjax-full/' + (argv.dist ? 'es5' : 'components/src/tex-svg') + '/tex-svg.js'); 96 | 97 | // 98 | // Wait for MathJax to start up, and then typeset the math 99 | // 100 | MathJax.startup.promise.then(() => { 101 | const adaptor = MathJax.startup.adaptor; 102 | const html = MathJax.startup.document; 103 | if (Array.from(html.math).length === 0) { 104 | adaptor.remove(html.outputJax.svgStyles); 105 | const cache = adaptor.elementById(adaptor.body(html.document), 'MJX-SVG-global-cache'); 106 | if (cache) adaptor.remove(cache); 107 | } 108 | console.log(adaptor.doctype(html.document)); 109 | console.log(adaptor.outerHTML(adaptor.root(html.document))); 110 | }).catch(err => console.log(err)); 111 | -------------------------------------------------------------------------------- /custom-tex-extension/README.md: -------------------------------------------------------------------------------- 1 | # Custom TeX Extension 2 | 3 | This example shows how to create a custom TeX extension that defines new TeX commands implemented by javascript functions. 4 | 5 | The commands implemented by this example provides the ability to generate MathML token elements from within TeX by hand. This allows more control over the content and attributes of the elements produced. The macros are `\mi`, `\mo`, `\mn`, `\ms`, and `\mtext`, and they each take an argument that is the text to be used as the content of the corresponding MathML element. The text is not further processed by TeX, but the extension does convert sequences of the form `\uNNNN` (where the N's are hexadecimal digits) into the corresponding unicode character; e.g., `\mi{\u2460}` would produce U+2460, a circled digit 1. 6 | 7 | The main code for the extension is 8 | 9 | * [mml.js](mml.js) 10 | 11 | which contains comments describing it in detail. This file can be loaded into your node project either directly, or as an external component. We describe the latter approach here. 12 | 13 | The key portions of the [code](tex2mml) used to do this is described below. 14 | 15 | First, we add the `mml` package to the default list of packages: 16 | 17 | ```js 18 | const PACKAGES = 'base, autoload, require, ams, newcommand, mml'; 19 | ``` 20 | 21 | Then we configure MathJax to know about the new package: 22 | 23 | ```js 24 | MathJax = { 25 | loader: { 26 | paths: { 27 | mathjax: 'mathjax-full/es5', 28 | custom: '.' 29 | }, 30 | source: (argv.dist ? {} : require('mathjax-full/components/src/source.js').source), 31 | require: require, 32 | load: ['input/tex', 'adaptors/liteDOM', '[custom]/mml'] 33 | }, 34 | tex: {packages: argv.packages.replace('\*', PACKAGES).split(/\s*,\s*/)}, 35 | startup: { 36 | pageReady: () => { 37 | MathJax.tex2mmlPromise(argv._[0] || '', {display: !argv.inline}) 38 | .then(mml => console.log(mml)) 39 | .catch(err => console.log(err)); 40 | } 41 | } 42 | }; 43 | ``` 44 | 45 | The `loader` block adds a new path named `custom` that is tied to the current directory. This is used to load the custom extension (you could have several extensions in the same directory). It also sets `require` for use with node, and asks MathJax to load the `tex` input component, the `liteDOM` adaptor, and the new custom `mml` extension. (Note that we don't load an output jax in this example, since we are only converting to MathML, which is the internal format of MathJax.) 46 | 47 | The `tex` configuration includes the `mml` package in the `package` array by default. 48 | 49 | Finally, the `startup` block configures the `pageReady()` function to do the default startup initialization, and then does a conversion from TeX to MathML, either printing the result, or an error message. This gives you the chance to see the result of the `\mi`, `\mo`, etc. on the resulting MathML representation. 50 | -------------------------------------------------------------------------------- /custom-tex-extension/mml.js: -------------------------------------------------------------------------------- 1 | /************************************************************* 2 | * 3 | * Copyright (c) 2019 The MathJax Consortium 4 | * 5 | * Licensed under the Apache License, Version 2.0 (the "License"); 6 | * you may not use this file except in compliance with the License. 7 | * You may obtain a copy of the License at 8 | * 9 | * http://www.apache.org/licenses/LICENSE-2.0 10 | * 11 | * Unless required by applicable law or agreed to in writing, software 12 | * distributed under the License is distributed on an "AS IS" BASIS, 13 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 | * See the License for the specific language governing permissions and 15 | * limitations under the License. 16 | */ 17 | 18 | 19 | /** 20 | * @fileoverview Configuration file for sample extension that creates 21 | * some MathML token elements. 22 | * 23 | * @author dpvc@mathjax.org (Davide P. Cervone) 24 | */ 25 | 26 | import {Configuration} from '../node_modules/mathjax-full/js/input/tex/Configuration.js'; 27 | import {CommandMap} from '../node_modules/mathjax-full/js/input/tex/SymbolMap.js'; 28 | import TexError from '../node_modules/mathjax-full/js/input/tex/TexError.js'; 29 | 30 | /** 31 | * This function prevents multi-letter mi elements from being 32 | * interpretted as TEXCLASS.OP 33 | */ 34 | function classORD(node) { 35 | this.getPrevClass(node); 36 | return this; 37 | } 38 | 39 | /** 40 | * Convert \uXXXX to corresponding unicode characters within a string 41 | */ 42 | function convertEscapes(text) { 43 | return text.replace(/\\u([0-9A-F]{4})/gi, (match, hex) => String.fromCharCode(parseInt(hex,16))); 44 | } 45 | 46 | /** 47 | * Allowed attributes on any token element other than the ones with default values 48 | */ 49 | const ALLOWED = { 50 | style: true, 51 | href: true, 52 | id: true, 53 | class: true 54 | }; 55 | 56 | /** 57 | * Parse a string as a set of attribute="value" pairs. 58 | */ 59 | function parseAttributes(text, type) { 60 | const attr = {}; 61 | if (text) { 62 | let match; 63 | while ((match = text.match(/^\s*((?:data-)?[a-z][-a-z]*)\s*=\s*(?:"([^"]*)"|(.*?))(?:\s+|,\s*|$)/i))) { 64 | const name = match[1], value = match[2] || match[3] 65 | if (type.defaults.hasOwnProperty(name) || ALLOWED.hasOwnProperty(name) || name.substr(0,5) === 'data-') { 66 | attr[name] = convertEscapes(value); 67 | } else { 68 | throw new TexError('BadAttribute', 'Unknown attribute "%1"', name); 69 | } 70 | text = text.substr(match[0].length); 71 | } 72 | if (text.length) { 73 | throw new TexError('BadAttributeList', 'Can\'t parse as attributes: %1', text); 74 | } 75 | } 76 | return attr; 77 | } 78 | 79 | /** 80 | * The mapping of control sequence to function calls 81 | */ 82 | const MmlMap = new CommandMap('mmlMap', { 83 | mi: ['mmlToken', 'mi'], 84 | mo: ['mmlToken', 'mo'], 85 | mn: ['mmlToken', 'mn'], 86 | ms: ['mmlToken', 'ms'], 87 | mtext: ['mmlToken', 'mtext'] 88 | }, { 89 | mmlToken(parser, name, type) { 90 | const typeClass = parser.configuration.nodeFactory.mmlFactory.getNodeClass(type); 91 | const def = parseAttributes(parser.GetBrackets(name), typeClass); 92 | const text = convertEscapes(parser.GetArgument(name)); 93 | const mml = parser.create('node', type, [parser.create('text', text)], def); 94 | if (type === 'mi') mml.setTeXclass = classORD; 95 | parser.Push(mml); 96 | } 97 | }); 98 | 99 | /** 100 | * The configuration used to enable the MathML macros 101 | */ 102 | const MmlConfiguration = Configuration.create( 103 | 'mml', {handler: {macro: ['mmlMap']}} 104 | ); 105 | -------------------------------------------------------------------------------- /custom-tex-extension/tex2mml: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env -S node -r esm 2 | 3 | /************************************************************************* 4 | * 5 | * custom-tex-extension/tex2mml 6 | * 7 | * Uses MathJax v3 to show how to create and load a custom tex extension. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2019 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | /* 27 | * The mml extension defines \mi{}, \mo{}, \mn{}, \ms{}, \mtext{} for creating 28 | * MathML token elements by hand. They take an optional bracketed argument 29 | * that gives the attributes for the element, e.g. 30 | * 31 | * \mi[mathvariant="bold-italic"]{abc} 32 | * 33 | * The text for the token element is taken as a literal string, except for 34 | * the special sequence \uXXXX, which produces the unicode character U+XXXX. 35 | */ 36 | 37 | // 38 | // The default TeX packages to use 39 | // 40 | const PACKAGES = 'base, autoload, require, ams, newcommand, mml'; 41 | 42 | // 43 | // Get the command-line arguments 44 | // 45 | var argv = require('yargs') 46 | .demand(0).strict() 47 | .usage('$0 [options] "math" > file.html') 48 | .options({ 49 | inline: { 50 | boolean: true, 51 | describe: "process as inline math" 52 | }, 53 | packages: { 54 | default: PACKAGES, 55 | describe: 'the packages to use, e.g. "base, ams"; use "*" to represent the default packages, e.g, "*, bbox"' 56 | }, 57 | dist: { 58 | boolean: true, 59 | default: false, 60 | describe: 'true to use webpacked version, false to use mathjax3 source files' 61 | } 62 | }) 63 | .argv; 64 | 65 | // 66 | // Configure MathJax 67 | // 68 | MathJax = { 69 | loader: { 70 | paths: { 71 | mathjax: 'mathjax-full/es5', 72 | custom: '.' 73 | }, 74 | source: (argv.dist ? {} : require('mathjax-full/components/src/source.js').source), 75 | require: require, 76 | load: ['input/tex', 'adaptors/liteDOM', '[custom]/mml'] 77 | }, 78 | tex: {packages: argv.packages.replace('\*', PACKAGES).split(/\s*,\s*/)}, 79 | startup: { 80 | pageReady: () => { 81 | MathJax.tex2mmlPromise(argv._[0] || '', {display: !argv.inline}) 82 | .then(mml => console.log(mml)) 83 | .catch(err => console.log(err)); 84 | } 85 | } 86 | }; 87 | 88 | // 89 | // Load the MathJax startup module 90 | // 91 | require('mathjax-full/' + (argv.dist ? 'es5' : 'components/src/startup') + '/startup.js'); 92 | 93 | -------------------------------------------------------------------------------- /direct/README.md: -------------------------------------------------------------------------------- 1 | # Non-Component-Based Examples 2 | 3 | The examples in this directory illustrate how to use MathJax by directly importing the MathJax files directly into your project rather than using the MathJax predefined components. While using components is easier, in general, the direct approach gives you the most control over what is included, and when it is loaded. 4 | 5 | All the examples in this directory consist of four main parts: 6 | 7 | 1. Processing the command-line arguments (not described here), 8 | 2. Importing the necessary MathJax files, 9 | 3. Creating the needed MathJax objects, and 10 | 4. Performing the desired conversion using those objects. 11 | 12 | These parts are described below using the `tex2chtml` command as an example. It loads the following MathJax values: 13 | 14 | ```js 15 | const {mathjax} = require('mathjax-full/js/mathjax.js'); 16 | const {TeX} = require('mathjax-full/js/input/tex.js'); 17 | const {CHTML} = require('mathjax-full/js/output/chtml.js'); 18 | const {liteAdaptor} = require('mathjax-full/js/adaptors/liteAdaptor.js'); 19 | const {RegisterHTMLHandler} = require('mathjax-full/js/handlers/html.js'); 20 | const {AssistiveMmlHandler} = require('mathjax-full/js/a11y/assistive-mml.js'); 21 | 22 | const {AllPackages} = require('mathjax-full/js/input/tex/AllPackages.js'); 23 | ``` 24 | 25 | The `TeX` and `CHTML` objects are the input and output jax class constructors, the `liteAdaptor` is the constructor for the liteDOM adaptor, `RegisterHTMLHandler` is a function used to tell MathJax that we want to work with HTML documents (using a particular DOM adaptor), and `AssistiveMmlHandler` is a function to add the assistive-MathML functionality to the registered handler. Finally, `AllPackages` is an array of the package names to use to initialize the TeX input jax; it includes all the available TeX packages except `autoload` and `require` (which rely on the component system to operate), and `physics` and `colorv2`, which have been loaded, but aren't included in the package array by default since `physics` redefines many standard macros and `color` is used rather than `colorv2` for the `\color` macro. You can add `'physics'` to the array if you want to include it yourself. 26 | 27 | Next we create the needed MathJax objects: 28 | 29 | ```js 30 | const adaptor = liteAdaptor(); 31 | const handler = RegisterHTMLHandler(adaptor); 32 | if (argv.assistiveMml) AssistiveMmlHandler(handler); 33 | 34 | const tex = new TeX({packages: argv.packages.split(/\s*,\s*/)}); 35 | const chtml = new CHTML({fontURL: argv.fontURL}); 36 | const html = mathjax.document('', {InputJax: tex, OutputJax: chtml}); 37 | ``` 38 | 39 | Here we create the `liteDOM` adaptor and use it to tell MathJax that we will use HTML documents with the `liteDOM` implementation of the DOM. We extend the handler to include the assistive-MathML support, if requested on the command line. Then we create the input and output jax, and create an empty document (based on the `liteDOM`) with those input and output jax. 40 | 41 | Finally, we do the conversion: 42 | 43 | ```js 44 | const node = html.convert(argv._[0] || '', { 45 | display: !argv.inline, 46 | em: argv.em, 47 | ex: argv.ex, 48 | containerWidth: argv.width 49 | }); 50 | 51 | if (argv.css) { 52 | console.log(adaptor.textContent(chtml.styleSheet(html))); 53 | } else { 54 | console.log(adaptor.outerHTML(node)); 55 | } 56 | ``` 57 | 58 | This uses the `convert()` method of the math document created above, which takes the command-line argument (the TeX math string) and the data about font metrics and returns an HTML node (as represented by the `liteDOM`). We use the adaptor to extract either the serialized version of the node, or the CSS styles required by the expression and print them to the terminal. 59 | -------------------------------------------------------------------------------- /direct/am2chtml: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env node 2 | 3 | /************************************************************************* 4 | * 5 | * direct/am2chtml 6 | * 7 | * Uses MathJax v3 to convert a MathML string to an HTML string. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2018 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | // 27 | // Load the packages needed for MathJax 28 | // 29 | const {mathjax} = require('mathjax-full/js/mathjax.js'); 30 | const {AsciiMath} = require('mathjax-full/js/input/asciimath.js'); 31 | const {CHTML} = require('mathjax-full/js/output/chtml.js'); 32 | const {liteAdaptor} = require('mathjax-full/js/adaptors/liteAdaptor.js'); 33 | const {RegisterHTMLHandler} = require('mathjax-full/js/handlers/html.js'); 34 | const {AssistiveMmlHandler} = require('mathjax-full/js/a11y/assistive-mml.js'); 35 | 36 | // 37 | // Get the command-line arguments 38 | // 39 | var argv = require('yargs') 40 | .demand(0).strict() 41 | .usage('$0 [options] "math" > file.html') 42 | .options({ 43 | em: { 44 | default: 16, 45 | describe: 'em-size in pixels' 46 | }, 47 | ex: { 48 | default: 8, 49 | describe: 'ex-size in pixels' 50 | }, 51 | width: { 52 | default: 80 * 16, 53 | describe: 'width of container in pixels' 54 | }, 55 | css: { 56 | boolean: true, 57 | describe: 'output the required CSS rather than the HTML itself' 58 | }, 59 | fontURL: { 60 | default: 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/output/chtml/fonts/woff-v2', 61 | describe: 'the URL to use for web fonts' 62 | }, 63 | assistiveMml: { 64 | boolean: true, 65 | default: false, 66 | describe: 'whether to include assistive MathML output' 67 | } 68 | }) 69 | .argv; 70 | 71 | // 72 | // Create DOM adaptor and register it for HTML documents 73 | // 74 | const adaptor = liteAdaptor({fontSize: argv.em}); 75 | const handler = RegisterHTMLHandler(adaptor); 76 | if (argv.assistiveMml) AssistiveMmlHandler(handler); 77 | 78 | // 79 | // Create input and output jax and a document using them on the content from the HTML file 80 | // 81 | const asciimath = new AsciiMath(); 82 | const chtml = new CHTML({fontURL: argv.fontURL}); 83 | const html = mathjax.document('', {InputJax: asciimath, OutputJax: chtml}); 84 | 85 | // 86 | // Typeset the math from the command line 87 | // 88 | const node = html.convert(argv._[0] || '', { 89 | display: !argv.inline, 90 | em: argv.em, 91 | ex: argv.ex, 92 | containerWidth: argv.width 93 | }); 94 | 95 | // 96 | // If the --css option was specified, output the CSS, 97 | // Otherwise, typeset the math and output the HTML 98 | // 99 | if (argv.css) { 100 | console.log(adaptor.textContent(chtml.styleSheet(html))); 101 | } else { 102 | console.log(adaptor.outerHTML(node)); 103 | } 104 | -------------------------------------------------------------------------------- /direct/am2chtml-page: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env node 2 | 3 | /************************************************************************* 4 | * 5 | * direct/am2chtml-page 6 | * 7 | * Uses MathJax v3 to convert all AsciiMath in an HTML document. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2018 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | // 27 | // Load the packages needed for MathJax 28 | // 29 | const {mathjax} = require('mathjax-full/js/mathjax.js'); 30 | const {AsciiMath} = require('mathjax-full/js/input/asciimath.js'); 31 | const {CHTML} = require('mathjax-full/js/output/chtml.js'); 32 | const {liteAdaptor} = require('mathjax-full/js/adaptors/liteAdaptor.js'); 33 | const {RegisterHTMLHandler} = require('mathjax-full/js/handlers/html.js'); 34 | const {AssistiveMmlHandler} = require('mathjax-full/js/a11y/assistive-mml.js'); 35 | 36 | require('mathjax-full/js/util/entities/all.js'); 37 | 38 | // 39 | // Get the command-line arguments 40 | // 41 | var argv = require('yargs') 42 | .demand(1).strict() 43 | .usage('$0 [options] file.html > converted.html') 44 | .options({ 45 | em: { 46 | default: 16, 47 | describe: 'em-size in pixels' 48 | }, 49 | ex: { 50 | default: 8, 51 | describe: 'ex-size in pixels' 52 | }, 53 | fontURL: { 54 | default: 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/output/chtml/fonts/woff-v2', 55 | describe: 'the URL to use for web fonts' 56 | } 57 | }) 58 | .argv; 59 | 60 | // 61 | // Read the HTML file 62 | // 63 | const htmlfile = require('fs').readFileSync(argv._[0], 'utf8'); 64 | 65 | // 66 | // Create DOM adaptor and register it for HTML documents 67 | // 68 | const adaptor = liteAdaptor({fontSize: argv.em}); 69 | AssistiveMmlHandler(RegisterHTMLHandler(adaptor)); 70 | 71 | // 72 | // Create input and output jax and a document using them on the content from the HTML file 73 | // 74 | const asciimath = new AsciiMath(); 75 | const chtml = new CHTML({fontURL: argv.fontURL, exFactor: argv.ex / argv.em}); 76 | const html = mathjax.document(htmlfile, {InputJax: asciimath, OutputJax: chtml}); 77 | 78 | // 79 | // Typeset the document 80 | // 81 | html.render(); 82 | 83 | // 84 | // If no math was found on the page, remove the stylesheet 85 | // 86 | if (Array.from(html.math).length === 0) adaptor.remove(html.outputJax.chtmlStyles); 87 | 88 | // 89 | // Output the resulting HTML 90 | // 91 | console.log(adaptor.doctype(html.document)); 92 | console.log(adaptor.outerHTML(adaptor.root(html.document))); 93 | -------------------------------------------------------------------------------- /direct/am2mml: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env node 2 | 3 | /************************************************************************* 4 | * 5 | * direct/am2mml 6 | * 7 | * Uses MathJax v3 to convert an AsciiMath string to a MathML string. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2018 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | // 27 | // Load the packages needed for MathJax 28 | // 29 | const {AsciiMath} = require('mathjax-full/js/input/asciimath.js'); 30 | const {HTMLDocument} = require('mathjax-full/js/handlers/html/HTMLDocument.js'); 31 | const {liteAdaptor} = require('mathjax-full/js/adaptors/liteAdaptor.js'); 32 | const {STATE} = require('mathjax-full/js/core/MathItem.js'); 33 | 34 | // 35 | // Get the command-line arguments 36 | // 37 | var argv = require('yargs') 38 | .demand(0).strict() 39 | .usage('$0 [options] "math" > file.html') 40 | .argv; 41 | 42 | // 43 | // Create the input jax 44 | // 45 | const asciimath = new AsciiMath(); 46 | 47 | // 48 | // Create an HTML document using a LiteDocument and the input jax 49 | // 50 | const html = new HTMLDocument('', liteAdaptor(), {InputJax: asciimath}); 51 | 52 | // 53 | // Create a MathML serializer 54 | // 55 | const {SerializedMmlVisitor} = require('mathjax-full/js/core/MmlTree/SerializedMmlVisitor.js'); 56 | const visitor = new SerializedMmlVisitor(); 57 | const toMathML = (node => visitor.visitTree(node, html)); 58 | 59 | // 60 | // Convert the math from the command line to serialzied MathML 61 | // 62 | console.log(toMathML(html.convert(argv._[0] || '', {display: !argv.inline, end: STATE.CONVERT}))); 63 | -------------------------------------------------------------------------------- /direct/mml2chtml: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env node 2 | 3 | /************************************************************************* 4 | * 5 | * direct/mml2chtml 6 | * 7 | * Uses MathJax v3 to convert a MathML string to an HTML string. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2018 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | // 27 | // Load the packages needed for MathJax 28 | // 29 | const {mathjax} = require('mathjax-full/js/mathjax.js'); 30 | const {MathML} = require('mathjax-full/js/input/mathml.js'); 31 | const {CHTML} = require('mathjax-full/js/output/chtml.js'); 32 | const {liteAdaptor} = require('mathjax-full/js/adaptors/liteAdaptor.js'); 33 | const {RegisterHTMLHandler} = require('mathjax-full/js/handlers/html.js'); 34 | const {AssistiveMmlHandler} = require('mathjax-full/js/a11y/assistive-mml.js'); 35 | 36 | // 37 | // Get the command-line arguments 38 | // 39 | var argv = require('yargs') 40 | .demand(0).strict() 41 | .usage('$0 [options] "math" > file.html') 42 | .options({ 43 | em: { 44 | default: 16, 45 | describe: 'em-size in pixels' 46 | }, 47 | ex: { 48 | default: 8, 49 | describe: 'ex-size in pixels' 50 | }, 51 | width: { 52 | default: 80 * 16, 53 | describe: 'width of container in pixels' 54 | }, 55 | css: { 56 | boolean: true, 57 | describe: 'output the required CSS rather than the HTML itself' 58 | }, 59 | fontURL: { 60 | default: 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/output/chtml/fonts/woff-v2', 61 | describe: 'the URL to use for web fonts' 62 | }, 63 | assistiveMml: { 64 | boolean: true, 65 | default: false, 66 | describe: 'whether to include assistive MathML output' 67 | } 68 | }) 69 | .argv; 70 | 71 | // 72 | // Create DOM adaptor and register it for HTML documents 73 | // 74 | const adaptor = liteAdaptor({fontSize: argv.em}); 75 | const handler = RegisterHTMLHandler(adaptor); 76 | if (argv.assistiveMml) AssistiveMmlHandler(handler); 77 | 78 | // 79 | // Create input and output jax and a document using them on the content from the HTML file 80 | // 81 | const mml = new MathML(); 82 | const chtml = new CHTML({fontURL: argv.fontURL}); 83 | const html = mathjax.document('', {InputJax: mml, OutputJax: chtml}); 84 | 85 | // 86 | // Typeset the math from the command line 87 | // 88 | const node = html.convert(argv._[0] || '', { 89 | display: !argv.inline, 90 | em: argv.em, 91 | ex: argv.ex, 92 | containerWidth: argv.width 93 | }); 94 | 95 | // 96 | // If the --css option was specified, output the CSS, 97 | // Otherwise, typeset the math and output the HTML 98 | // 99 | if (argv.css) { 100 | console.log(adaptor.textContent(chtml.styleSheet(html))); 101 | } else { 102 | console.log(adaptor.outerHTML(node)); 103 | } 104 | -------------------------------------------------------------------------------- /direct/mml2chtml-page: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env node 2 | 3 | /************************************************************************* 4 | * 5 | * direct/mml2chtml-page 6 | * 7 | * Uses MathJax v3 to convert all MathML in an HTML document. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2018 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | // 27 | // Load the packages needed for MathJax 28 | // 29 | const {mathjax} = require('mathjax-full/js/mathjax.js'); 30 | const {MathML} = require('mathjax-full/js/input/mathml.js'); 31 | const {CHTML} = require('mathjax-full/js/output/chtml.js'); 32 | const {liteAdaptor} = require('mathjax-full/js/adaptors/liteAdaptor.js'); 33 | const {RegisterHTMLHandler} = require('mathjax-full/js/handlers/html.js'); 34 | const {AssistiveMmlHandler} = require('mathjax-full/js/a11y/assistive-mml.js'); 35 | 36 | require('mathjax-full/js/util/entities/all.js'); 37 | 38 | // 39 | // Get the command-line arguments 40 | // 41 | var argv = require('yargs') 42 | .demand(1).strict() 43 | .usage('$0 [options] file.html > converted.html') 44 | .options({ 45 | em: { 46 | default: 16, 47 | describe: 'em-size in pixels' 48 | }, 49 | ex: { 50 | default: 8, 51 | describe: 'ex-size in pixels' 52 | }, 53 | fontURL: { 54 | default: 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/output/chtml/fonts/woff-v2', 55 | describe: 'the URL to use for web fonts' 56 | } 57 | }) 58 | .argv; 59 | 60 | // 61 | // Read the HTML file 62 | // 63 | const htmlfile = require('fs').readFileSync(argv._[0], 'utf8'); 64 | 65 | // 66 | // Create DOM adaptor and register it for HTML documents 67 | // 68 | const adaptor = liteAdaptor({fontSize: argv.em}); 69 | AssistiveMmlHandler(RegisterHTMLHandler(adaptor)); 70 | 71 | // 72 | // Create input and output jax and a document using them on the content from the HTML file 73 | // 74 | const mathml = new MathML(); 75 | const chtml = new CHTML({fontURL: argv.fontURL, exFactor: argv.ex / argv.em}); 76 | const html = mathjax.document(htmlfile, {InputJax: mathml, OutputJax: chtml}); 77 | 78 | // 79 | // Typeset the document 80 | // 81 | html.render(); 82 | 83 | // 84 | // If no math was found on the page, remove the stylesheet 85 | // 86 | if (Array.from(html.math).length === 0) adaptor.remove(html.outputJax.chtmlStyles); 87 | 88 | // 89 | // Output the resulting HTML 90 | // 91 | console.log(adaptor.doctype(html.document)); 92 | console.log(adaptor.outerHTML(adaptor.root(html.document))); 93 | -------------------------------------------------------------------------------- /direct/mml2svg: -------------------------------------------------------------------------------- 1 | #! /usr/bin/env node 2 | 3 | /************************************************************************* 4 | * 5 | * direct/mml2svg 6 | * 7 | * Uses MathJax v3 to convert a MathML string to an SVG string. 8 | * 9 | * ---------------------------------------------------------------------- 10 | * 11 | * Copyright (c) 2018 The MathJax Consortium 12 | * 13 | * Licensed under the Apache License, Version 2.0 (the "License"); 14 | * you may not use this file except in compliance with the License. 15 | * You may obtain a copy of the License at 16 | * 17 | * http://www.apache.org/licenses/LICENSE-2.0 18 | * 19 | * Unless required by applicable law or agreed to in writing, software 20 | * distributed under the License is distributed on an "AS IS" BASIS, 21 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 22 | * See the License for the specific language governing permissions and 23 | * limitations under the License. 24 | */ 25 | 26 | // 27 | // Load the packages needed for MathJax 28 | // 29 | const {mathjax} = require('mathjax-full/js/mathjax.js'); 30 | const {MathML} = require('mathjax-full/js/input/mathml.js'); 31 | const {SVG} = require('mathjax-full/js/output/svg.js'); 32 | const {liteAdaptor} = require('mathjax-full/js/adaptors/liteAdaptor.js'); 33 | const {RegisterHTMLHandler} = require('mathjax-full/js/handlers/html.js'); 34 | const {AssistiveMmlHandler} = require('mathjax-full/js/a11y/assistive-mml.js'); 35 | 36 | // 37 | // Get the command-line arguments 38 | // 39 | var argv = require('yargs') 40 | .demand(0).strict() 41 | .usage('$0 [options] "math" > file.html') 42 | .options({ 43 | em: { 44 | default: 16, 45 | describe: 'em-size in pixels' 46 | }, 47 | ex: { 48 | default: 8, 49 | describe: 'ex-size in pixels' 50 | }, 51 | width: { 52 | default: 80 * 16, 53 | describe: 'width of container in pixels' 54 | }, 55 | styles: { 56 | boolean: true, 57 | default: true, 58 | describe: 'include css styles for stand-alone image' 59 | }, 60 | container: { 61 | boolean: true, 62 | describe: 'include