wagtailmath 1.3.0

Description:

wagtailmath 1.3.0

wagtail-polymath




Links

Documentation
Changelog
Contributing
Discussions
Security

wagtail-polymath allows you to write equations in your
Wagtail content using markup and
render them beautifully.
wagtail-polymath provides a MathBlock so you can write equations in markup
(TeX, MathML, ASCIIMath) and render them with MathJax. It features a
live preview:

MathBlock uses MathJax for rendering so there is very little to do on
the front end. Simply include the MathJax JS and render the raw
MathBlock content as you would for any other streamfield plain text
block.
wagtail-polymath even includes a template tag to include the MathJax JS for
you from a CDN. By default, MathJax is configured to accept all
recognised markup (TeX, MathML, ASCIIMath) and renders them to HTML. To
change the configuration, you can pass the desired config command to the
templatetag. See the MathJax documentation
for possible configurations.
For help on using the markup languages see the relevant MathJax
documentation (e.g. https://docs.mathjax.org/en/v2.7-latest/tex.html) and
the markup language-specific documentation (e.g. https://en.wikibooks.org/wiki/LaTeX)
Quickstart
Install wagtailmath:
pip install wagtailmath

Add it to your INSTALLED_APPS:
# settings.py

INSTALLED_APPS = (
# ...
"wagtailmath",
# ...
)

Use MathBlock in your StreamField content:
from wagtailmath.blocks import MathBlock

class MyPage(Page):
body = StreamField([
('heading', blocks.CharBlock(classname="full title")),
('paragraph', blocks.RichTextBlock()),
('equation', MathBlock())
])

Use the mathjax template tag in your front end template to load the
MathJax library:
{% load wagtailmath %}
...

<script src="{% mathjax %}"></script>

Contributing
All contributions are welcome! See CONTRIBUTING.md
Supported versions:

Python 3.8, 3.9, 3.10, 3.11, 3.12
Django 4.2, 5.0
Wagtail 5.2 (LTS), 6.0, 6.1