Featured image of post Comment intégrer KaTeX dans Hugo et afficher de belles formules mathématiques de style LaTeX

Comment intégrer KaTeX dans Hugo et afficher de belles formules mathématiques de style LaTeX

Nous expliquons la procédure pour intégrer « KaTeX », une bibliothèque de rendu de formules mathématiques rapide, dans le générateur de site statique Hugo. De la création de math.html à la configuration de son chargement dans l'en-tête, vous découvrirez facilement comment activer l'affichage de belles formules mathématiques de style LaTeX sur votre blog.

Qu’est-ce que KaTeX

KaTeX est une bibliothèque javascript permettant d’afficher des formules mathématiques de style LaTeX en HTML.

Plus précisément, vous pouvez afficher des formules comme ci-dessous.

$$f(x) = x^2 + x + 41$$

Il semble y avoir d’autres bibliothèques d’affichage de formules de style LaTeX, mais KaTeX est réputé pour être simple et rapide.

Comment l’intégrer à hugo

  1. Créez un nouveau layouts/partials/math.html dans la hiérarchie des dossiers de hugo.

Le contenu doit être le suivant.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.4/dist/katex.min.css" integrity="sha384-vKruj+a13U8yHIkAyGgK1J3ArTLzrFGBbBc0tDp4ad/EyewESeXE/Iv67Aj8gKZ0" crossorigin="anonymous">
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.4/dist/katex.min.js" integrity="sha384-PwRUT/YqbnEjkZO0zZxNqcxACrXe+j766U2amXcgMg5457rve2Y7I6ZJSm2A0mS4" crossorigin="anonymous"></script>
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.4/dist/contrib/auto-render.min.js" integrity="sha384-+VBxd3r6XgURycqtZ117nYw44OOcIax56Z4dCRWbxyPt0Koah1uHoK0o4+/RRE05" crossorigin="anonymous"></script>
<script>
document.addEventListener("DOMContentLoaded", function() {
  renderMathInElement(
    document.body,
    {
      delimiters: [
        {left: "$$", right: "$$", display: true},
        {left: "\\[", right: "\\]", display: true},
        {left: "$", right: "$", display: false},
        {left: "\\(", right: "\\)", display: false}
      ]
    });
  });
</script>
  1. Ensuite, ajoutez le code ci-dessous au fichier existant layouts/partials/extend_head.html.
1
2
3
{{ if or .Params.math .Site.Params.math }}
{{ partial "math.html" . }}
{{ end }}
  1. Vous êtes maintenant prêt à utiliser KaTeX.

Vous pouvez activer KaTeX en ajoutant math: true au front matter de la page.

  1. Il ne vous reste plus qu’à écrire la formule dans le style LaTeX dans le corps de l’article de la page.
1
$$ e^{i \pi} = -1 $$

En l’écrivant comme ci-dessus, il s’affichera comme ci-dessous.

$$ e^{i \pi} = -1 $$

Référence

comments powered by Disqus
Généré avec Hugo
Thème Stack conçu par Jimmy