Each directory listed contains a MathJax extension which can be used in a document with the MathJax CDN configuration.
A typical configuration using one of these extensions will include the following within the <head>...</head>
portion of your HTML document:
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
TeX: {
extensions: ["http://cs.jsu.edu/mathjax-ext/github/extname/extname.js"]
}
});
</script>
<script type="text/javascript"
src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>
Please note the extension URL: this is not on GitHub, but is updated nightly from the GitHub master branch.
Some extensions may require additional configuration -- for details, see the README
in the directory for the extension.
The extensions can also be downloaded and stored for local use -- just be sure to change the URL in the loadComplete()
call at the end of the extension JavaScript file, and the URL in the MathJax configuration.
Each extension also has a sample page, which can be found in the gh-pages
branch.
All extensions here are made available as source code, under terms of the Apache license version 2.0 -- see the file License.txt
listed above for terms and details. Author attributions and copyright notices are contained in each file or its associated README.md
file. Unless otherwise noted there, copyright remains with the author, with reuse and redistribution only permitted subject to the terms of the license.
If you wish to submit an extension, the instructions are below, but be aware that your material will be available here under the same terms, i.e. as source code and under the terms of the Apache license version 2.0. For the purposes of this repository, issuing a pull request constitutes an implicit agreement to having these license terms applied to your materials.
All extensions have been tested with MathJax version 2.1 on the CDN.
All extensions have been tested with MathJax version 2.0 on the CDN.
This did require minor bug fixes in the forminput
and forloop
extensions (the corrections do not affect
function in MathJax version 1.1).
Developers are welcome to place their extensions here (by issuing a pull request), but please observe the following guidelines:
-
Directory and file naming: Please place your extension in a separate directory,
extname
, and place the main JavaScript file for the extension,extname.js
, in that directory (replaceextname
with the name of your extension). -
README: Please include a
README.md
file in theextname
directory with configuration and usage documentation -- see the existing extensions for examples. -
Sample: Please include a sample file
sample.html
in theextname
directory in thegh-pages
branch, with a sample demonstrating configuration and usage of your extension, and link to the sample in yourREADME.md
file. (You will need to make a separate pull request for your commit to thegh-pages
branch.) -
URLs: For testing purposes, a
raw.github.com
URL is acceptable on a temporary basis, but before you make your pull request to merge into the master branch, please change the URL tohttp://cs.jsu.edu/mathjax-ext/github/extname/extname.js
in theloadComplete()
call at the end ofextname.js
and in the configuration block of your sample. -
MathJax CDN: Please test your extension against the MathJax CDN as shown in the configuration above, and set up your sample file to use the CDN.
Please note that your files will not be available immediately on the cs.jsu.edu
URL -- this site is updated nightly from the master branch here. Also please note that the sample file sample.html
in the gh-pages
branch is not transfered to the cs.jsu.edu
site -- the URL for the sample will be http://leathrum.github.com/mathjax-ext-contrib/extname/sample.html
.