LHTML+ lhtml-site

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
Par rapport à Markdown

LHTML partage avec Markdown **gras**, les listes en * et le `code`. Trois choses diffèrent, parce que LHTML suit le HTML :

  • __x__ est en italique ; le gras s'écrit **x**.
  • Les paragraphes s'écrivent en HTML : <p> et <br>. Comme un navigateur, LHTML joint les lignes de la source (Texte).
  • Une liste commence par * ; une liste numérotée est un <ol> (Listes).

Tout ensemble

Les principales constructions réunies
LHTML
= 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.
::
Résultat
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 :

  1. Texte : gras, italique, code en ligne, et pourquoi une ligne vide ne crée pas de paragraphe.
  2. Blocs et styles : le système ::, le cœur de LHTML.
  3. Liens et images : link::, img::, video::.

Ensuite, au besoin

Toutes les règles, avec leurs cas limites, sont dans la Référence de la syntaxe.

Suivant : Titres.

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