katex

Overview ¶

Package katex provides a built-in plugin that ships KaTeX runtime assets and wires them into any page whose rendered HTML contains math markup.

The plugin copies the embedded vendor files (JS, CSS, fonts, init script) under dist/assets/vendor/katex/ during BuildDone, and appends the relevant <script>/<link> entries to RouteData.Scripts and RouteData.Styles during BeforeRender — gated on a per-page detection that scans for class="math". Config key `plugins.config.katex.always: true` forces the assets onto every page regardless of detection.

The `assets/` directory is expected to contain the KaTeX distribution (katex.min.js, katex.min.css, auto-render.min.js, init.js, fonts/*.woff2). Files are placeholders by default — replace them with the real KaTeX release before shipping.