Mathématique dans Hugo

Attention cette article date depuis plus d'un an (377 jours).

Table des matières

Dans la version v0.122.0, on peut facilement ajouter le support des formules mathématiques façon LaTex. Ce tutoriel est juste une retranscription de cette page.

$$E=mc^2$$

Installation:

Modification du ficher de configuration du blog.

config.toml

[markup]
  [markup.goldmark]
    [markup.goldmark.extensions]
      [markup.goldmark.extensions.passthrough]
        enable = true
        [markup.goldmark.extensions.passthrough.delimiters]
          block = [['\[', '\]'], ['$$', '$$']]
          inline = [['\(', '\)']]
[params]
  math = true

On peut aussi ajouter le parametre dans l’entête d’un article

params:
  math: true

Ajout d’une page partial

layouts/partials/math.html

<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js"></script>
<script>
  MathJax = {
    tex: {
      displayMath: [['\\[', '\\]'], ['$$', '$$']],  // block
      inlineMath: [['\\(', '\\)']]                  // inline
    }
  };
</script>

On active le partial si math est activé dans config.

layouts/_default/baseof.html

...
  {{ if .Param "math" }}
    {{ partialCached "math.html" . }}
  {{ end }}
...

Utilisation simple

$$ a^*=x-b^* $$

$$ a^*=x-b^* $$

$$ \frac{1}{2}$, $\left(-\frac{1}{2}\right)^n $$

$$ \frac{1}{2}\left(-\frac{1}{2}\right)^n $$

Utilisation complexe

$$\begin{align}
{V} & = \int_{-r}^{r} \pi(r^2-h^2) \mathrm{d}h \\[2ex]
& = \left[ \pi(hr^2-\tfrac{1}{3}h^3) \right]_{-r}^{r} \\[2ex]
& = \pi \left(r^3-\tfrac{1}{3}r^3 \right) - \pi \left(-r^3-\tfrac{1}{3}r^3 \right) \\[2ex]
& = \tfrac{2}{3} \pi r^3 + \tfrac{2}{3} \pi r^3 \\[2ex]
{V} & = \tfrac{4}{3} \pi r^3
\end{align}$$

$$\begin{align} {V} & = \int_{-r}^{r} \pi(r^2-h^2) \mathrm{d}h \\[2ex] & = \left[ \pi(hr^2-\tfrac{1}{3}h^3) \right]_{-r}^{r} \\[2ex] & = \pi \left(r^3-\tfrac{1}{3}r^3 \right) - \pi \left(-r^3-\tfrac{1}{3}r^3 \right) \\[2ex] & = \tfrac{2}{3} \pi r^3 + \tfrac{2}{3} \pi r^3 \\[2ex] {V} & = \tfrac{4}{3} \pi r^3 \end{align}$$