This guide describes how to use the MathLive Javascript library with your own
web content.
To contribute to the MathLive project, see the {@tutorial CONTRIBUTOR_GUIDE}.
## Getting Started
Install MathLive from gitHub or from NPM.
### From GitHub
You can find MathLive at [https://github.com/arnog/mathlive/](https://github.com/arnog/mathlive/)
The `dist/` directory contains all you need to use MathLive. MathLive has no
dependency on other libraries (not even jQuery!) and you do not need to
download or install anything else.
The `dist/` directory contains the following:
- `mathlive.js` The MathLive Javascript library. It is an optimized and minified
Javascript file which exports the [`MathLive`]{@link module:mathlive}
module which gives access to the MathLive API.
- `mathlive-core.css` The minimal amount of CSS to display math with MathLive.
- `mathlive.css` The rest of the CSS you need to display math. You can load
this file lazily to improve your page load time.
- `fonts/` A directory of fonts used by MathLive. Credit for those fonts goes to
the KaTeX project.
### From NPM
```bash
$ npm install -g mathlive
```
### Using MathLive in your project
Include the following in your web page. Adjust the `src` and `href` arguments
to account for your directory structure.
```html
...
...
```
## Rendering Math Automatically
Call [`MathLive.renderMathInDocument()`]{@link module:mathlive#renderMathInDocument}
at the end of your document, or in a `onload` handler to render math contained
in the document.
```html
...