linjer / jekyll-katex Goto Github PK

[DEPRECATED] Jekyll plugin for easy server-side math rendering via KaTeX

License: MIT License

Ruby 100.00%

katex jekyll jekyll-katex latex github-pages jekyll-plugin

jekyll-katex's Introduction

jekyll-katex

This is a Jekyll plugin for performing compile-time math rendering via the KaTeX library. KaTeX is a library for rending math on the web using LaTeX, similar to MathJax.

KaTeX differs from MathJax in that it displays faster rendering speed and renders to pure HTML rather than PNGs. There are various resources in benchmarking and comparing their performance, for more info, start here.

Comes packaged with KaTeX 0.11.1 but you can specify a different version in your Jekyll _config.yml (see below).

Installation

In your Jekyll project, add the plugin to your _config.yml, e.g.:
```
plugins:
  - jekyll-katex
```
Add jekyll-katex to your gems.rb/Gemfile plugin block:
```
group :jekyll_plugins do
  gem 'jekyll-katex'
end
```
Once done, execute bundle install.
Add KaTeX CSS and Fonts. Follow the installation instructions on the KaTeX README. You can skip including the .js file unless you want to do client-side in-browser rendering, as well.

Put the following (adjusting for your version) in your page headers:
```
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/katex.min.css" integrity="sha384-zB1R0rpPzHqg7Kpt0Aljp8JPLqbXI3bhnPWROx27a9N0Ll6ZP/+DiW/UqRcLbRjq" crossorigin="anonymous">
```

Configuration

Supported configuration values, shown with default values:

katex:
  js_path: "{{ Gem::lib_path }}/assets/js"  # Path used to search for katex.min.js
  rendering_options:
    # Default KaTeX rendering options. See https://github.com/Khan/KaTeX#rendering-options
    throw_error: true                       # throwOnError - set to false if you want rendering to output error as text rather than a build error
    error_color: "#cc0000"                  # errorColor

Usage

There are two liquid tags: katex and katexmm.

katex

Use the katex liquid tag for LaTeX math equations like so:

{% katex %}
c = \pm\sqrt{a^2 + b^2}
{% endkatex %}

If you want the equation to be rendered in display mode (on its own line, centered, large symbols), just pass in the display parameter:

{% katex display %}
c = \pm\sqrt{a^2 + b^2}
{% endkatex %}

katexmm

The katex liquid tag can be cumbersome, particularly if you have many inline blocks, which would need to be opened and closed repeatedly, cluttering the source text. katexmm is an alternative that supports fenced math mode blocks similar to standard latex:

{% katexmm %}
This is a mixed environment where you can have normal text and $c = \pm\sqrt{a^2 + b^2}$ fenced math. \$!
{% endkatexmm %}

$ for inline
$$ for display mode
\$ to escape $ anywhere within the katexmm environment

Development

$ bundle install
$ rake build

Contributing

Feel free to open issues and pull requests.

License

The gem is available as open source under the terms of the MIT License.

jekyll-katex's People

Contributors

Stargazers

Watchers

Forkers

mcilhargey ashmaroli dolabmoon dthul technicalguy codekansas hrjakobsen sinhp

jekyll-katex's Issues

Support for latex style math-mode fencing using $ (inline) and $$ (display mode)

Liquid syntax error: Unknown tag 'katex'

I have followed your instructions:

Add the plugin to _config.yml, e.g.:
```
plugins:
  - jekyll-katex
```

Add jekyll-katex to your Gemfile plugin block:

group :jekyll_plugins do
  gem 'jekyll-katex'
end

Add KaTeX CSS and Fonts. Put the following in my page headers:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/katex.min.css" integrity="sha384-dbVIfZGuN1Yq7/1Ocstc1lUEm+AT+/rCkibIcC/OmWo5f0EA48Vf8CytHzGrSwbQ" crossorigin="anonymous">

but when I use bundle exec jekyll build the following error appears:
Liquid Exception: Liquid syntax error (line 23): Unknown tag 'katex' in <FILE_PATH>
I am a freshman in front-end field, so could you help me with this problem? Thank you in advance!

Document changes and features against version

Originally motivated by user report #7 .

It was unclear what version was required to use the katexmm tag. Some longer term solutions may include release notes.

How to use this plugin and deploy the site to Github in User / Organization mode

Thank you for sharing with this plugin, but as I deployed this site to Github, it told me Liquid syntax error: Unknown tag 'katex. I have checked this issue and found out that the official whitelist excludes the third-party plugins for the sake of safety, just like jekyll-katex.

There is a workaround to deal with this problem is that change the name of the repo to others except for <username>.github.io, accordingly changing the site from User organization mode to project mode. However, I want to make Github build this code for me, and save the permalink <username>.github.io instead of <username>.github.io/<repo-name>.

In summary, I wonder if there is any way I can use your plugins as well as stay in User/Organization mode?

Incorrect path output for KaTeX js

Currently the log output shows:

Katex Configuration: Found KaTeX js at: ~/lib/assets/js//katex.min.js

Notice the double slash // between the :js_path and the :js_filename values

This plugin is not necessary

According to this blog post kramdown can easily support Katex without this plugin. See the section "Method 2".

Also see this post: https://gendignoux.com/blog/2020/05/23/katex.html

Javascript engine missing!

Hi, first of all thanks for this plugin and please add support for Jekyll 4.0 :)

and now the actual issue:
I'm building Jekyll in a gitlab ci-cd for 1 project that has two branches: master and development
they have same katex config but in master I get this error

 $ bundle info jekyll-katex
  * jekyll-katex (0.4.3)
	Summary: Jekyll plugin for easy KaTeX math server-side rendering.
	Homepage: https://github.com/linjer/jekyll-katex
	Path: /usr/local/rvm/gems/ruby-2.6.3/gems/jekyll-katex-0.4.3
$ bundle exec jekyll build -d public
Configuration file: /builds/Azadeh-Afzar/Web-Development/Kianic-Jekyll-Theme/_config.yml
Configuration file: /builds/Azadeh-Afzar/Web-Development/Kianic-Jekyll-Theme/_config.yml
jekyll 3.8.6 | Error:  Could not find a JavaScript runtime. See https://github.com/rails/execjs for a list of available runtimes.

while on development branch everything runs just fine:

$ bundle info jekyll-katex
  * jekyll-katex (0.4.3)
	Summary: Jekyll plugin for easy KaTeX math server-side rendering.
	Homepage: https://github.com/linjer/jekyll-katex
	Path: /usr/local/rvm/gems/ruby-2.6.3/gems/jekyll-katex-0.4.3

$ bundle exec jekyll build -d development
Configuration file: /builds/Azadeh-Afzar/Web-Development/Kianic-Jekyll-Theme/_config.yml
Configuration file: /builds/Azadeh-Afzar/Web-Development/Kianic-Jekyll-Theme/_config.yml
Katex Configuration: Found KaTeX js at: /usr/local/rvm/gems/ruby-2.6.3/gems/jekyll-katex-0.4.3/lib/assets/js/katex.min.js
            Source: /builds/Azadeh-Afzar/Web-Development/Kianic-Jekyll-Theme
       Destination: development
 Incremental build: disabled. Enable with --incremental
      Generating... 
       Jekyll Feed: Generating feed for posts
                    done in 5.36 seconds.
 Auto-regeneration: disabled. Use --watch to enable.

can you look at this? i'm really confused and used many ways to solve it but still failed.

thank you

SyntaxError on load

I'm new to Jekyll, so maybe I'm doing something wrong.
Anyway, I've followed steps 1 and 2 from the readme, and bundle install goes well (I'm running ruby 2.5.1p57 on a x64 Win 10 machine, with Jekyll 3.8.4).
But then, when I try to run with bundle exec jekyll serve, I get this:

Configuration file: C:/Users/franc/Documents/GitHub/Einlar.github.io/_config.yml
Katex Configuration: Found KaTeX js at: C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/jekyll-katex-0.3.0/lib/assets/js//katex.min.js
Traceback (most recent call last):
10: from C:/Ruby25-x64/bin/jekyll:23:in `<main>'
9: from C:/Ruby25-x64/bin/jekyll:23:in `load'
8: from C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/jekyll-3.8.4/exe/jekyll:11:in `<top (required)>'
7: from C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/jekyll-3.8.4/lib/jekyll/plugin_manager.rb:51:in `require_from_bundler'
6: from C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler.rb:114:in `require'
5: from C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler/runtime.rb:65:in `require'
4: from C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler/runtime.rb:65:in `each'
3: from C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler/runtime.rb:76:in `block in require'
2: from C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler/runtime.rb:76:in `each'
1: from C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler/runtime.rb:80:in `block (2 levels) in require'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler/runtime.rb:84:in `rescue in block (2 levels) in require': There was an error while trying to load the gem 'jekyll-katex'. (Bundler::GemRequireError)
Gem Load Error is: SyntaxError: Previsto identificatore
Backtrace for gem load error is:
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/execjs-2.7.0/lib/execjs/external_runtime.rb:39:in `exec'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/execjs-2.7.0/lib/execjs/external_runtime.rb:14:in `initialize'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/execjs-2.7.0/lib/execjs/runtime.rb:57:in `new'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/execjs-2.7.0/lib/execjs/runtime.rb:57:in `compile'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/execjs-2.7.0/lib/execjs/module.rb:27:in `compile'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/jekyll-katex-0.3.0/lib/jekyll-katex/katex_js.rb:10:in `<module:Katex>'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/jekyll-katex-0.3.0/lib/jekyll-katex/katex_js.rb:9:in `<module:Jekyll>'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/jekyll-katex-0.3.0/lib/jekyll-katex/katex_js.rb:7:in `<top (required)>'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/jekyll-katex-0.3.0/lib/jekyll/tags/katex.rb:4:in `require'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/jekyll-katex-0.3.0/lib/jekyll/tags/katex.rb:4:in `<top (required)>'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/jekyll-katex-0.3.0/lib/jekyll-katex.rb:4:in `require'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/jekyll-katex-0.3.0/lib/jekyll-katex.rb:4:in `<top (required)>'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler/runtime.rb:81:in `require'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler/runtime.rb:81:in `block (2 levels) in require'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler/runtime.rb:76:in `each'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler/runtime.rb:76:in `block in require'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler/runtime.rb:65:in `each'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler/runtime.rb:65:in `require'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/bundler-1.16.5/lib/bundler.rb:114:in `require'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/jekyll-3.8.4/lib/jekyll/plugin_manager.rb:51:in `require_from_bundler'
C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/jekyll-3.8.4/exe/jekyll:11:in `<top (required)>'
C:/Ruby25-x64/bin/jekyll:23:in `load'
C:/Ruby25-x64/bin/jekyll:23:in `<main>'
Bundler Error Backtrace:

Adding CSS and fonts as of step 3 does not change the situation. Is this a bug of the plugin or am I doing something wrong?

Update to KaTeX 0.9.0?

Hi, thanks for this package! There's a new KaTeX release. Would be great if this package used that.

Extremely slow build speed.

As much as I'd like to use this plugin, as it performs much better than Mathjax, it's unbearably slow. What used to take 4-7 seconds to generate the feed for posts is now taking 40+ seconds:

Macro options?

Hi,

Thank you for this Jekyll plugin. It works really well so far. However, I tried adding macros to the configuration, like so:

katex:
  rendering_options:
    macros:
      - "\\Nat": "\\mathbb{N}"

I tried several variations with quotes and backslashes, but none of them works. Is it supported?

Issue when $ appears in code block

When I have code block (rendered by rouge) in my post.md e.g.

```bash
echo $ENV_VAR
````

and I want to render LaTeX as well using $$ tags in markdown and katexmm in layout:

{% katexmm %}
{{ content }}
{% endkatexmm %}

I end up with KaTeX exception Liquid Exception: ParseError: KaTeX parse error: Expected 'EOF', got … in /_layouts/post.html. MathJax simply ignores unmatched $ so it wasn't a problem before migration. Additionally, since rouge runs somewhere between putting templates together and running KaTeX, so neither escaping $ manually in all .md files, nor writing a custom filter that prepends all $ with \ help. This error happens on $ pairing, so throw_error: false cannot fix it.

It would be helpful to be able to ignore $ at least in certain contexts, like e.g. code tag.

Problems with katexmm

Hey there,

I'm trying to use this plugin to integrate katex in my personal page.
The {$ katexmm $} looked quite appealing such that I can write latex-style math-mode triggers in markdown files.

However, bundle exec jekyll serve yields

  Liquid Exception: Liquid syntax error (line 8): Unknown tag 'katexmm' in /_layouts/post.html

as soon as I put {% katexmm %} ... {$ endkatexmm $} into some html file.

The other {% katex display %} and {% katex %} environments work perfectly fine.

Context: I added the jekyll-katex plugin via Gemfile and bundle install. I included the katex css in the headers.

Did I miss anything?

Jekyll 4 support

Jekyll 4 is released recently and jekyll-katex depends on Jekyll 3.0 thus won't work with the latest version.

Migrate to standalone JS engine

See #6 .

There is potential for a JS engine to not be found, giving a user a cryptic error.

Require lower ruby version than 2.5.1

Originally motivated by user report #7 .

At version 0.3.0, ruby-2.5.1 was required but most default installs will be earlier.

The tag katex is not a recognized Liquid tag.

I am creating a basic Jekyll blog. It works flawlessly on local, however on pushing to gh-pages I get the error in the title. Does gh-pages not support this?

There can't be > in katexmm

There's one line in my blog:

$a > b$

Then I run:

$ jekyll b

Liquid Exception: ParseError: KaTeX parse error: Expected 'EOF', got '&' at position 4: a &̲gt; b in /_layouts/post.html

But if it's
$$
a > b
$$
Ok then.

Katexmm display mode does not work

I followed the instructions in the README

Gemfile looks like this

group :jekyll_plugins do
  gem "github-pages"
  gem "jekyll-feed", "~> 0.6"
  gem "jekyll-katex", "~> 1.0.0"
end

I ran bundle install

Using github-pages 200
Using jekyll-katex 1.0.0 (was 0.1.2)

I added the CSS file in my header.
Added {% katexmm %} {{content}} {% endkatexmm %} in my default.html.
Inline mode $ with renders great, but display mode with $$ gives me blank.

Any idea what may be up?

Bug in configuration

I believe this bug was first reported in issue #3, fixed by PR #4 and recently reintroduced again by PR #15.

I do not specify any katex configuration options in my _config.yml file, so jekyll-katex/configuration.rb will set JEKYLL_CONFIG to {}. But then it tries to do a double indexing:

JEKYLL_CONFIG['rendering_options']['throw_error']

The first indexing operation will return nil, so the second indexing operation will throw the following error:

vendor/bundle/ruby/2.5.0/gems/jekyll-katex-0.3.1/lib/jekyll-katex/configuration.rb:34:in `global_rendering_options': undefined method `[]' for nil:NilClass (NoMethodError)

Maybe that code could be expressed more robustly by Ruby's Hash#merge operation? I might try and create a PR for this later.

Error loading plugin when katex configuration options are not specified in _config.yml

Probably I'm simply too dumb to follow your guide. These are the steps that I did so far:

Added the plugin in my _config.yml. This is what I have now:
```
plugins:
  - jekyll-feed
  - jekyll-katex
```

Added the plugin in my Gemfile plugin block. This is what I have:

group :jekyll_plugins do
  gem "jekyll-feed", "~> 0.6"
  gem 'jekyll-katex', "~> 0.2"
end

I run bundle install

I run bundle exec jekyll serve and had a long error output:

bundler: failed to load command: jekyll (/usr/local/bin/jekyll)
Bundler::GemRequireError: There was an error while trying to load the gem 'jekyll-katex'.
Gem Load Error is: undefined method `[]' for nil:NilClass
Backtrace for gem load error is:
/var/lib/gems/2.5.0/gems/jekyll-katex-0.2.0/lib/jekyll-katex/configuration.rb:22:in `js_path'
/var/lib/gems/2.5.0/gems/jekyll-katex-0.2.0/lib/jekyll/tags/katex.rb:14:in `<class:Katex>'
/var/lib/gems/2.5.0/gems/jekyll-katex-0.2.0/lib/jekyll/tags/katex.rb:12:in `<module:Tags>'
/var/lib/gems/2.5.0/gems/jekyll-katex-0.2.0/lib/jekyll/tags/katex.rb:7:in `<module:Jekyll>'
/var/lib/gems/2.5.0/gems/jekyll-katex-0.2.0/lib/jekyll/tags/katex.rb:6:in `<top (required)>'
/var/lib/gems/2.5.0/gems/jekyll-katex-0.2.0/lib/jekyll-katex.rb:7:in `require'
/var/lib/gems/2.5.0/gems/jekyll-katex-0.2.0/lib/jekyll-katex.rb:7:in `<top (required)>'
/usr/local/lib/site_ruby/2.5.0/bundler/runtime.rb:81:in `require'
/usr/local/lib/site_ruby/2.5.0/bundler/runtime.rb:81:in `block (2 levels) in require'
/usr/local/lib/site_ruby/2.5.0/bundler/runtime.rb:76:in `each'
/usr/local/lib/site_ruby/2.5.0/bundler/runtime.rb:76:in `block in require'
/usr/local/lib/site_ruby/2.5.0/bundler/runtime.rb:65:in `each'
/usr/local/lib/site_ruby/2.5.0/bundler/runtime.rb:65:in `require'
/usr/local/lib/site_ruby/2.5.0/bundler.rb:114:in `require'
/var/lib/gems/2.5.0/gems/jekyll-3.8.3/lib/jekyll/plugin_manager.rb:51:in `require_from_bundler'
/var/lib/gems/2.5.0/gems/jekyll-3.8.3/exe/jekyll:11:in `<top (required)>'
/usr/local/bin/jekyll:23:in `load'
/usr/local/bin/jekyll:23:in `<top (required)>'
/usr/local/lib/site_ruby/2.5.0/bundler/cli/exec.rb:74:in `load'
/usr/local/lib/site_ruby/2.5.0/bundler/cli/exec.rb:74:in `kernel_load'
/usr/local/lib/site_ruby/2.5.0/bundler/cli/exec.rb:28:in `run'
/usr/local/lib/site_ruby/2.5.0/bundler/cli.rb:424:in `exec'
/usr/local/lib/site_ruby/2.5.0/bundler/vendor/thor/lib/thor/command.rb:27:in `run'
/usr/local/lib/site_ruby/2.5.0/bundler/vendor/thor/lib/thor/invocation.rb:126:in `invoke_command'
/usr/local/lib/site_ruby/2.5.0/bundler/vendor/thor/lib/thor.rb:387:in `dispatch'
/usr/local/lib/site_ruby/2.5.0/bundler/cli.rb:27:in `dispatch'
/usr/local/lib/site_ruby/2.5.0/bundler/vendor/thor/lib/thor/base.rb:466:in `start'
/usr/local/lib/site_ruby/2.5.0/bundler/cli.rb:18:in `start'
/usr/lib/ruby/gems/2.5.0/gems/bundler-1.16.2/exe/bundle:30:in `block in <top (required)>'
/usr/local/lib/site_ruby/2.5.0/bundler/friendly_errors.rb:124:in `with_friendly_errors'
/usr/lib/ruby/gems/2.5.0/gems/bundler-1.16.2/exe/bundle:22:in `<top (required)>'
/usr/local/bin/bundle:23:in `load'
/usr/local/bin/bundle:23:in `<main>'
Bundler Error Backtrace:

  /usr/local/lib/site_ruby/2.5.0/bundler/runtime.rb:84:in `rescue in block (2 levels) in require'
  /usr/local/lib/site_ruby/2.5.0/bundler/runtime.rb:80:in `block (2 levels) in require'
  /usr/local/lib/site_ruby/2.5.0/bundler/runtime.rb:76:in `each'
  /usr/local/lib/site_ruby/2.5.0/bundler/runtime.rb:76:in `block in require'
  /usr/local/lib/site_ruby/2.5.0/bundler/runtime.rb:65:in `each'
  /usr/local/lib/site_ruby/2.5.0/bundler/runtime.rb:65:in `require'
  /usr/local/lib/site_ruby/2.5.0/bundler.rb:114:in `require'
  /var/lib/gems/2.5.0/gems/jekyll-3.8.3/lib/jekyll/plugin_manager.rb:51:in `require_from_bundler'
  /var/lib/gems/2.5.0/gems/jekyll-3.8.3/exe/jekyll:11:in `<top (required)>'
  /usr/local/bin/jekyll:23:in `load'
  /usr/local/bin/jekyll:23:in `<top (required)>'

Note that if I didn't step 2, then the error is the same. If instead I didn't step 3, then the error is:

Dependency Error: Yikes! It looks like you don't have jekyll-katex or one of its dependencies installed. In order to use Jekyll as currently configured, you'll need to install this gem. The full error message from Ruby is: 'cannot load such file -- jekyll-katex' If you run into trouble, you can find helpful resources at https://jekyllrb.com/help/! 
jekyll 3.8.3 | Error:  jekyll-katex

Any help is appreciated.

Does not correctly render after being uploaded

Thanks for making this very useful plugin! I used it locally when writing a post and it rendered perfectly but after uploading the mathematics do not render correctly. I had a similar issue with MathJax so perhaps they are related? My website is being served by Netlify which is sitting behind Cloudflare.

Line breaker not support

KaTeX support line breakers \ and \newline.
But with jekyll-katex, \ rise a error, and \newline is not work too.

Inline matrix display

I tried to write an inline matrix like this:

Some text blah blah $\begin{bmatrix} a & b \\ c & d \end{bmatrix}$

However, the matrix was rendered to this:

[a   amp; b c  amp; d]

But the same code worked well for a block equation:

$$\begin{bmatrix} a & b \\ c & d \end{bmatrix}$$

Do anyone got any solutions?

Warning: Excerpt modified in _posts/2019-07-18-encrypting-secrets-in-memory.md!
  Found a Liquid block containing the excerpt separator "\n\n". 
  The block has been modified with the appropriate closing tag.
  Feel free to define a custom excerpt or excerpt_separator in the document's front matter if the generated excerpt is unsatisfactory.

I'm not sure what it's referring to as I have the correct {% katexmm %} and {% endkatexmm %} tags at the start and end of the page.