hugo/docs/content/en/functions/transform/ToMath.md at 0c453420e6fceccf36d06cea0a9e53ac6b8401ba

blogs/hugo

Fork 0

mirror of https://github.com/gohugoio/hugo.git synced 2026-08-24 15:28:54 +00:00

Files

T

Bjørn Erik Pedersen 0c453420e6 Merge commit 'dec8cd4ada29218971743333f8ac662a9c06aad8'

2024-09-01 14:51:15 +02:00

3.3 KiB

Raw Blame History

title, description, categories, keywords, action, aliases, toc

title

description

Arguments

EXPRESSION: The math expression to render using KaTeX.
OPTIONS: A map of zero or more options.

Options

These are a subset of the KaTeX options.

output

(string). Determines the markup language of the output. One of html, mathml, or htmlAndMathml. Default is mathml.

With html and htmlAndMathml you must include KaTeX CSS within the head element of your base template. For example:

<head>
  ...
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.css" integrity="sha384-nB0miv6/jRmo5UMMR1wu3Gz6NLsoTkbqJghGIsx//Rlm+ZU03BU6SQNC66uf4l5+" crossorigin="anonymous">
  ...
</head>

displayMode

(bool) If true render in display mode, else render in inline mode. Default is false.

leqno

(bool) If true render with the equation numbers on the left. Default is false.

fleqn

(bool) If true render flush left with a 2em left margin. Default is false.

minRuleThickness

(float) The minimum thickness of the fraction lines in em. Default is 0.04.

macros

(map) A map of macros to be used in the math expression. Default is {}.

throwOnError

(bool) If true throw a ParseError when KaTeX encounters an unsupported command or invalid LaTex. See error handling. Default is true.

errorColor

(string) The color of the error messages expressed as an RGB hexadecimal color. Default is #cc0000.

Examples

Basic

{{ transform.ToMath "c = \\pm\\sqrt{a^2 + b^2}" }}

Macros

{{ $macros := dict 
    "\\addBar" "\\bar{#1}"
    "\\bold" "\\mathbf{#1}"
}}
{{ $opts := dict "macros" $macros }}
{{ transform.ToMath "\\addBar{y} + \\bold{H}" $opts }}

Error handling

There are 3 ways to handle errors from KaTeX:

Let KaTeX throw an error and make the build fail. This is the default behavior.
Handle the error in your template. See the render hook example below.
Set the throwOnError option to false to make KaTeX render the expression as an error instead of throwing an error. See [options].

{{< code file=layouts/_default/_markup/render-passthrough-inline.html copy=true >}} {{ with transform.ToMath .Inner }} {{ with .Err }} {{ errorf "Failed to render KaTeX: %q. See %s" . $.Position }} {{ else }} {{ . }} {{ end }} {{ end }} {{- /* chomp trailing newline */ -}} {{< /code >}}

3.3 KiB Raw Blame History