# Le texte conditionnel

Le texte conditionnel permet d'afficher des passages différents selon l'état du jeu : la valeur d'une variable, le nombre d'étapes visitées, le temps passé, etc. C'est la base pour écrire des histoires réactives.

Texte conditionnel dans l’éditeur
Le texte conditionnel avec {{#if}} / {{#elseif}} / {{#else}} : le lecteur ne voit que la branche dont la condition est vraie.

# Comment l'utiliser

1

Ouvrez le menu Insérer

Cliquez sur le bouton ✨ Insérer dans la toolbar, ou appuyez sur Ctrl+/ (⌘+/ sur Mac).

2

Sélectionnez Texte conditionnel

Cliquez sur Texte conditionnel. Raccourci direct : Ctrl+Maj+C.

3

Définissez vos conditions

Choisissez la catégorie (Système, Étape visitée, Variable d'histoire), la variable, l'opérateur et la valeur à comparer. Ajoutez des blocs SINON SI / SINON si besoin.

4

Saisissez le texte à afficher

Pour chaque bloc, rédigez le texte qui sera affiché si la condition est vraie.

5

Insérez

Le code Handlebars est inséré dans votre contenu. Il sera évalué au moment de la lecture.

# Exemples courants

Exemple — Variable d'histoire

Si la variable Courage est ≥ 5 : « Vous avancez sans hésiter. » Sinon : « Vous reculez prudemment. »

Exemple — Étape visitée

Si l'étape « Rencontre avec Alice » a été visitée, afficher « Alice vous reconnaît aussitôt. » sinon « Un visage inconnu vous dévisage. »

Exemple — Temps sur l'étape

Si minutesOnStep ≥ 2 : « Les minutes s'éternisent. Il faut agir. » Permet de créer de la tension temporelle.

# Les catégories de conditions

CatégorieVariables disponiblesUsage
SystèmeaccessibleChildren, minutesOnStep, currentStepVisitCountConditions liées au moteur de jeu
Étape visitéeToutes les étapes de l'histoireMémoire narrative
Variable d'histoireLes variables que vous avez crééesLogique métier de votre histoire
Astuce

Vous pouvez combiner plusieurs conditions avec SINON SI pour créer des arbres de décisions riches sans multiplier les étapes.

# Un texte différent à chaque visite

À l'ouverture de la fenêtre du texte conditionnel, choisissez Selon la visite (ou, si vous avez déjà commencé, le bouton du même nom au-dessus des blocs). Écrivez simplement le texte de la Visite 1, de la Visite 2 (bouton Ajouter la visite, jusqu'à 5) et des visites suivantes : aucune condition à régler, l'aperçu montre ce que verra le lecteur. Laissez les visites suivantes vides pour n'afficher un passage qu'aux premières visites. Le lien Voir les conditions affiche les blocs SI / SINON SI / SINON correspondants, déjà remplis, pour y ajouter une autre condition ; Changer de méthode ramène au choix de départ. Une visite compte quand le lecteur arrive sur l'étape (retour d'un carrefour ou d'un aparté compris) ; recharger la page ne compte pas, et revenir en arrière en mode test remet le compteur à ce moment-là.

Un tirage au hasard qui ne change pas

Une valeur calculée au hasard dans le texte, par exemple {{= randint(1, 6)}}, est tirée une fois par visite : elle reste la même si le lecteur recharge la page, et elle est tirée à nouveau quand il revient sur l'étape.