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.
== 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>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.
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}} \]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.