Math notation does not work on exampleSite about hugo-clarity

[chipzoller]

I think this should be an enhancement, yes, and I also like the idea of activating it globally with per-page overrides like we have done with other parameters. Although our theme wasn't specifically designed to cater to math notation, it is somewhat of a relative of programming and other code. It seems like there should be similar facility to enable (and optimize for) its use.

[onweru]

@jpboignard, thanks for raising this. I have attached screenshots of the diagnosis, an explanation from the docs why this is happening and a solution.

---

Diagnosis

---

Docs

See this section from the docs

---

Solution

To remedy this, you can simply change this line in your config.toml to:

unsafe = true # change to false to disable inclusion of raw HTML and math functions

@chipzoller, I will need your help documenting this

[jpboignard]

It does not work for me.
In the exampleSite, in safe or unsafe mode, the bottom of the page http://localhost:1313/post/math-typesetting/ only display this:

[onweru]

@jpboignard, if you don’t mind, I would like to see your code. Perhaps the config.toml & the math block you’re trying to publish

[onweru]

As it turns out, the answer to this issue is, in fact, right under our nose. The first sentence of that posts states 👇

Mathematical notation in a Hugo project can be enabled by using third party JavaScript libraries.

In fact, the entire post documents how you activate math notation on a Hugo website.

When you look at the scripts loaded from the aforementioned link, you will notice katex.min.js is among them (see the attached screenshot). This means, the Hugo themes site, a Hugo site, has implemented what is documented within the aforementioned post.

Since this issue is already well documented (again, by the aforementioned post) I think we will document this only as an addendum.

No further changes will be required on this theme's config.

@chipzoller, do you think we should treat this as a feature request? Maybe, go a little further and conditionally load the katex third party JavaScript libraries ? The condition would be as follows:

Sitewide via config.toml file

...
[params]
...
enableMathNotation=false # change to true to activate math notation
...

It would be overridable from a page frontmatter

...
[params]
...
enableMathNotation=true # I want to activate math notation on this page even if it's off site-wide
...

[chipzoller]

@onweru I'm circling back on this as my task to update the README. Please confirm that the functionality is present and all that's needed from a docs standpoint is to write about the enableMathNotation in the config.toml file, overridable at the post level.