LHTML+ lhtml-site

HTML, formules et Jinja

LHTML convertit quelques symboles et laisse tout le reste tel quel. C'est ce qui le rend facile à mélanger avec le reste du web.

HTML

Tout HTML est conservé : un tableau, un formulaire, une <iframe>, un SVG.

LHTML et HTML dans la même page
LHTML
== Résultats

<table border="1" cellpadding="4">
<tr><th>Méthode</th><th>Erreur</th></tr>
<tr><td>**La nôtre**</td><td>0,8 %</td></tr>
<tr><td>Référence</td><td>2,1 %</td></tr>
</table>
Résultat
HTML produit
<h2>Résultats</h2>


<table border="1" cellpadding="4">
<tr><th>Méthode</th><th>Erreur</th></tr>
<tr><td><strong>La nôtre</strong></td><td>0,8 %</td></tr>
<tr><td>Référence</td><td>2,1 %</td></tr>
</table>

Les symboles LHTML fonctionnent toujours dans le HTML : **La nôtre** est en gras dans sa cellule. Les balises elles-mêmes et leurs attributs ne sont jamais modifiés. Pas plus que <script>, <style> et les commentaires <!-- --> : un ** ou un ::before y reste tel qu'écrit.

Formules

\(...\) (dans une ligne) et \[...\] (isolée) sont conservées telles quelles, pour KaTeX ou MathJax. Les thèmes de lhtml-site les affichent avec KaTeX, dès la construction quand c'est possible.

Formules, conservées par LHTML, affichées ici par KaTeX
LHTML
La position d'une sphère en chute est \(z(t) = z_0 - \frac{1}{2} g t^2\), elle touche donc le sol à
\[ t^\star = \sqrt{\frac{2 z_0}{g}} \]
Résultat
HTML produit
La position d'une sphère en chute est \(z(t) = z_0 - \frac{1}{2} g t^2\), elle touche donc le sol à
\[ t^\star = \sqrt{\frac{2 z_0}{g}} \]

Les symboles LHTML ne sont pas lus dans une formule : __ et ** restent tels quels. Un $ est du texte ordinaire, comme dans un prix : écrivez \(...\), et non $...$.

Jinja

{{ ... }} et {% ... %} sont conservés eux aussi : un gabarit Jinja peut donc s'écrire en LHTML. Avec LHTML seul, convertissez d'abord, puis rendez le résultat avec Jinja2 : jinja2.Template(lhtml.run(texte)).render(...) (voir Using LHTML with Jinja2, en anglais).

Dans lhtml-site, chaque page est un gabarit Jinja, rendu avant LHTML : variables, boucles, macros Jinja et inclusions.

{% set students = ['Ada', 'Alan', 'Grace'] %}
{%- for name in students %}
* {{ name }}
{%- endfor %}

Jinja passe d'abord et écrit trois lignes * ; LHTML en fait ensuite une seule liste :

<ul>
<li>
Ada
</li>
<li>
Alan
</li>
<li>
Grace
</li>
</ul>

Le - de {%- supprime le retour à la ligne qui précède la balise : sans lui, chaque ligne {% for %} laisse une ligne vide entre les éléments, et chaque élément devient une liste à lui seul.

Dans lhtml-site : ce que reçoit chaque page

Variable Valeur
pathToRoot le chemin relatif vers la racine du site (../../), pour des liens qui fonctionnent à toute profondeur
page les réglages de la page : son titre, son en-tête YAML (page.layout, page.description...)
pageID le numéro de la page dans le site, à partir de 0
les clés de keywords: vos propres valeurs, tirées de configure.yaml

Un lien vers la page d'accueil depuis n'importe quelle page : link::{{ pathToRoot }}index.html[Accueil].

Suivant : Vos propres balises : les macros. Toutes les règles : Référence de la syntaxe.

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