Apprendre LHTML
LHTML part du HTML : tout ce que vous écrivez est du HTML, sauf quelques symboles que LHTML
convertit. Le reste passe tel quel : tout HTML, CSS et JavaScript reste disponible, <script> et
<style> compris. Apprenez ces symboles, et vous connaissez LHTML.
Chaque page montre quelques lignes de LHTML, le HTML qu'elles produisent, et le résultat. Pour
convertir vos propres fichiers avec la commande lhtml ou depuis Python : Utiliser LHTML seul.
Toute la syntaxe en un coup d'œil
| Vous écrivez | Vous obtenez |
|---|---|
= Titre |
<h1>Titre</h1> ; == Section donne <h2>, et ainsi de suite |
* élément |
une liste ; ** élément une liste imbriquée |
**gras** et __italique__ |
<strong> et <em> |
`code` |
du code en ligne, jamais lu comme du LHTML |
div::[color:gray;] ... :: |
<div style="color:gray;"> ... </div> |
span::[color:red;] mot :: |
<span style="color:red;"> mot </span>, au milieu d'une phrase |
link::https://example.org[texte] |
<a href="https://example.org">texte</a> |
img::photo.jpg[width:300px;] |
<img style="width:300px;" src="photo.jpg" ...> |
video::clip.mp4{controls} |
une <video> avec ses boutons de lecture |
code::[python] ... code::[-] |
un bloc de code coloré |
::nl |
un espace vertical d'une ligne |
<p>...</p>, <br> |
paragraphes et retours à la ligne : une ligne vide n'en crée pas |
<b>tout HTML</b> |
conservé tel quel |
LHTML partage avec Markdown **gras**, les listes en * et le `code`. Trois choses diffèrent,
parce que LHTML suit le HTML :
Tout ensemble
= Notes de cours
== Semaine 1
* **Lire** le chapitre sur l'__interpolation__
* Lancer `python demo.py`
** comparer avec les slides
* link::https://example.org[La référence]
::[background:#f3f6ff; padding:8px 12px; border-radius:6px;]
Une remarque dans un encadré bleu clair.
::HTML produit
<h1>Notes de cours</h1>
<h2>Semaine 1</h2>
<ul>
<li>
<strong>Lire</strong> le chapitre sur l'<em>interpolation</em>
</li>
<li>
Lancer <code class="code-inline">python demo.py</code>
<ul>
<li>
comparer avec les slides
</li>
</ul>
</li>
<li>
<a href="https://example.org">La référence</a>
</li>
</ul>
<div style="background:#f3f6ff; padding:8px 12px; border-radius:6px;">
Une remarque dans un encadré bleu clair.
</div>L'essentiel en 10 minutes
Le tableau ci-dessus est toute la syntaxe. Pour l'utiliser avec assurance, lisez cette page, puis trois pages :
- Texte : gras, italique, code en ligne, et pourquoi une ligne vide ne crée pas de paragraphe.
- Blocs et styles : le système
::, le cœur de LHTML. - Liens et images :
link::,img::,video::.
Ensuite, au besoin
- Titres :
=,==, avec une classe ou un id. - Listes :
*,**, et les listes numérotées en HTML. - Classes et id :
(.note #tip)sur les blocs, titres, liens et images. - Code : les blocs de code colorés.
- HTML, formules et Jinja : ce que LHTML laisse tel quel.
- Vos propres balises : les macros : une balise déclarée une fois, utilisée sur toutes les pages.
Toutes les règles, avec leurs cas limites, sont dans la Référence de la syntaxe.
Suivant : Titres.