Les sous-graphes et les routines

Quand une histoire grandit, on a besoin de la ranger. Un sous-graphe est un petit graphe à part, mis de côté pour organiser votre récit ou pour réutiliser un même passage à plusieurs endroits.

Passer d’un graphe à l’autre

En haut du graphe, un sélecteur bascule entre l’histoire principale et vos sous-graphes. On y retrouve la liste de vos sous-graphes et un raccourci pour en créer un nouveau.

Le sélecteur qui bascule entre l'histoire principale et les sous-graphes. — Le sélecteur de graphe : passer de l’**histoire principale** à un sous-graphe.

Une fois dans un sous-graphe, une étiquette en haut à droite du graphe rappelle où vous êtes : le mode du sous-graphe, Chapitre, Routine ou Interlude, suivi de son nom.

Créer et appeler un sous-graphe

Dans l’onglet Sous-graphes, le bouton Ajouter crée un sous-graphe : vous lui donnez un nom et choisissez son mode. Un sous-graphe neuf arrive déjà équipé d’une séquence de départ et d’une Sortie de sous-graphe.

Pour l’utiliser dans l’histoire, on pose une séquence de type Sous-graphe là où on veut l’appeler. À la sortie, la lecture reprend son cours. Les sous-graphes en mode Interlude font exception : ils se déclenchent autrement, et ne sont pas proposés quand vous posez une séquence Sous-graphe. Voir Les interludes et les chapitres.

Un sous-graphe peut avoir plusieurs issues. Posez-y autant de séquences Sortie de sous-graphe que de façons d’en sortir : chacune devient une sortie de la séquence qui l’appelle, sous son nom, et vous la reliez comme un choix. Une sortie ajoutée plus tard apparaît sur chaque appel. Une sortie supprimée en disparaît, avec le lien qui en partait.

Dans la liste, le nom d’un sous-graphe est un bouton qui l’ouvre. Pour le renommer, passez par le menu … de la ligne, où se trouvent aussi Dupliquer et Supprimer.

Ranger des séquences dans un sous-graphe

Un passage déjà écrit se range sans être recopié. Sélectionnez ses séquences dans le graphe (voir Sélectionner plusieurs séquences), puis cliquez sur Transformer en sous-graphe dans le panneau Sélection multiple. Les séquences partent dans un nouveau sous-graphe, et une séquence Sous-graphe prend leur place dans le graphe, avec les mêmes liens.

L'éditeur avec deux séquences sélectionnées dans le graphe : à gauche, le panneau Sélection multiple les liste, avec en bas les boutons Transformer en sous-graphe et Supprimer (2). — Deux séquences sélectionnées : le panneau **Sélection multiple** propose de les **transformer en sous-graphe**.

La fenêtre qui s’ouvre demande le Nom du sous-graphe, obligatoire. Depuis l’histoire principale, elle demande aussi le Mode : Routine, choisi d’emblée, ou Chapitre. Depuis un autre sous-graphe, le nouveau sera une routine. La fenêtre montre enfin l’Entrée, la séquence par laquelle on entre dans la sélection, et les Sorties, une par séquence vers laquelle elle mène. Chaque sortie devient une Sortie de sous-graphe, nommée d’après sa destination.

La fenêtre Transformer 2 séquences en sous-graphe : le nom La traversée de la forêt, le mode Routine choisi à côté de Chapitre, puis l'entrée Séquence 1 et une sortie vers Séquence 3. — La fenêtre annonce l’entrée et les sorties du futur sous-graphe.

Toutes les sélections ne s’y prêtent pas. Un sous-graphe n’a qu’une entrée, il faut donc qu’une seule séquence de la sélection soit atteinte depuis l’extérieur. La sélection ne peut pas non plus contenir la séquence de départ, une fin d’histoire, une sortie de sous-graphe ou un fragment d’atelier collaboratif. Quand le geste est impossible, le bouton reste grisé, et la raison s’affiche juste en dessous : vous savez quelle séquence retirer de la sélection.

Remettre un sous-graphe dans le graphe

Le geste inverse se fait depuis une séquence Sous-graphe. Ouvrez le menu … de son panneau, puis choisissez Remettre dans le graphe.

Si le sous-graphe n’est appelé qu’à cet endroit, ses séquences reviennent dans le graphe, et le sous-graphe disparaît.
S’il est appelé à plusieurs endroits, une copie de ses séquences est posée ici, et le sous-graphe reste en place pour les autres appels.

La fenêtre Remettre « La traversée de la forêt » dans le graphe : ce sous-graphe n'est appelé qu'ici, ses 2 séquences reviennent dans le graphe et il disparaît. — La fenêtre dit ce qui va se passer avant que vous confirmiez.

Quand le sous-graphe a des variables locales, la fenêtre demande ce qu’elles deviennent. En faire des variables de l’histoire les garde avec leur nom et leur valeur de départ. Quand l’appel relie certaines d’entre elles à une variable de l’histoire, Les remplacer par la variable liée fait prendre leur place à cette variable.

Des variables locales

Une routine et un interlude peuvent avoir leurs propres variables locales, qui ne vivent que le temps de leur exécution. Vous pouvez aussi leur passer des valeurs en entrée et en récupérer en sortie, comme des paramètres.

Un chapitre, lui, n’a pas de variables locales. Il ne se joue qu’une fois, et une variable qui s’effacerait à sa sortie serait un piège : « A pris la clé », posé dans le premier chapitre, ne se retrouverait pas dans le suivant. Une variable que vous créez en travaillant dans un chapitre appartient donc à l’histoire. Une histoire plus ancienne peut encore porter des variables locales dans un chapitre : la Vérification les signale.

Le mode d’un sous-graphe change sa façon de s’insérer dans l’histoire. Voir Les interludes et les chapitres.