Tiramisu Docs

Basics

Syntaxe

Comprenez la syntaxe fondamentale de Tiramisu : appels de fonctions, imbrication, paragraphes et échappement.

Tiramisu possède une seule construction fondamentale : l'appel de fonction.

Appels de fonctions

Un appel de fonction se compose d'un nom suivi d'un contenu entre accolades :

tiramisu
name { content }

Le nom peut être n'importe quel texte avant l'accolade ouvrante. Le contenu peut inclure du texte brut, d'autres appels de fonctions, ou un mélange des deux.

Imbrication

Les appels de fonctions peuvent être imbriqués à n'importe quelle profondeur :

tiramisu
bold { italic { underline { deeply nested } } }

Chaque appel de fonction peut contenir du texte brut, d'autres appels de fonctions, ou les deux :

tiramisu
bold { This is italic { partially } formatted }

Paragraphes

Le texte brut en dehors des appels de fonctions devient du contenu de paragraphe. Les paragraphes sont séparés par des lignes vides :

tiramisu
This is the first paragraph.

This is the second paragraph.

This is the third.

Noms de fonctions

Un nom de fonction est n'importe quel texte juste avant une accolade ouvrante {. Cela signifie que les noms de fonctions peuvent inclure des espaces, des chiffres et des caractères spéciaux — bien que par convention, la plupart des noms de fonctions soient de simples identifiants :

tiramisu
bold { works }
myWidget { works }

Échappement

Pour empêcher un appel de fonction d'être analysé, préfixez le nom de la fonction avec un antislash :

tiramisu
bold { this is literal text }

Cela affiche : bold { this is literal text } — l'antislash indique au parseur de traiter bold comme du texte brut plutôt que comme un appel de fonction.

Caractères spéciaux

Certains caractères ont une signification spéciale à l'intérieur des paramètres d'appels de fonctions. Vous ne devez les échapper que lorsqu'ils apparaissent à l'intérieur de { } — dans le texte de paragraphe ordinaire, ils sont traités littéralement et ne nécessitent aucun échappement.

ÉchappementCaractèrePourquoi
\,VirguleEmpêche la séparation des paramètres
\=ÉgalEmpêche l'analyse des paramètres nommés
\{Accolade ouvranteEmpêche l'analyse d'appel de fonction
\}Accolade fermanteEmpêche la fermeture d'un appel de fonction
\[Crochet ouvrantEmpêche l'analyse de tableau
\]Crochet fermantEmpêche la fermeture d'un tableau
\nameNom de fonctionTraite le nom comme du texte littéral