mirror of
https://github.com/Smaug123/KaTeX
synced 2025-10-07 12:18:39 +00:00
9917d1ce84
* Add support for \expandafter * Add support for \noexpand * Add support for \edef * Update comments * Allow \long before macro definition * Update documentation * Update comments * Fix defPrefix * Add support for \let * Update documentation * Print error token * Update documentation * Check whether command is expandable * Add tests * Fix token order * Make noexpand a Token property * Throw error if control sequence is undefined when expanding * Rename expandableOnly to expandOnly * Make unexpandable macro property * Move \expandafter to macros.js * Add TODO * Fix merge conflict * Update a test case * Remove unused functions in MacroContextInterface * Update comments * Refactor code * Move \noexpand to macros * Update MacroExpander.js * Add a test case * Separate control sequence check to a function * Add support for \futurelet * Separate RHS getter to a function * Update documentation * Move expandOnly logic to expandOnce * Refactor code and update comments Co-authored-by: Kevin Barabash <kevinb@khanacademy.org>
52 lines
2.5 KiB
Markdown
52 lines
2.5 KiB
Markdown
---
|
||
id: issues
|
||
title: Common Issues
|
||
---
|
||
- Be sure to include `<!DOCTYPE html>` at the top of your HTML file, as
|
||
otherwise your browser will render in "[quirks mode](https://developer.mozilla.org/en-US/docs/Web/HTML/Quirks_Mode_and_Standards_Mode)"
|
||
which can cause KaTeX to sometimes render incorrectly.
|
||
This header is needed even inside `<iframe>`s
|
||
(which don't inherit the parent document's doctype).
|
||
- Many Markdown preprocessors, such as the one that Jekyll and GitHub Pages use,
|
||
have a "smart quotes" feature. This changes `'` to `’` which is an issue for
|
||
math containing primes, e.g. `f'`. This can be worked around by defining a
|
||
single character macro which changes them back, e.g. `{"’", "'"}`.
|
||
- KaTeX follows LaTeX's rendering of `aligned` and `matrix` environments unlike
|
||
MathJax. When displaying fractions one above another in these vertical
|
||
layouts there may not be enough space between rows for people who are used to
|
||
MathJax's rendering. The distance between rows can be adjusted by using
|
||
`\\[0.1em]` instead of the standard line separator distance.
|
||
- KaTeX does not support the `align` environment because LaTeX doesn't support
|
||
`align` in math mode. The `aligned` environment offers the same functionality
|
||
but in math mode, so use that instead.
|
||
- MathJax defines `\color` to be like `\textcolor` by default; set KaTeX's
|
||
`colorIsTextColor` option to `true` for this behavior. KaTeX's default
|
||
behavior matches MathJax with its `color.js` extension enabled.
|
||
- Equivalents of MathJax `\class`, `\cssId`, and `\style` are `\htmlClass`,
|
||
`\htmlId`, and `\htmlStyle`, respectively, to avoid ambiguity.
|
||
- Some symbols are defined using macro instead of `\DeclareMathSymbol` or similar
|
||
as in LaTeX. This may cause different behavior in expansion. They may expand
|
||
into multiple tokens and be affected by `\expandafter` and `\noexpand`.
|
||
|
||
## Troubleshooting
|
||
|
||
To check the stylesheet (katex.css) is properly loaded, add following code to
|
||
anywhere in the document:
|
||
|
||
```html
|
||
<style>
|
||
.katex-version {display: none;}
|
||
.katex-version::after {content:"0.10.2 or earlier";}
|
||
</style>
|
||
<span class="katex">
|
||
<span class="katex-mathml">The KaTeX stylesheet is not loaded!</span>
|
||
<span class="katex-version rule">KaTeX stylesheet version: </span>
|
||
</span>
|
||
```
|
||
|
||
If it is loaded properly, it'll show its version. Make sure its version matches
|
||
the version of the JavaScript file (katex.js), which is defined in `katex.version`.
|
||
If it is not loaded properly, it'll show:
|
||
|
||
> The KaTeX stylesheet is not loaded!
|