MathRen for Flarum
An extension that handles TeX math rendering for your Flarum forum.
Click to view settings screenshot
Features
- Based on KaTeX (the fastest math typesetting library on the web).
- Display expressions as an inline or a block element.
- Compatible with Markdown and BBCode.
- Copy any expression’s source code to the clipboard.
- Integration with
flarum/mentionsextension so you can quote expressions with selection. - Works on preview mode.
Installation
composer require starsrivers/flarum-mathren
Updating
composer update starsrivers/flarum-mathren
php flarum cache:clear
Usage
Enable the extension.
Block Expressions
Wrap your TeX code with [math] and [/math] or your custom delimiters.
[math]\int_{-\infty}^\infty\hat\xi\,e^{2\pi i\xi x}\,d\xi[/math]
Block expressions will be wrapped with .mathren-block class.
Inline Expressions
Wrap your TeX code with [imath] and [/imath] or your custom delimiters.
Lorem ipsum dolor [imath]\varDelta = b^2-4ac[/imath] sit amet.
Inline expressions will be wrapped with .mathren-inline class.
Ignoring Expressions
If you’re willing to show the TeX code with delimiters, there are three options:
- Wrap your expression with `backticks` or
codetag.- You must set it as an ignored tag from the settings page.
- Wrap your expression with an ignored class.
- You can set ignored classes from the settings page.
- Use a decisive keyword with your expressions.
- The keyword is
ignoreby default. But you can change it or assign multiple keywords from the settings page. You must write one of those keywords inside a BBCode (i.e.[math=keyword]x^3[/math]).
- The keyword is
.mathren-ignore class will be added into ignored expression’s wrapper by default. But you can change it from the settings page.