LHTML+ lhtml-site

Texte

Paragraphes et retours à la ligne

Une ligne vide ne crée pas de paragraphe, et un retour à la ligne dans la source n'est pas un retour à la ligne dans la page. La raison : LHTML part du HTML. Ce qui n'est pas l'un de ses symboles est du HTML, et un navigateur qui lit du HTML joint les lignes de la source, lignes vides comprises. LHTML garde cette règle, pour que le HTML que vous écrivez ou collez se comporte comme partout ailleurs.

Les lignes sont jointes
LHTML
Une première ligne
et une deuxième.

Une ligne après une ligne vide.
Résultat
HTML produit
Une première ligne
et une deuxième.

Une ligne après une ligne vide.

Pour les séparer, écrivez les paragraphes et les retours à la ligne en HTML, avec <p> et <br> :

Des paragraphes et un retour à la ligne en HTML
LHTML
<p>Un premier paragraphe.</p>
<p>Un deuxième paragraphe,<br>
sur deux lignes.</p>
Résultat
HTML produit
<p>Un premier paragraphe.</p>
<p>Un deuxième paragraphe,<br>
sur deux lignes.</p>

Ou reproduisez chaque retour à la ligne de la source : l'option line-breaks: true dans le configure.yaml de lhtml-site, ou -b pour la commande lhtml. Chaque retour à la ligne devient alors un <br>, lignes vides comprises ; les titres, les listes et les blocs n'en reçoivent pas.

Gras, italique et code en ligne

LHTML
Ceci est en **gras**, ceci est en __italique__,
et ceci est du `code en ligne`.
Résultat
HTML produit
Ceci est en <strong>gras</strong>, ceci est en <em>italique</em>,
et ceci est du <code class="code-inline">code en ligne</code>.
  • **...** donne <strong>, __...__ donne <em>. Ils s'imbriquent (**gras __et italique__**), mais ne se chevauchent pas.
  • Le gras et l'italique restent sur leur ligne : un ** ouvert sur une ligne et fermé sur la suivante reste du texte, avec un avertissement.

Le code en ligne est littéral

Rien n'est converti entre des accents graves : ni **, ni __, ni une balise. Ses < et > s'affichent tels quels.

Du code affiché tel qu'écrit
LHTML
Écrivez `**gras**` pour obtenir du **gras**.
Une liste de flottants : `std::vector<float>`.
Résultat
HTML produit
Écrivez <code class="code-inline">**gras**</code> pour obtenir du <strong>gras</strong>.
Une liste de flottants : <code class="code-inline">std::vector&lt;float&gt;</code>.

Hors des accents graves, <float> serait lu comme une balise HTML, que le navigateur n'affiche pas.

Un espace

::nl est un espace vertical d'une ligne :

LHTML
Au-dessus
::nl
En dessous
Résultat
HTML produit
Au-dessus
<div style="height:1em;"></div>
En dessous

Les thèmes de slides ont une macro gap:: pour des espaces de plusieurs tailles : gap::s, gap::, gap::l, gap::xl (voir Vos propres balises : les macros).

Suivant : Blocs et styles. Toutes les règles : Référence de la syntaxe.

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