1.8 KiB
1.8 KiB
author, title, date, description, math
author | title | date | description | math |
---|---|---|---|---|
Hugo Authors | Math Typesetting | 2019-03-08 | A brief guide to setup KaTeX | 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
totrue
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
{{< math.inline >}} {{ if or .Page.Params.math .Site.Params.math }}
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.11.1/dist/katex.min.js" integrity="sha384-y23I5Q6l+B6vatafAwxRu/0oK/79VlbSz7Q9aiSZUvyWYIYsd+qj+o24G5ZU2zJz" crossorigin="anonymous"></script> <script defer src="https://cdn.jsdelivr.net/npm/katex@0.11.1/dist/contrib/auto-render.min.js" integrity="sha384-kWPLUVMOks5AQFrykwIup5lo0m3iMkkHrD0uJ4H5cjeGihAutqP0yW0J6dpFiVkI" crossorigin="anonymous" onload="renderMathInElement(document.body);"></script> {{ end }} {{}}Examples
{{< math.inline >}}
Inline math: \(\varphi = \dfrac{1+\sqrt5}{2}= 1.6180339887…\)
{{}}Block math:
\varphi = 1+\frac{1} {1+\frac{1} {1+\frac{1} {1+\cdots} } }