mirror of
https://github.com/Smaug123/KaTeX
synced 2025-10-06 11:48:41 +00:00
Replace Khan/KaTeX with KaTeX/KaTeX (#1781)
* Replace Khan/KaTeX with KaTeX/KaTeX * Remove RawGit links * Remove old files
This commit is contained in:
committed by
Kevin Barabash
parent
f4e24183d6
commit
112582daa5
@@ -68,7 +68,7 @@ function renderMathInElement(elem, options)
|
||||
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`](https://github.com/Khan/KaTeX/#rendering-options),
|
||||
object passed to `katex.render`](https://github.com/KaTeX/KaTeX/#rendering-options),
|
||||
in addition to two auto-render-specific keys:
|
||||
|
||||
- `delimiters`: This is a list of delimiters to look for math. Each delimiter
|
||||
|
@@ -64,7 +64,7 @@ Chrome DevTools Network panel or similar to find out which fonts are used.
|
||||
to provide a fallback for older browsers that do not support ES modules.
|
||||
|
||||
## Download & Host Things Yourself
|
||||
Download a [KaTeX release](https://github.com/Khan/KaTeX/releases),
|
||||
Download a [KaTeX release](https://github.com/KaTeX/KaTeX/releases),
|
||||
copy `katex.js`, `katex.css`
|
||||
(or `katex.min.js` and `katex.min.css` to use minified versions),
|
||||
and the `fonts` directory, and include or import it like above.
|
||||
|
@@ -7,8 +7,8 @@ title: Extensions & Libraries
|
||||
These extensions are provided by KaTeX.
|
||||
|
||||
- [Auto-render](autorender.md): Automatically renders all of the math inside text
|
||||
- [Copy-tex](https://github.com/Khan/KaTeX/tree/master/contrib/copy-tex): When selecting and copying KaTeX-rendered elements, copies their LaTeX source to the clipboard
|
||||
- [`math/tex` Custom Script Type](https://github.com/Khan/KaTeX/tree/master/contrib/mathtex-script-type): Automatically displays LaTeX math inside `script` tags with `type=math/tex`
|
||||
- [Copy-tex](https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex): When selecting and copying KaTeX-rendered elements, copies their LaTeX source to the clipboard
|
||||
- [`math/tex` Custom Script Type](https://github.com/KaTeX/KaTeX/tree/master/contrib/mathtex-script-type): Automatically displays LaTeX math inside `script` tags with `type=math/tex`
|
||||
|
||||
## Libraries
|
||||
|
||||
|
@@ -26,7 +26,7 @@ To build you will need Git, Node.js 6.9 or later, and Yarn.
|
||||
|
||||
Clone a copy of the GitHub source repository:
|
||||
```bash
|
||||
git clone https://github.com/Khan/KaTeX.git
|
||||
git clone https://github.com/KaTeX/KaTeX.git
|
||||
cd KaTeX
|
||||
```
|
||||
|
||||
@@ -45,7 +45,7 @@ npm install /path/to/KaTeX
|
||||
```
|
||||
|
||||
> You can manually download the package and source code from
|
||||
[GitHub releases](https://github.com/Khan/KaTeX/releases).
|
||||
[GitHub releases](https://github.com/KaTeX/KaTeX/releases).
|
||||
|
||||
## Importing
|
||||
KaTeX is exported as a CommonJS module, which can be imported using `require`:
|
||||
|
@@ -7,7 +7,7 @@ You can provide an object of options as the last argument to [`katex.render` and
|
||||
- `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`)
|
||||
- `throwOnError`: `boolean`. If `true` (the default), KaTeX will throw a `ParseError` when it encounters an unsupported command or invalid LaTeX. If `false`, KaTeX will render unsupported commands as text, and render invalid LaTeX as its source code with hover text giving the error, in the color given by `errorColor`.
|
||||
- `errorColor`: `string`. A color string given in the format `"#XXX"` or `"#XXXXXX"`. This option determines the color that unsupported commands and invalid LaTeX are rendered in when `throwOnError` is set to `false`. (default: `#cc0000`)
|
||||
- `macros`: `object`. A collection of custom macros. Each macro is a property with a name like `\name` (written `"\\name"` in JavaScript) which maps to a string that describes the expansion of the macro, or a function that accepts an instance of `MacroExpander` as first argument and returns the expansion as a string. `MacroExpander` is an internal API and subject to non-backwards compatible changes. See [`src/macros.js`](https://github.com/Khan/KaTeX/blob/master/src/macros.js) for its usage. Single-character keys can also be included in which case the character will be redefined as the given macro (similar to TeX active characters). *This object will be modified* if the LaTeX code defines its own macros via `\gdef`, which enables consecutive calls to KaTeX to share state.
|
||||
- `macros`: `object`. A collection of custom macros. Each macro is a property with a name like `\name` (written `"\\name"` in JavaScript) which maps to a string that describes the expansion of the macro, or a function that accepts an instance of `MacroExpander` as first argument and returns the expansion as a string. `MacroExpander` is an internal API and subject to non-backwards compatible changes. See [`src/macros.js`](https://github.com/KaTeX/KaTeX/blob/master/src/macros.js) for its usage. Single-character keys can also be included in which case the character will be redefined as the given macro (similar to TeX active characters). *This object will be modified* if the LaTeX code defines its own macros via `\gdef`, which enables consecutive calls to KaTeX to share state.
|
||||
- `colorIsTextColor`: `boolean`. If `true`, `\color` will work like LaTeX's `\textcolor`, and take two arguments (e.g., `\color{blue}{hello}`), which restores the old behavior of KaTeX (pre-0.8.0). If `false` (the default), `\color` will work like LaTeX's `\color`, and take one argument (e.g., `\color{blue}hello`). In both cases, `\textcolor` works as in LaTeX (e.g., `\textcolor{blue}{hello}`).
|
||||
- `maxSize`: `number`. All user-specified sizes, e.g. in `\rule{500em}{500em}`, will be capped to `maxSize` ems. If set to `Infinity` (the default), users can make elements and spaces arbitrarily large.
|
||||
- `maxExpand`: `number`. Limit the number of macro expansions to the specified number, to prevent e.g. infinite macro loops. If set to `Infinity`, the macro expander will try to fully expand as in LaTeX. (default: 1000)
|
||||
|
@@ -145,13 +145,13 @@ table td {
|
||||
|\bigm|$\bigm\vert$|`\bigm\vert`|
|
||||
|\Bigm|$\Bigm\vert$|`\Bigm\vert`|
|
||||
|\bigodot|$\bigodot$||
|
||||
|\bigominus|<span style="color:firebrick;">Not supported</span>|[Issue #1222](https://github.com/Khan/KaTeX/issues/1222)|
|
||||
|\bigominus|<span style="color:firebrick;">Not supported</span>|[Issue #1222](https://github.com/KaTeX/KaTeX/issues/1222)|
|
||||
|\bigoplus|$\bigoplus$||
|
||||
|\bigoslash|<span style="color:firebrick;">Not supported</span>|[Issue #1222](https://github.com/Khan/KaTeX/issues/1222)|
|
||||
|\bigoslash|<span style="color:firebrick;">Not supported</span>|[Issue #1222](https://github.com/KaTeX/KaTeX/issues/1222)|
|
||||
|\bigotimes|$\bigotimes$||
|
||||
|\bigr|$\bigr)$|`\bigr)`|
|
||||
|\Bigr|$\Bigr)$|`\Bigr)`|
|
||||
|\bigsqcap|<span style="color:firebrick;">Not supported</span>|[Issue #1222](https://github.com/Khan/KaTeX/issues/1222)|
|
||||
|\bigsqcap|<span style="color:firebrick;">Not supported</span>|[Issue #1222](https://github.com/KaTeX/KaTeX/issues/1222)|
|
||||
|\bigsqcup|$\bigsqcup$||
|
||||
|\bigstar|$\bigstar$||
|
||||
|\bigtriangledown|$\bigtriangledown$||
|
||||
@@ -227,7 +227,7 @@ table td {
|
||||
|\circledR|$\circledR$||
|
||||
|\circledS|$\circledS$||
|
||||
|\class|<span style="color:firebrick;">Not supported</span>|A PR is pending.
|
||||
|\cline|<span style="color:firebrick;">Not supported</span>|[Issue #269](https://github.com/Khan/KaTeX/issues/269)|
|
||||
|\cline|<span style="color:firebrick;">Not supported</span>|[Issue #269](https://github.com/KaTeX/KaTeX/issues/269)|
|
||||
|\clubs|$\clubs$||
|
||||
|\clubsuit|$\clubsuit$||
|
||||
|\cnums|$\cnums$||
|
||||
@@ -295,7 +295,7 @@ table td {
|
||||
|\ddots|$\ddots$||
|
||||
|\DeclareMathOperator|<span style="color:firebrick;">Not supported</span>||
|
||||
|\def|$\def\foo{x^2} \foo + \foo$|`\def\foo{x^2} \foo + \foo`|
|
||||
|\definecolor|<span style="color:firebrick;">Not supported</span>|[Issue #750](https://github.com/Khan/KaTeX/issues/750)|
|
||||
|\definecolor|<span style="color:firebrick;">Not supported</span>|[Issue #750](https://github.com/KaTeX/KaTeX/issues/750)|
|
||||
|\deg|$\deg$||
|
||||
|\degree|$\degree$||
|
||||
|\delta|$\delta$||
|
||||
@@ -340,7 +340,7 @@ table td {
|
||||
|Symbol/Function | Rendered | Source or Comment|
|
||||
|:---------------|:------------|:-----------------|
|
||||
|\ell|$\ell$||
|
||||
|\else|<span style="color:firebrick;">Not supported</span>|[Issue #1003](https://github.com/Khan/KaTeX/issues/1003)|
|
||||
|\else|<span style="color:firebrick;">Not supported</span>|[Issue #1003](https://github.com/KaTeX/KaTeX/issues/1003)|
|
||||
|\empty|$\empty$||
|
||||
|\emptyset|$\emptyset$||
|
||||
|\enclose|<span style="color:firebrick;">Not supported</span>|Non standard
|
||||
@@ -354,11 +354,11 @@ table td {
|
||||
|\eqcirc|$\eqcirc$||
|
||||
|\Eqcolon|$\Eqcolon$||
|
||||
|\eqcolon|$\eqcolon$||
|
||||
|{equation}|<span style="color:firebrick;">Not supported</span>|[Issue #445](https://github.com/Khan/KaTeX/issues/445)|
|
||||
|{equation}|<span style="color:firebrick;">Not supported</span>|[Issue #445](https://github.com/KaTeX/KaTeX/issues/445)|
|
||||
|{eqnarray}|<span style="color:firebrick;">Not supported</span>||
|
||||
|\Eqqcolon|$\Eqqcolon$||
|
||||
|\eqqcolon|$\eqqcolon$||
|
||||
|\eqref|<span style="color:firebrick;">Not supported</span>|[Issue #350](https://github.com/Khan/KaTeX/issues/350)|
|
||||
|\eqref|<span style="color:firebrick;">Not supported</span>|[Issue #350](https://github.com/KaTeX/KaTeX/issues/350)|
|
||||
|\eqsim|$\eqsim$||
|
||||
|\eqslantgtr|$\eqslantgtr$||
|
||||
|\eqslantless|$\eqslantless$||
|
||||
@@ -378,7 +378,7 @@ table td {
|
||||
|\fallingdotseq|$\fallingdotseq$||
|
||||
|\fbox|$\fbox{Hi there!}$|`\fbox{Hi there!}`|
|
||||
|\fcolorbox|$\fcolorbox{red}{aqua}{A}$|`\fcolorbox{red}{aqua}{A}`|
|
||||
|\fi|<span style="color:firebrick;">Not supported</span>|[Issue #1003](https://github.com/Khan/KaTeX/issues/1003)|
|
||||
|\fi|<span style="color:firebrick;">Not supported</span>|[Issue #1003](https://github.com/KaTeX/KaTeX/issues/1003)|
|
||||
|\Finv|$\Finv$||
|
||||
|\flat|$\flat$||
|
||||
|\footnotesize|$\footnotesize footnotesize$|`\footnotesize footnotesize`|
|
||||
@@ -441,7 +441,7 @@ table td {
|
||||
|\hearts|$\hearts$||
|
||||
|\heartsuit|$\heartsuit$||
|
||||
|\hfil|<span style="color:firebrick;">Not supported</span>||
|
||||
|\hfill|<span style="color:firebrick;">Not supported</span>|Issues [#164](https://github.com/Khan/KaTeX/issues/164) & [#269](https://github.com/Khan/KaTeX/issues/269)|
|
||||
|\hfill|<span style="color:firebrick;">Not supported</span>|Issues [#164](https://github.com/KaTeX/KaTeX/issues/164) & [#269](https://github.com/KaTeX/KaTeX/issues/269)|
|
||||
|\hline|$\begin{matrix}a&b\\ \hline c &d\end{matrix}$|`\begin{matrix}`<br> `a & b \\ \hline`<br> `c & d`<br>`\end{matrix}`|
|
||||
|\hom|$\hom$||
|
||||
|\hookleftarrow|$\hookleftarrow$||
|
||||
@@ -460,11 +460,11 @@ table td {
|
||||
|:---------------|:------------|:-----------------|
|
||||
|\i|$\text{\i}$|`\text{\i}`|
|
||||
|\idotsint|<span style="color:firebrick;">Not supported</span>||
|
||||
|\iddots|<span style="color:firebrick;">Not supported</span>|[Issue #1223](https://github.com/Khan/KaTeX/issues/1223)|
|
||||
|\if|<span style="color:firebrick;">Not supported</span>|[Issue #1003](https://github.com/Khan/KaTeX/issues/1003)|
|
||||
|\iddots|<span style="color:firebrick;">Not supported</span>|[Issue #1223](https://github.com/KaTeX/KaTeX/issues/1223)|
|
||||
|\if|<span style="color:firebrick;">Not supported</span>|[Issue #1003](https://github.com/KaTeX/KaTeX/issues/1003)|
|
||||
|\iff|$A\iff B$|`A\iff B`|
|
||||
|\ifmode|<span style="color:firebrick;">Not supported</span>|[Issue #1003](https://github.com/Khan/KaTeX/issues/1003)|
|
||||
|\ifx|<span style="color:firebrick;">Not supported</span>|[Issue #1003](https://github.com/Khan/KaTeX/issues/1003)|
|
||||
|\ifmode|<span style="color:firebrick;">Not supported</span>|[Issue #1003](https://github.com/KaTeX/KaTeX/issues/1003)|
|
||||
|\ifx|<span style="color:firebrick;">Not supported</span>|[Issue #1003](https://github.com/KaTeX/KaTeX/issues/1003)|
|
||||
|\iiiint|<span style="color:firebrick;">Not supported</span>||
|
||||
|\iiint|$\iiint$||
|
||||
|\iint|$\iint$||
|
||||
@@ -553,7 +553,7 @@ table td {
|
||||
|\lesseqqgtr|$\lesseqqgtr$||
|
||||
|\lessgtr|$\lessgtr$||
|
||||
|\lesssim|$\lesssim$||
|
||||
|\let|<span style="color:firebrick;">Not supported</span>|[Issue #1413](https://github.com/Khan/KaTeX/issues/1413)|
|
||||
|\let|<span style="color:firebrick;">Not supported</span>|[Issue #1413](https://github.com/KaTeX/KaTeX/issues/1413)|
|
||||
|\lfloor|$\lfloor$||
|
||||
|\lg|$\lg$||
|
||||
|\lgroup|$\lgroup$||
|
||||
@@ -656,7 +656,7 @@ table td {
|
||||
|\mspace|<span style="color:firebrick;">Not supported</span>||
|
||||
|\Mu|$\Mu$||
|
||||
|\mu|$\mu$||
|
||||
|\multicolumn|<span style="color:firebrick;">Not supported</span>|[Issue #269](https://github.com/Khan/KaTeX/issues/269)|
|
||||
|\multicolumn|<span style="color:firebrick;">Not supported</span>|[Issue #269](https://github.com/KaTeX/KaTeX/issues/269)|
|
||||
|{multiline}|<span style="color:firebrick;">Not supported</span>||
|
||||
|\multimap|$\multimap$||
|
||||
|
||||
@@ -677,7 +677,7 @@ table td {
|
||||
|\negthinspace|$a\negthinspace b$|`a\negthinspace b`|
|
||||
|\neq|$\neq$||
|
||||
|\newcommand|$\newcommand\chk{\checkmark} \chk$|`\newcommand\chk{\checkmark} \chk`|
|
||||
|\newenvironment|<span style="color:firebrick;">Not supported</span>|[Issue #37](https://github.com/Khan/KaTeX/issues/37)|
|
||||
|\newenvironment|<span style="color:firebrick;">Not supported</span>|[Issue #37](https://github.com/KaTeX/KaTeX/issues/37)|
|
||||
|\Newextarrow|<span style="color:firebrick;">Not supported</span>||
|
||||
|\newline|$a\newline b$|`a\newline b`|
|
||||
|\nexists|$\nexists$||
|
||||
@@ -749,7 +749,7 @@ table td {
|
||||
|\omicron|$\omicron$||
|
||||
|\ominus|$\ominus$||
|
||||
|\operatorname|$\operatorname{asin} x$|\operatorname{asin} x|
|
||||
|\operatorname\*|<span style="color:firebrick;">Not supported</span>|[Issue #1242](https://github.com/Khan/KaTeX/issues/1242)|
|
||||
|\operatorname\*|<span style="color:firebrick;">Not supported</span>|[Issue #1242](https://github.com/KaTeX/KaTeX/issues/1242)|
|
||||
|\oplus|$\oplus$||
|
||||
|\or|<span style="color:firebrick;">Not supported</span>||
|
||||
|\oslash|$\oslash$||
|
||||
@@ -838,7 +838,7 @@ table td {
|
||||
|\real|$\real$||
|
||||
|\Reals|$\Reals$||
|
||||
|\reals|$\reals$||
|
||||
|\ref|<span style="color:firebrick;">Not supported</span>|[Issue #350](https://github.com/Khan/KaTeX/issues/350)|
|
||||
|\ref|<span style="color:firebrick;">Not supported</span>|[Issue #350](https://github.com/KaTeX/KaTeX/issues/350)|
|
||||
|\relax|||
|
||||
|\renewcommand|$\def\hail{Hi!}\renewcommand\hail{\text{Ahoy!}} \hail$|`\def\hail{Hi!}`<br>`\renewcommand\hail{\text{Ahoy!}}`<br>`\hail`|
|
||||
|\renewenvironment|<span style="color:firebrick;">Not supported</span>||
|
||||
@@ -865,7 +865,7 @@ table td {
|
||||
|\rm|$\rm AaBb12$|`\rm AaBb12`|
|
||||
|\rmoustache|$\rmoustache$||
|
||||
|\root|<span style="color:firebrick;">Not supported</span>||
|
||||
|\rotatebox|<span style="color:firebrick;">Not supported</span>|[Issue #681](https://github.com/Khan/KaTeX/issues/681)|
|
||||
|\rotatebox|<span style="color:firebrick;">Not supported</span>|[Issue #681](https://github.com/KaTeX/KaTeX/issues/681)|
|
||||
|\rparen|$\rparen$||
|
||||
|\rq|$\rq$||
|
||||
|\Rrightarrow|$\Rrightarrow$||
|
||||
@@ -892,7 +892,7 @@ table td {
|
||||
|\searrow|$\searrow$||
|
||||
|\sec|$\sec$||
|
||||
|\sect|$\text{\sect}$|`\text{\sect}`|
|
||||
|\setlength|<span style="color:firebrick;">Not supported</span>|[Issue #687](https://github.com/Khan/KaTeX/issues/687)|
|
||||
|\setlength|<span style="color:firebrick;">Not supported</span>|[Issue #687](https://github.com/KaTeX/KaTeX/issues/687)|
|
||||
|\setminus|$\setminus$||
|
||||
|\sf|$\sf AaBb123$|`\sf AaBb123`|
|
||||
|\sharp|$\sharp$||
|
||||
@@ -926,7 +926,7 @@ table td {
|
||||
|\spades|$\spades$||
|
||||
|\spadesuit|$\spadesuit$||
|
||||
|\sphericalangle|$\sphericalangle$||
|
||||
|{split}|<span style="color:firebrick;">Not supported</span>|[Issue #1345](https://github.com/Khan/KaTeX/issues/1345)|
|
||||
|{split}|<span style="color:firebrick;">Not supported</span>|[Issue #1345](https://github.com/KaTeX/KaTeX/issues/1345)|
|
||||
|\sqcap|$\sqcap$||
|
||||
|\sqcup|$\sqcup$||
|
||||
|\square|$\square$||
|
||||
@@ -1010,7 +1010,7 @@ table td {
|
||||
|\textquoteright|$\text{\textquoteright}$|`\text{\textquoteright}`|
|
||||
|\textregistered|$\text{\textregistered}$|`\text{\textregistered}`|
|
||||
|\textrm|$\textrm{AaBb123}$|`\textrm{AaBb123}`|
|
||||
|\textsc|<span style="color:firebrick;">Not supported</span>|[Issue #471](https://github.com/Khan/KaTeX/issues/471)|
|
||||
|\textsc|<span style="color:firebrick;">Not supported</span>|[Issue #471](https://github.com/KaTeX/KaTeX/issues/471)|
|
||||
|\textsf|$\textsf{AaBb123}$|`\textsf{AaBb123}`|
|
||||
|\textsterling|$\text{\textsterling}$|`\text{\textsterling}`|
|
||||
|\textstyle|$\textstyle\sum_0^n$|`\textstyle\sum_0^n`|
|
||||
@@ -1138,7 +1138,7 @@ table td {
|
||||
|\vert|$\vert$||
|
||||
|\vfil|<span style="color:firebrick;">Not supported</span>||
|
||||
|\vfill|<span style="color:firebrick;">Not supported</span>||
|
||||
|\vline|<span style="color:firebrick;">Not supported</span>|[Issue #269](https://github.com/Khan/KaTeX/issues/269)|
|
||||
|\vline|<span style="color:firebrick;">Not supported</span>|[Issue #269](https://github.com/KaTeX/KaTeX/issues/269)|
|
||||
|{Vmatrix}|$\begin{Vmatrix}a&b\\c&d\end{Vmatrix}$|`\begin{Vmatrix}`<br> `a & b \\`<br> `c & d`<br>`\end{Vmatrix}`|
|
||||
|{vmatrix}|$\begin{vmatrix}a&b\\c&d\end{vmatrix}$|`\begin{vmatrix}`<br> `a & b \\`<br> `c & d`<br>`\end{vmatrix}`|
|
||||
|\vphantom|$\overline{\vphantom{M}a}$|`\overline{\vphantom{M}a}`|
|
||||
@@ -1152,7 +1152,7 @@ table td {
|
||||
|\weierp|$\weierp$||
|
||||
|\widecheck|$\widecheck{AB}$|`\widecheck{AB}`|
|
||||
|\widehat|$\widehat{AB}$|`\widehat{AB}`|
|
||||
|\wideparen|<span style="color:firebrick;">Not supported</span>|[Issue #560](https://github.com/Khan/KaTeX/issues/560)|
|
||||
|\wideparen|<span style="color:firebrick;">Not supported</span>|[Issue #560](https://github.com/KaTeX/KaTeX/issues/560)|
|
||||
|\widetilde|$\widetilde{AB}$|`\widetilde{AB}`|
|
||||
|\wp|$\wp$||
|
||||
|\wr|$\wr$||
|
||||
|
Reference in New Issue
Block a user