Files
hugo-themes-dev-env/content/post/math-typesetting.md
2023-08-13 11:01:02 +02:00

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 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

{{< 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} } }