Hugo et pandoc font des maths

Le rendu des écritures mathématiques pose des difficultés identiques à celui de la notation musicale en particulier il est difficile d’y séparer la sémantique de la présentation. Pour l’édition électronique, le couple TeX/LaTeX s’impose dès que l’on a plus de deux équations à écrire mais n’est pas standardisé.

Différentes solutions pour rendre des formules mathématiques sur une page web :

Avec hugo il faut injecter du javascript quelque part dans la page et s’assurer que les balises sont préservées par le processeur markdown utilisé. La documentation est claire, la difficulté vient de l’étape 3. Si l’on utilise un thème personnel, aucun problème mais si l’on utilise différents thèmes, il faut trouver comment de modéle prévoit d’injecter du code entre les balises <head> et </head>, par exemple :

  • pour ananke, on ajoute un fichier site-scripts.html dans layouts/partials/.
  • pour hugo-book, on ajoute un fichier head.html dans layouts/partials/docs/inject/. [TODO] Dans ce thème, {{ partialCached "math.html" . }} ne trouve pas le fichier math.html situé dans layout/_partials…

ven. 28 nov. 2025 16:03:42 CET#

Le thème hugo-book dépend de hugo min_version = "0.146.0" or la version présente dans trixie est 0.131.0-1 mais dans forky on a la version 0.152.2-1, on va donc inclure les dépôts forky (actuelle testing) dans les sources :

frv@cavalas:~$ cat /etc/apt/sources.list.d/debian-forky.sources 
Types: deb
URIs: https://deb.debian.org/debian
Suites: forky forky-updates
Components: main contrib non-free non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb
URIs: https://security.debian.org/debian-security
Suites: forky-security
Components: main contrib non-free non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
frv@cavalas:~$

On ne veut pas une mise à jour complète vers forky donc on donne une préférence faible à cette source :

frv@cavalas:~$ cat /etc/apt/preferences.d/forky 
Package: * 
Pin: release n=forky
Pin-Priority: 390
frv@cavalas:~$ 
frv@cavalas:~$ sudo apt update
Atteint : 1 http://deb.debian.org/debian trixie-backports InRelease
Atteint : 2 https://deb.debian.org/debian forky InRelease                                                                               
Atteint : 3 https://deb.debian.org/debian forky-updates InRelease                                                                                                  
Atteint : 4 http://download.virtualbox.org/virtualbox/debian trixie InRelease                                                                                      
Atteint : 5 https://deb.debian.org/debian trixie InRelease                                                                       
Atteint : 6 https://deb.debian.org/debian trixie-updates InRelease                                                               
Atteint : 7 https://security.debian.org/debian-security forky-security InRelease                                                 
Atteint : 8 https://security.debian.org/debian-security trixie-security InRelease
Atteint : 9 https://download.vscodium.com/debs vscodium InRelease        
2 paquets peuvent être mis à jour. Exécutez « apt list --upgradable » pour les voir.
Notification : Le fichier configuré « contrib/binary-i386/Packages » ne sera pas pris en compte car le dépôt « http://download.virtualbox.org/virtualbox/debian trixie InRelease » ne prend pas en charge l'architecture « i386 »
frv@cavalas:~$

TODO supprimer l’architecture i386

frv@cavalas:~$ apt-cache policy hugo
hugo:
  Installé : 0.131.0-1
  Candidat : 0.131.0-1
 Table de version :
     0.152.2-1 390
        390 https://deb.debian.org/debian forky/main amd64 Packages
 *** 0.131.0-1 500
        500 https://deb.debian.org/debian trixie/main amd64 Packages
        100 /var/lib/dpkg/status
frv@cavalas:~$

Puis :

frv@cepet:~/ws/frv.frama.io $ sudo apt install -t forky hugo
Mis à jour :                                    
  hugo

Sommaire :
  Mise à niveau de : 1. Installation de : 0Supprimé : 0. Non mis à jour : 1919
Taille du téléchargement : 11,2 MB
  Espace libéré : 22,8 MB

Réception de : 1 https://deb.debian.org/debian forky/main arm64 hugo arm64 0.152.2-1 [11,2 MB]
11,2 Mo réceptionnés en 0s (43,4 Mo/s)
Lecture des fichiers de modifications (« changelog »)... Terminé
(Lecture de la base de données... 584011 fichiers et répertoires déjà installés.)
Préparation du dépaquetage de .../hugo_0.152.2-1_arm64.deb ...
Dépaquetage de hugo (0.152.2-1) sur (0.131.0-1) ...
Paramétrage de hugo (0.152.2-1) ...
Traitement des actions différées (« triggers ») pour man-db (2.13.1-1) ...
Scanning processes...                                                                                                                                                                                                                         
Scanning candidates...                                                                                                                                                                                                                        
Scanning processor microcode...                                                                                                                                                                                                               
Scanning linux images...                                                                                                                                                                                                                      

Running kernel seems to be up-to-date.

Failed to check for processor microcode upgrades.

No services need to be restarted.

No containers need to be restarted.

No VM guests are running outdated hypervisor (qemu) binaries on this host.
frv@cepet:~/ws/frv.frama.io $ hugo version
hugo v0.152.2+extended linux/arm64 BuildDate=2025-10-26T22:50:23Z VendorInfo=debian:0.152.2-1
frv@cepet:~/ws/frv.frama.io $

Cool

arrow_back

Hugo tips