Ajouter KateX à zola

2023-06-14

En partant du even theme, j'ai ajouté $\KaTeX$ à ce blog ce qui est très utile pour les abstracts d'article notamment. Pour ajouter $\KaTeX$ à un site fait avec zola:

Ajouter le code ci-dessous au fichier html principal (base.html pour ce site) pour importer le js et le css de katex:

        {% block js %}
        {% if config.extra.katex_enable %}
        <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/katex.min.css" 
        integrity="sha384-9eLZqc9ds8eNjO3TmqPeYcDj8n+Qfa4nuSiGYa6DjLNcv9BtN69ZIulL9+8CqC9Y" crossorigin="anonymous">

        <script defer src="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/katex.min.js" 
        integrity="sha384-K3vbOmF2BtaVai+Qk37uypf7VrgBubhQreNQe9aGsz9lB63dIFiQVlJbr92dw2Lx" crossorigin="anonymous"></script>
        <script defer src="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/contrib/mathtex-script-type.min.js" 
        integrity="sha384-zWYbd0NBwgTsgIdFKVprSfTh1mbMPe5Hz1X3yY4Sd1h/K1cQoUe36OGwAGz/PcDy" crossorigin="anonymous"></script>
            {% if config.extra.katex_auto_render %}
        <script defer src="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/contrib/auto-render.min.js" 
        integrity="sha384-kmZOZB5ObwgQnS/DuDg6TScgOiWWBiVt0plIRkZCmE6rDZGrEOQeHM5PcHi+nyqe" crossorigin="anonymous"
                onload="renderMathInElement(document.body);"></script>
            {% endif %}
        {% endif %}
        {% endblock js %}

        {% block css %}
            {% if config.extra.katex_enable %}
            <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/katex.min.css" 
            integrity="sha384-9eLZqc9ds8eNjO3TmqPeYcDj8n+Qfa4nuSiGYa6DjLNcv9BtN69ZIulL9+8CqC9Y" crossorigin="anonymous">
            {% endif %}
        {% endblock css %}

Créer le fichier templates/shortcodes/katex.html en y ajoutant:

        <script type="math/tex{% if block %};mode=display{% endif %}">{{body | safe}}</script>

Ajouter le code ci-dessous à config.toml, pour permettre l'utilisation de { { katex(body="\KaTeX") } } et { % katex(block=true) %}\KaTeX{% end % }

        [extra]
        katex_enable = true

Ou ajouter le code ci-dessous à config.toml, pour pouvoir utiliser \$ \KaTeX \$, \\[ \KaTeX \\] et $$ \KaTeX $$

        [extra]
        katex_enable = true
        katex_auto_render = true