johnstonfi/content/content/math-typesetting.md

+++ authors = ["author-demo"] categories = ["content", "paige"] description = "A brief guide to setup KaTeX." tags = ["katex", "math", "typesetting"] title = "Math Typesetting" [paige] enable_math = true +++

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

In this example we will be using KaTeX

• Create a partial under /layouts/partials/math.html
• Within this partial reference the Auto-render Extension or host these scripts locally.

• Include the partial in your templates like so:

  {{ if or .Params.math .Site.Params.math }}
  {{ partial "math.html" . }}
  {{ end }}
  

• To enable KaTeX globally set the parameter math to true in a project's configuration

• To enable KaTeX on a per page basis include the parameter math: true in content files

Note: Use the online reference of Supported TeX Functions

Examples

Inline math: \(\varphi = \dfrac{1+\sqrt5}{2}= 1.6180339887…\)

Block math: $$ \varphi = 1+\frac{1} {1+\frac{1} {1+\frac{1} {1+\cdots} } } $$