Notation mathématiques

Jake G May 05, 2021 Modifié: January 01, 2022 #Features #Shortcodes #Mathematics

Vous pouvez utiliser KaTeX pour rendre des notations mathématiques.

Vous pouvez activer le $\KaTeX$ prise en charge globale, par section ou par page.

Activer globalement

Pour activer le $\KaTeX$ prise en charge dans le monde entier, ajoutez math = true sous [extra] à la config.toml racine de votre site. Maintenant, le shortcode katex sera rendu, vous pouvez également ajouter math_auto_render = true et chaque section et page de votre site chargera l' extension KaTeX autorender.

[extra]
math = true
math_auto_render = false

Base par section

Pour activer le $\KaTeX$ support dans une section particulière, ajoutez math = true sous [extra] dans le fichier [SECTION_NAME]/_index.md. Maintenant, le shortcode katex sera rendu, vous pouvez également ajouter math_auto_render = true et la section de votre site chargera l' extension KaTeX autorender.

+++
[extra]
math = true
+++

Base par page

Pour activer le $\KaTeX$ support dans une page particulière, ajouter math = true sous [extra] dans le frontmatter de la page. Maintenant, le shortcode katex sera rendu, vous pouvez également ajouter math_auto_render = true et la page de votre site chargera l' extension KaTeX autorender.

+++
[extra]
math = true
math_auto_render = true
+++

C'est une bonne pratique de permettre $\KaTeX$ prise en charge par page, car cela ne chargera que les fichiers requis sur cette page particulière, sans affecter la vitesse de chargement des autres pages. Si votre site n'est pas lourd en mathématiques, veuillez ne PAS activer cette fonctionnalité globalement ou par section.

Usage

Enveloppez tout valide $\KaTeX$ syntaxe avec $...$ pour les mathématiques en ligne et $$...$$ pour les mathématiques par blocs.

Mathématiques en ligne

C'est la plus belle équation que j'ai jamais vue:

Usage

{% katex(block=false) %} e^{i\pi}+1=0 {% end %}

Sortir

<script type="math/tex">e^{i\pi}+1=0</script>

Bloquer les mathématiques

Certaines mathématiques en mode affichage sont assez justes :

Usage

{% katex(block=true) %} \int_0^1 x^2 dx {% end %}

Sortir

<script type="math/tex;mode=display">\int_0^1 x^2 dx</script>

Rendu automatique en ligne

$ e^{i\pi}+1=0 $

$ e^{i\pi}+1=0 $

Bloc de rendu automatique

$$
f(x) = \int_{-\infty}^\infty\hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi
$$

$$ f(x) = \int_{-\infty}^\infty\hat f(\xi),e^{2 \pi i \xi x},d\xi $$