Provides plugin to render formulae
MIT License
Provides a django CMS plugin to render formulae using KaTeX and its mhchem extension.
The plugin can display formulae either inline or in display mode. It is text-enabled, and you can add equations to rich text fields of djangocms-text-ckeditor.
The plugin form has a preview functionality that either shows the typed formula. Errors are shown in red.
For a manual install:
run pip install djangocms-katex
add the following entries to your INSTALLED_APPS
:
"djangocms_katex",
run python manage.py migrate
The Code plugin uses the ace code editor which is loaded from a CDN by default.
If you want the ace code editor to be served from static files, please use
djangocms-katex[static-ace]
instead of djangocms-katex
in your
requirements or with pip. Make the static files for the ace code editor available
to your project by adding djangocms_static_ace
to your project's
INSTALLED_APPS
.
djangocms-text-ckeditor's inline functionality might interfere with KaTeX's layout.
To ensure a great editing experience deactivate it if you use djangocms-katex by
removing TEXT_INLINE_EDITING = True
from your settings.py
file.
Once installed, a new puling ("KaTeX formula") is available and can be entered into any placeholder or within a text plugin.
djangocms-katex only loads required LaTeX JavaScript libraries on demand only. This might lead to formulae initially only shown in source code. To see the rendered formula in such a case, please reload the page which ensures that all required JavaScript is loaded.