v0.5.0
This commit is contained in:
parent
ce99abd1f2
commit
dd2ec8a542
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"name": "KaTeX",
|
||||
"version": "0.4.2",
|
||||
"version": "0.5.0",
|
||||
"main": [
|
||||
"dist/katex.min.js",
|
||||
"dist/katex.min.css"
|
||||
|
|
64
dist/README.md
vendored
Normal file
64
dist/README.md
vendored
Normal file
|
@ -0,0 +1,64 @@
|
|||
# [<img src="https://khan.github.io/KaTeX/katex-logo.svg" width="130" alt="KaTeX">](https://khan.github.io/KaTeX/) [](https://travis-ci.org/Khan/KaTeX)
|
||||
|
||||
KaTeX is a fast, easy-to-use JavaScript library for TeX math rendering on the web.
|
||||
|
||||
* **Fast:** KaTeX renders its math synchronously and doesn't need to reflow the page. See how it compares to a competitor in [this speed test](http://jsperf.com/katex-vs-mathjax/).
|
||||
* **Print quality:** KaTeX’s layout is based on Donald Knuth’s TeX, the gold standard for math typesetting.
|
||||
* **Self contained:** KaTeX has no dependencies and can easily be bundled with your website resources.
|
||||
* **Server side rendering:** KaTeX produces the same output regardless of browser or environment, so you can pre-render expressions using Node.js and send them as plain HTML.
|
||||
|
||||
KaTeX supports all major browsers, including Chrome, Safari, Firefox, Opera, and IE 8 - IE 11. A list of supported commands can be on the [wiki](https://github.com/Khan/KaTeX/wiki/Function-Support-in-KaTeX).
|
||||
|
||||
## Usage
|
||||
|
||||
You can [download KaTeX](https://github.com/khan/katex/releases) and host it on your server or include the `katex.min.js` and `katex.min.css` files on your page directly from a CDN:
|
||||
|
||||
```html
|
||||
<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/KaTeX/0.3.0/katex.min.css">
|
||||
<script src="//cdnjs.cloudflare.com/ajax/libs/KaTeX/0.3.0/katex.min.js"></script>
|
||||
```
|
||||
|
||||
#### In-browser rendering
|
||||
|
||||
Call `katex.render` with a TeX expression and a DOM element to render into:
|
||||
|
||||
```js
|
||||
katex.render("c = \\pm\\sqrt{a^2 + b^2}", element);
|
||||
```
|
||||
|
||||
If KaTeX can't parse the expression, it throws a `katex.ParseError` error.
|
||||
|
||||
#### Server side rendering or rendering to a string
|
||||
|
||||
To generate HTML on the server or to generate an HTML string of the rendered math, you can use `katex.renderToString`:
|
||||
|
||||
```js
|
||||
var html = katex.renderToString("c = \\pm\\sqrt{a^2 + b^2}");
|
||||
// '<span class="katex">...</span>'
|
||||
```
|
||||
|
||||
Make sure to include the CSS and font files, but there is no need to include the JavaScript. Like `render`, `renderToString` throws if it can't parse the expression.
|
||||
|
||||
#### Rendering options
|
||||
|
||||
You can provide an object of options as the last argument to `katex.render` and `katex.renderToString`. Available options are:
|
||||
|
||||
- `displayMode`: `boolean`. If `true` the math will be rendered in display mode, which will put the math in display style (so `\int` and `\sum` are large, for example), and will center the math on the page on its own line. If `false` the math will be rendered in inline mode. (default: `false`)
|
||||
|
||||
For example:
|
||||
|
||||
```js
|
||||
katex.render("c = \\pm\\sqrt{a^2 + b^2}", element, { displayMode: true });
|
||||
```
|
||||
|
||||
#### Automatic rendering of math on a page
|
||||
|
||||
Math on the page can be automatically rendered using the auto-render extension. See [the Auto-render README](contrib/auto-render/README.md) for more information.
|
||||
|
||||
## Contributing
|
||||
|
||||
See [CONTRIBUTING.md](CONTRIBUTING.md)
|
||||
|
||||
## License
|
||||
|
||||
KaTeX is licensed under the [MIT License](http://opensource.org/licenses/MIT).
|
1
dist/contrib/auto-render.min.js
vendored
Normal file
1
dist/contrib/auto-render.min.js
vendored
Normal file
|
@ -0,0 +1 @@
|
|||
(function(e){if("function"==typeof bootstrap)bootstrap("rendermathinelement",e);else if("object"==typeof exports)module.exports=e();else if("function"==typeof define&&define.amd)define(e);else if("undefined"!=typeof ses){if(!ses.ok())return;ses.makeRenderMathInElement=e}else"undefined"!=typeof window?window.renderMathInElement=e():global.renderMathInElement=e()})(function(){var e,t,r,n,a;return function i(e,t,r){function n(o,l){if(!t[o]){if(!e[o]){var f=typeof require=="function"&&require;if(!l&&f)return f(o,!0);if(a)return a(o,!0);throw new Error("Cannot find module '"+o+"'")}var s=t[o]={exports:{}};e[o][0].call(s.exports,function(t){var r=e[o][1][t];return n(r?r:t)},s,s.exports,i,e,t,r)}return t[o].exports}var a=typeof require=="function"&&require;for(var o=0;o<r.length;o++)n(r[o]);return n}({1:[function(e,t,r){var n=e("./splitAtDelimiters");var a=function(e,t){var r=[{type:"text",data:e}];for(var a=0;a<t.length;a++){var i=t[a];r=n(r,i.left,i.right,i.display||false)}return r};var i=function(e,t){var r=a(e,t);var n=document.createDocumentFragment();for(var i=0;i<r.length;i++){if(r[i].type==="text"){n.appendChild(document.createTextNode(r[i].data))}else{var o=document.createElement("span");var l=r[i].data;try{katex.render(l,o,{displayMode:r[i].display})}catch(f){if(!(f instanceof katex.ParseError)){throw f}console.error("KaTeX auto-render: Failed to parse `"+r[i].data+"` with ",f);n.appendChild(document.createTextNode(r[i].rawData));continue}n.appendChild(o)}}return n};var o=function(e,t,r){for(var n=0;n<e.childNodes.length;n++){var a=e.childNodes[n];if(a.nodeType===3){var l=i(a.textContent,t);n+=l.childNodes.length-1;e.replaceChild(l,a)}else if(a.nodeType===1){var f=r.indexOf(a.nodeName.toLowerCase())===-1;if(f){o(a,t,r)}}}};var l={delimiters:[{left:"$$",right:"$$",display:true},{left:"\\[",right:"\\]",display:true},{left:"\\(",right:"\\)",display:false}],ignoredTags:["script","noscript","style","textarea","pre","code"]};var f=function(e){var t,r;for(var n=1,a=arguments.length;n<a;n++){t=arguments[n];for(r in t){if(Object.prototype.hasOwnProperty.call(t,r)){e[r]=t[r]}}}return e};var s=function(e,t){if(!e){throw new Error("No element provided to render")}t=f({},l,t);o(e,t.delimiters,t.ignoredTags)};t.exports=s},{"./splitAtDelimiters":2}],2:[function(e,t,r){var n=function(e,t,r){var n=r;var a=0;var i=e.length;while(n<t.length){var o=t[n];if(a<=0&&t.slice(n,n+i)===e){return n}else if(o==="\\"){n++}else if(o==="{"){a++}else if(o==="}"){a--}n++}return-1};var a=function(e,t,r,a){var i=[];for(var o=0;o<e.length;o++){if(e[o].type==="text"){var l=e[o].data;var f=true;var s=0;var d;d=l.indexOf(t);if(d!==-1){s=d;i.push({type:"text",data:l.slice(0,s)});f=false}while(true){if(f){d=l.indexOf(t,s);if(d===-1){break}i.push({type:"text",data:l.slice(s,d)});s=d}else{d=n(r,l,s+t.length);if(d===-1){break}i.push({type:"math",data:l.slice(s+t.length,d),rawData:l.slice(s,d+r.length),display:a});s=d+r.length}f=!f}i.push({type:"text",data:l.slice(s)})}else{i.push(e[o])}}return i};t.exports=a},{}]},{},[1])(1)});
|
BIN
dist/fonts/KaTeX_AMS-Regular.eot
vendored
Normal file
BIN
dist/fonts/KaTeX_AMS-Regular.eot
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_AMS-Regular.ttf
vendored
Normal file
BIN
dist/fonts/KaTeX_AMS-Regular.ttf
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_AMS-Regular.woff
vendored
Normal file
BIN
dist/fonts/KaTeX_AMS-Regular.woff
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_AMS-Regular.woff2
vendored
Normal file
BIN
dist/fonts/KaTeX_AMS-Regular.woff2
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Main-Bold.eot
vendored
Normal file
BIN
dist/fonts/KaTeX_Main-Bold.eot
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Main-Bold.ttf
vendored
Normal file
BIN
dist/fonts/KaTeX_Main-Bold.ttf
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Main-Bold.woff
vendored
Normal file
BIN
dist/fonts/KaTeX_Main-Bold.woff
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Main-Bold.woff2
vendored
Normal file
BIN
dist/fonts/KaTeX_Main-Bold.woff2
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Main-Italic.eot
vendored
Normal file
BIN
dist/fonts/KaTeX_Main-Italic.eot
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Main-Italic.ttf
vendored
Normal file
BIN
dist/fonts/KaTeX_Main-Italic.ttf
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Main-Italic.woff
vendored
Normal file
BIN
dist/fonts/KaTeX_Main-Italic.woff
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Main-Italic.woff2
vendored
Normal file
BIN
dist/fonts/KaTeX_Main-Italic.woff2
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Main-Regular.eot
vendored
Normal file
BIN
dist/fonts/KaTeX_Main-Regular.eot
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Main-Regular.ttf
vendored
Normal file
BIN
dist/fonts/KaTeX_Main-Regular.ttf
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Main-Regular.woff
vendored
Normal file
BIN
dist/fonts/KaTeX_Main-Regular.woff
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Main-Regular.woff2
vendored
Normal file
BIN
dist/fonts/KaTeX_Main-Regular.woff2
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Math-BoldItalic.eot
vendored
Normal file
BIN
dist/fonts/KaTeX_Math-BoldItalic.eot
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Math-BoldItalic.ttf
vendored
Normal file
BIN
dist/fonts/KaTeX_Math-BoldItalic.ttf
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Math-BoldItalic.woff
vendored
Normal file
BIN
dist/fonts/KaTeX_Math-BoldItalic.woff
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Math-BoldItalic.woff2
vendored
Normal file
BIN
dist/fonts/KaTeX_Math-BoldItalic.woff2
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Math-Italic.eot
vendored
Normal file
BIN
dist/fonts/KaTeX_Math-Italic.eot
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Math-Italic.ttf
vendored
Normal file
BIN
dist/fonts/KaTeX_Math-Italic.ttf
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Math-Italic.woff
vendored
Normal file
BIN
dist/fonts/KaTeX_Math-Italic.woff
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Math-Italic.woff2
vendored
Normal file
BIN
dist/fonts/KaTeX_Math-Italic.woff2
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Math-Regular.eot
vendored
Normal file
BIN
dist/fonts/KaTeX_Math-Regular.eot
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Math-Regular.ttf
vendored
Normal file
BIN
dist/fonts/KaTeX_Math-Regular.ttf
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Math-Regular.woff
vendored
Normal file
BIN
dist/fonts/KaTeX_Math-Regular.woff
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Math-Regular.woff2
vendored
Normal file
BIN
dist/fonts/KaTeX_Math-Regular.woff2
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size1-Regular.eot
vendored
Normal file
BIN
dist/fonts/KaTeX_Size1-Regular.eot
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size1-Regular.ttf
vendored
Normal file
BIN
dist/fonts/KaTeX_Size1-Regular.ttf
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size1-Regular.woff
vendored
Normal file
BIN
dist/fonts/KaTeX_Size1-Regular.woff
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size1-Regular.woff2
vendored
Normal file
BIN
dist/fonts/KaTeX_Size1-Regular.woff2
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size2-Regular.eot
vendored
Normal file
BIN
dist/fonts/KaTeX_Size2-Regular.eot
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size2-Regular.ttf
vendored
Normal file
BIN
dist/fonts/KaTeX_Size2-Regular.ttf
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size2-Regular.woff
vendored
Normal file
BIN
dist/fonts/KaTeX_Size2-Regular.woff
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size2-Regular.woff2
vendored
Normal file
BIN
dist/fonts/KaTeX_Size2-Regular.woff2
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size3-Regular.eot
vendored
Normal file
BIN
dist/fonts/KaTeX_Size3-Regular.eot
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size3-Regular.ttf
vendored
Normal file
BIN
dist/fonts/KaTeX_Size3-Regular.ttf
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size3-Regular.woff
vendored
Normal file
BIN
dist/fonts/KaTeX_Size3-Regular.woff
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size3-Regular.woff2
vendored
Normal file
BIN
dist/fonts/KaTeX_Size3-Regular.woff2
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size4-Regular.eot
vendored
Normal file
BIN
dist/fonts/KaTeX_Size4-Regular.eot
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size4-Regular.ttf
vendored
Normal file
BIN
dist/fonts/KaTeX_Size4-Regular.ttf
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size4-Regular.woff
vendored
Normal file
BIN
dist/fonts/KaTeX_Size4-Regular.woff
vendored
Normal file
Binary file not shown.
BIN
dist/fonts/KaTeX_Size4-Regular.woff2
vendored
Normal file
BIN
dist/fonts/KaTeX_Size4-Regular.woff2
vendored
Normal file
Binary file not shown.
1
dist/katex.min.css
vendored
Normal file
1
dist/katex.min.css
vendored
Normal file
File diff suppressed because one or more lines are too long
5
dist/katex.min.js
vendored
Normal file
5
dist/katex.min.js
vendored
Normal file
File diff suppressed because one or more lines are too long
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"name": "katex",
|
||||
"version": "0.4.2",
|
||||
"version": "0.5.0",
|
||||
"description": "Fast math typesetting for the web.",
|
||||
"main": "katex.js",
|
||||
"repository": {
|
||||
|
|
Loading…
Reference in New Issue
Block a user