Blocs de code

Configurer la coloration, les noms de fichier, les numéros et les lignes mises en évidence.

Le thème confie les blocs de code Markdown au moteur Chroma de Hugo. Il ajoute un en-tête indiquant le langage ou le nom de fichier ainsi qu’un bouton de copie.

Exemple simple#

```python {filename="report.py"}
print("prêt")
```

Options par bloc#

Option	Défaut	Effet
`filename="report.py"`	Langage	Affiche le nom de fichier dans l’en-tête
`linenos=false`	Réglage du site	Masque les numéros de ligne
`linenos=table`	Réglage du site	Place les numéros dans une colonne copiable
`linenos=inline`	Réglage du site	Insère le numéro dans chaque ligne
`linenostart=20`	`1`	Commence la numérotation à 20
`hl_lines=[3,"6-8"]`	Aucun	Met en évidence des lignes et plages
`anchorlinenos=true`	`false`	Rend les numéros de ligne cliquables
`lineanchors="exemple-"`	Vide	Préfixe les ancres pour éviter les collisions

Valeurs par défaut du site#

hugo.toml

[markup.highlight]
  lineNos = false
  lineNumbersInTable = true
  noClasses = false
  tabWidth = 4

Les attributs d’un bloc remplacent ces valeurs. noClasses = false permet au thème d’adapter les couleurs aux modes clair et sombre. La référence Hugo présente toutes les options Chroma.