mirror of https://github.com/Smaug123/KaTeX synced 2025-10-06 03:38:39 +00:00

Files

Ryan Randall fbffdc5fc7 Webpack dev server (#902 )

* Initial webpack config. Moving to ES6 modules. Some module cleanup.

* WIP

* WIP

* Removing commented out code.

* Removing old deps.

* Removing the build script (used for testing).

* Working tests.

* Switching to node api over cli.

* Updating per comments. Still need to fix server.js to properly run the selenium tests.

* Cleaning up the config.

* More cleanup.

* Bringing back server.js for selenium tests.

* Bringing back old dependencies.

* Adding back eslint rules for webpack config. Final cleanup for webpack config.

* Pointing to correct pre-existing module versions. Adding some extra logic to server.js to ensure it gets transpiled properly.

* Getting make build to work again. Updating package.json with some shortcut scripts.

* Resolving conflict.

* Reverting back to commonjs modules.

* Removing extra spaces in babelrc

2017-09-26 12:16:35 -06:00

auto-render-spec.js

Switch from jasmine to jest (#747 )

2017-07-11 14:16:26 -04:00

auto-render.js

Webpack dev server (#902 )

2017-09-26 12:16:35 -06:00

index.html

Add documentation for how to run auto-render example (#740 )

2017-06-25 17:47:46 -04:00

Makefile

copy-tex contrib module (#813 )

2017-09-04 21:17:46 -04:00

README.md

Bump master to v0.8.4-pre

2017-08-27 18:01:07 -04:00

splitAtDelimiters.js

Webpack dev server (#902 )

2017-09-26 12:16:35 -06:00

README.md

Auto-render extension

This is an extension to automatically render all of the math inside of text. It searches all of the text nodes in a given element for the given delimiters, and renders the math in place.

Usage

This extension isn't part of KaTeX proper, so the script should be separately included in the page:

<script src="https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.8.3/contrib/auto-render.min.js" integrity="sha384-RkgGHBDdR8eyBOoWeZ/vpGg1cOvSAJRflCUDACusAAIVwkwPrOUYykglPeqWakZu" crossorigin="anonymous"></script>

Then, call the exposed renderMathInElement function in a script tag before the close body tag:

<body>
  ...
  <script>
    renderMathInElement(document.body);
  </script>
</body>

See index.html for an example. (To run this example from a clone of the repository, run make serve in the root KaTeX directory, and then visit http://0.0.0.0:7936/contrib/auto-render/index.html with your web browser.)

If you prefer to have all your setup inside the html <head>, you can use the following script there (instead of the one above at the end of the <body>):

<head>
  ...
  <script>
    document.addEventListener("DOMContentLoaded", function() {
      renderMathInElement(document.body);
    });
  </script>
  ...
</head>

API

This extension exposes a single function, window.renderMathInElement, with the following API:

function renderMathInElement(elem, options)

elem is an HTML DOM element. The function will recursively search for text nodes inside this element and render the math in them.

options is an optional object argument that can have the same keys as the object passed to katex.render, in addition to two auto-render-specific keys:

delimiters: This is a list of delimiters to look for math. Each delimiter has three properties:
- left: A string which starts the math expression (i.e. the left delimiter).
- right: A string which ends the math expression (i.e. the right delimiter).
- display: A boolean of whether the math in the expression should be rendered in display mode or not.
The default value is:
```
[
  {left: "$$", right: "$$", display: true},
  {left: "\\[", right: "\\]", display: true},
  {left: "\$", right: "\$", display: false}
]
```
ignoredTags: This is a list of DOM node types to ignore when recursing through. The default value is ["script", "noscript", "style", "textarea", "pre", "code"].
errorCallback: A callback method returning a message and an error stack in case of an critical error during rendering. The default uses console.error.

Note that the displayMode property of the options object is ignored, and is instead taken from the display key of the corresponding entry in the delimiters key.