LHTML+ lhtml-site

Code

Un bloc de code commence par code::[language] et se termine par code::[-] :

Python, coloré
LHTML
code::[python]
def bounce(height, loss=0.8):
    return height * loss
code::[-]
Résultat
HTML produit
<div class="code"><pre><span></span><span class="k">def</span><span class="w"> </span><span class="nf">bounce</span><span class="p">(</span><span class="n">height</span><span class="p">,</span> <span class="n">loss</span><span class="o">=</span><span class="mf">0.8</span><span class="p">):</span>
    <span class="k">return</span> <span class="n">height</span> <span class="o">*</span> <span class="n">loss</span>
</pre></div>

Ses lignes ne sont jamais lues comme du LHTML : un :: dans le code ne peut pas fermer le bloc, et **, < et > s'affichent tels qu'écrits.

Du C++, avec :: et < >
LHTML
code::[c++]
std::vector<float> heights; // **pas en gras**
code::[-]
Résultat
HTML produit
<div class="code"><pre><span></span><span class="m">std::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">float</span><span class="o">&gt;</span><span class="w"> </span><span class="n">heights</span><span class="p">;</span><span class="w"> </span><span class="c1">// **pas en gras**</span>
</pre></div>
  • Tout langage connu de Pygments : python, c++, glsl, bash... Majuscules et minuscules sont équivalentes.
  • code::[] donne du texte brut. Un langage inconnu donne aussi du texte brut, avec un avertissement qui propose un nom proche (pyhton : vouliez-vous dire python ?).
  • Un code::[python] sans son code::[-] n'est pas un bloc de code : LHTML le signale, et lit les lignes comme du LHTML.

Les couleurs viennent d'une feuille de style ; les thèmes de lhtml-site en incluent une. Avec LHTML seul, créez-la avec Pygments et donnez-la à la page :

pipx run --spec pygments pygmentize -S default -f html -a .code > code.css
lhtml page.l.html --css code.css -o page.html

Pour un mot de code dans une phrase, utilisez le code en ligne entre accents graves.

Suivant : HTML, formules et Jinja. Toutes les règles : Référence de la syntaxe.

Construit avec lhtml-site, thème docs. Fait partie de ScholarTools.