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 :
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 :
bold { italic { underline { deeply nested } } } Chaque appel de fonction peut contenir du texte brut, d'autres appels de fonctions, ou les deux :
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 :
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 :
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 :
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.
| Échappement | Caractère | Pourquoi |
|---|---|---|
\, | Virgule | Empêche la séparation des paramètres |
\= | Égal | Empêche l'analyse des paramètres nommés |
\{ | Accolade ouvrante | Empêche l'analyse d'appel de fonction |
\} | Accolade fermante | Empêche la fermeture d'un appel de fonction |
\[ | Crochet ouvrant | Empêche l'analyse de tableau |
\] | Crochet fermant | Empêche la fermeture d'un tableau |
\name | Nom de fonction | Traite le nom comme du texte littéral |
{ }, les virgules, les signes égal, et les crochets sont de simples caractères ordinaires.