Dokumentation
Der umfassende Leitfaden zu Tralo
Alles, was du wissen musst, um deine verzweigten Geschichten und deine Flashcards zu erstellen, zu teilen und zu verbessern, einschließlich des JSON-Formats für den Import und Export.
1. Erste Schritte
Créez un compte gratuit, et vous arrivez sur votre dashboard : c'est votre bibliothèque. Vous y trouvez d'office deux histoires de démonstration (badge « Démo ») : jouez-les pour comprendre l'expérience élève. Elles ne sont pas modifiables, mais le menu ⋯ permet de les dupliquer dans votre bibliothèque pour les adapter librement.
Le bouton + Nouvelle histoire crée un brouillon avec une première scène et ouvre l'éditeur.
2. Eine Geschichte schreiben
Une histoire est une suite de scènes. Chaque scène raconte une situation (texte + image facultative) et propose des choix à l'élève :
• Un choix bonne réponse mène à la scène suivante (champ « Mène à la scène »). Vous pouvez y ajouter un renforcement : une phrase qui confirme et explique.
• Un choix fausse piste affiche son explication (« pourquoi c'est une erreur »), puis l'élève réessaie sur la même scène. Si vous lui donnez une scène cible, il part au contraire sur cette branche : utile pour créer de vraies bifurcations.
Une scène marquée « Scène finale » termine l'histoire, avec un ton : réussite, neutre ou échec. L'onglet Karte montre toutes les scènes et leurs connexions (vert = bonnes réponses, pointillés vermillon = fausses pistes).
Au moment de publier, Tralo vérifie votre histoire : scènes sans bonne réponse, bonnes réponses sans destination, scènes non reliées au départ, absence de fin… Vous pouvez corriger ou publier quand même.
3. Lernkarten erstellen
En plus des histoires, Tralo propose des paquets de flashcards : des cartes recto/verso idéales pour la révision et la mémorisation rapide. Parfait pour les dates historiques, le vocabulaire, les formules, ou toute notion nécessitant une mémorisation active.
Un paquet se compose de multiples cartes. Chaque carte a :
• Un recto (la question, le terme ou le concept)
• Un verso(la réponse, la définition ou l'explication)
Methode, um Wissen zu festigen.
Im Kartensatz-Editor können Sie: Karten hinzufügen, duplizieren oder löschen, ihre Reihenfolge festlegen und eine Echtzeit-Vorschau mit einem 3D-Umdreheffekt anzeigen.
4. Mit den Schülern teilen
Le bouton Teilen de l'éditeur active le lien de partage (de la forme tralo.fr/s/abc123). Vos élèves l'ouvrent sur n'importe quel appareil, sans créer de compte.
Vous pouvez définir un code d'accès (ex. 6EMEB) pour réserver l'histoire à votre classe : les élèves le saisissent une fois, il reste mémorisé pendant leur session. Désactivez le lien à tout moment : il cesse immédiatement de fonctionner.
5. Statistiken
Chaque lecture via le lien de partage alimente l'onglet Stats de l'éditeur : nombre de lectures, taux de complétion, score moyen, erreurs par lecture, et surtout les scènes les plus difficiles (où vos élèves se trompent le plus), précieux pour ajuster vos explications.
Le niveau de détail dépend de votre formule : les statistiques essentielles(cartes de synthèse) sont incluses dans le plan Gratuit ; l'analyse par scène est disponible dès le plan Essentiel ; les statistiques avancées (détail par session de lecture et export .csv) sont réservées aux plans Pro et Duo.
Les lectures sont sans identité déclaréepar défaut : aucun nom, prénom ni compte élève n'est demandé. Un identifiant technique de session et les données de progression restent toutefois enregistrés ; ces lectures sont donc pseudonymes, et non anonymes au sens strict du RGPD. Vos propres aperçus d'auteur ne comptent pas. Le bouton « Réinitialiser » efface l'historique (par exemple entre deux classes).
6. Die Bibliothek organisieren
Créez des dossiers colorés (par classe, matière, projet…) depuis la barre latérale du dashboard. Le menu ⋯ de chaque histoire permet de la déplacer, la dupliquer, l'exporter ou la supprimer. Supprimer un dossier ne supprime pas ses histoires : elles reviennent à la racine.
7. Import/Export und JSON-Format
Chaque histoire s'exporte en fichier .json (menu ⋯ → Exporter, ou paramètres de l'éditeur). Le bouton Importer (.json) du dashboard (réservé aux formules payantes) accepte :
• une histoire seule (le format ci-dessous) ;
• une sauvegarde complète : { "stories": [ … ] } (générée par « Tout exporter » dans les paramètres).
À l'import, tous les identifiants sont régénérés et l'histoire arrive en brouillon à la racine : aucun risque de collision, vous pouvez importer le même fichier plusieurs fois.
| Feld | Typ | Rolle |
|---|---|---|
| title | string | Titel der Geschichte (erforderlich). |
| description | string | Präsentation, die den Schülern vor Beginn angezeigt wird. |
| emoji | string | Emoji auf dem Titelbild (z. B. „ 🗝 “). |
| coverGradient | number | Farbe des Covers, von 0 bis 11. |
| startSceneId | string | ID der Startszene; muss in „scenes“ vorhanden sein (obligatorisch). |
| scenes | Scene[] | Die Liste der Szenen (obligatorisch). |
| Feld | Typ | Rolle |
|---|---|---|
| id | string | Eindeutige Kennung innerhalb der Datei (beliebig: „scene-1“…). |
| title | string | Titel der Szene (wird in der Kopfzeile auf der Schülerseite angezeigt). |
| text | string | Der Text. \n für Zeilenumbrüche. |
| image | string | null | URL eines Bildes oder null. |
| choices | Choice[] | Die angebotenen Auswahlmöglichkeiten ([] für eine Schlussszene). |
| isEnding | boolean | true = Endszene (beendet die Geschichte). |
| endingTone | string | „success“, „neutral“ oder „failure“: der Abschlussbildschirm. |
| Feld | Typ | Rolle |
|---|---|---|
| id | string | Eindeutige Kennung in der Datei. |
| text | string | Der Text der Auswahlmöglichkeit, der dem Schüler angezeigt wird. |
| targetSceneId | string | null | ID der Zielszene. Bei einer falschen Antwort: null = der Schüler versucht es erneut an derselben Stelle. |
| isCorrect | boolean | „true“ = richtige Antwort, „false“ = falsche Fährte. |
| explanation | string | Das nach der Auswahl angezeigte pädagogische Feedback. |
Vollständiges Beispiel (kann unverändert importiert werden):
{
"title": "Le Trésor du CDI",
"description": "Une enquête au CDI pour apprendre à chercher l'information.",
"emoji": "🗝️",
"coverGradient": 2,
"startSceneId": "scene-depart",
"scenes": [
{
"id": "scene-depart",
"title": "L'énigme",
"text": "Un mot mystérieux vous attend sur la table du CDI : « Le trésor se cache dans le livre qui parle des volcans d'Auvergne. »\n\nComment le trouver ?",
"image": null,
"choices": [
{
"id": "choix-catalogue",
"text": "Chercher « volcans Auvergne » dans le catalogue en ligne",
"targetSceneId": "scene-rayon",
"isCorrect": true,
"explanation": "Exact : le catalogue indique la cote du livre en quelques secondes."
},
{
"id": "choix-hasard",
"text": "Ouvrir tous les livres un par un",
"targetSceneId": null,
"isCorrect": false,
"explanation": "Avec 5 000 livres au CDI, il vous faudrait des semaines. Le catalogue est fait pour ça !"
}
],
"isEnding": false,
"endingTone": "neutral"
},
{
"id": "scene-rayon",
"title": "Au rayon 550",
"text": "Le catalogue indique la cote 551.21 VOL. Vous trouvez le livre… et à l'intérieur, une carte de lecteur dorée !",
"image": null,
"choices": [],
"isEnding": true,
"endingTone": "success"
}
]
}Dieses Format eignet sich gut für die Generierung durch eine KI: Geben Sie ihr diese Tabellen und bitten Sie sie um eine Geschichte zu Ihrem Thema, und importieren Sie anschließend das Ergebnis.
Eine Geschichte mit einer KI generieren: kopierfertige Eingabeaufforderung
Collez le texte ci-dessous dans l'assistant de votre choix (ChatGPT, Claude, Gemini…), remplacez ce qui est entre crochets par votre sujet et vos réglages, puis enregistrez la réponse dans un fichier .json que vous importerez avec le bouton Importer (.json) du dashboard.
Du bist Lernentwickler. Erstelle eine interaktive Geschichte mit Verzweigungen (eine Erzählung, bei der der Schüler die Handlung durch die Beantwortung von Fragen vorantreibt), die in Tralo importiert werden soll. PARAMETER (ersetze die Angaben in eckigen Klammern): - Thema: [THEMA, z. B. Wasserkreislauf] - Fach: [FACH, z. B. Biologie] - Klassenstufe: [KLASSENSTUFE, z. B. 6. Klasse] - Lernziel: [WAS DER SCHÜLER LERNEN ODER KÖNNEN SOLL] - Anzahl der Szenen: [CA. 8] - Anzahl der Enden: [MINDESTENS 2, davon ein erfolgreiches und ein erfolgloses] - Auswahlmöglichkeiten pro Szene: [2 BIS 3] - Ton / Atmosphäre: [z. B. Ermittlung, Abenteuer, Alltag] - Angestrebte Lesezeit: [z. B. 10 Minuten] - Sprache: [Französisch] - Zu vermeiden / zu bevorzugen: [vorgeschriebenes Vokabular, nicht zum Lehrplan gehörende Begriffe, die ausgeschlossen werden sollen, usw.] ANWEISUNGEN: - Jede Szene bietet Auswahlmöglichkeiten: mindestens eine richtige Antwort, die die Geschichte vorantreibt, sowie falsche Fährten. Jede falsche Fährte hat eine klare pädagogische Erklärung (warum sie falsch ist und was man hätte verstehen müssen). - Eine falsche Fährte mit „targetSceneId“: null lässt den Schüler die gleiche Szene erneut versuchen; andernfalls kann sie zu einem anderen Zweig führen. - Passe die Erzählung und den Wortschatz an das angegebene Niveau an, ohne Fehler. Der Fehler muss immer lehrreich sein. - Stelle die geforderte Anzahl an Enden bereit, mit unterschiedlichen Tönen (Erfolg / Misserfolg / neutral). AUSGABEFORMAT: Antworte AUSSCHLIESSLICH mit einem gültigen JSON-Objekt, ohne umgebenden Text oder Markdown-Tags, streng gemäß diesem Muster: { "title": "Zeichenkette", "description": "Zeichenkette (vor dem Start angezeigte Beschreibung)", "emoji": "ein einzelnes Cover-Emoji", "coverGradient": Ganzzahl von 0 bis 11, "startSceneId": "ID einer Szene aus der untenstehenden Liste", "scenes": [ { "id": "eindeutige Kennung, z. B. scene-1", "title": "Zeichenkette", "text": "der Text der Szene (\n für einen Zeilenumbruch)", "image": null, "choices": [ { "id": "eindeutige Kennung, z. B. choice-1", "text": „die dem Schüler angebotene Auswahl“, „targetSceneId“: „ID der Zielszene oder null, um es an Ort und Stelle erneut zu versuchen“, „isCorrect“: true oder false, „explanation“: „das nach dieser Auswahl angezeigte Feedback“Eine KI kann sich irren: Öffnen Sie die importierte Geschichte im Editor und überprüfen Sie die Übergänge zwischen den Szenen, die richtigen Antworten und die Enden, bevor Sie sie teilen. Der Import überprüft das Dateiformat, nicht die pädagogische Richtigkeit.
8. Kontoeinstellungen
La page Einstellungen (menu du compte → Paramètres) regroupe :
• Profil: changer votre nom ; changer d'e-mail (confirmé par un lien envoyé à la nouvelle adresse).
• Team : invitations, membres et dossier partagé.
• Einstellungen : affichage des histoires et flashcards de démonstration.
• Benachrichtigungen : choisir les e-mails facultatifs ; les messages essentiels de sécurité, facturation et suppression restent actifs.
• Sicherheit : changer de mot de passe, activer la vérification en deux étapes, renouveler les codes de secours et déconnecter des appareils.
• Meine Daten : compteurs et export complet de vos histoires et images en un fichier (votre sauvegarde), durée de conservation des statistiques lecteurs et effacement immédiat de ces statistiques.
• Sensibler Bereich : tout supprimer (après confirmation), demander la suppression du compte, se déconnecter.
Une question que cette page n'a pas résolue ? Écrivez-nous.
9. Abonnement & Rechnungen
Tout se gère depuis Paramètres → Abonnement & Factures, sans passer par un site externe. Vous pouvez à tout moment changer de formule, basculer entre mensuel et annuel (la différence est calculée au prorata), résilier ou réactiver. Vos factures y sont consultables et téléchargeables en PDF.
Les formules : Kostenlos (3 histoires, sans images), Das Wesentliche (100 histoires, sans images), Pro (histoires illimitées + images dans les scènes). Duo & Kleines Team (2 à 5 personnes) donne à chaque membre un accès Pro nominatif, un Dossier partagé et une facture unique ; gérez les membres depuis Réglages → Équipe.
Remise « TRALO50 » : elle offre −50 % pendant 3 mois sur les abonnements mensuels Essentiel et Pro. Elle est appliquée automatiquement sur la page de récapitulatif Tralo ; vous n'avez aucun code à saisir sur la page Stripe.
Que se passe-t-il si mon abonnement s'arrête ?Si vous résiliez ou qu'un paiement n'aboutit pas, l'accès aux fonctions payantes est suspendu, mais vos histoires restent là pendant un mois. Vous recevez un e-mail, puis un rappel une semaine avant, puis deux jours avant. Passé ce mois, le contenu est supprimé (histoires, dossiers, images, statistiques), mais votre compte est conservé : vous pouvez revenir et reprendre un abonnement quand vous voulez. Pendant ce mois, deux options : réactiver votre formule, ou télécharger tout votre travail.
10. Meine Geschichten und Bilder herunterladen
Vous gardez la main sur vos données. Pour tout récupérer, images comprises :
• Paramètres → Mes données → « Tout exporter (.zip) ». Vous obtenez un fichier .zip contenant tralo-sauvegarde.json (toutes vos histoires) et un dossier images/ avec toutes vos illustrations.
• Juste les images ? Depuis le dashboard → « Mes images », téléchargez une image à la fois, ou « Tout télécharger (.zip) ».
Pour réimporter plus tard, utilisez le bouton Importer (.json) du dashboard avec le fichier tralo-sauvegarde.json issu du zip (voir le format JSON).
11. Eine Organisation verwalten
Tralo Adminest la console séparée réservée aux organisations ouvertes avec l'équipe Tralo. Elle sert à gérer la structure, les membres, les invitations, les rôles, les licences, les contenus partagés, les statistiques, la facturation, la sécurité et le journal d'audit. Un abonnement individuel ou Duo ne donne pas automatiquement accès à cette console.
Le guide complet de Tralo Admin pour les organisations explique le parcours depuis l'invitation et la double authentification jusqu'aux opérations quotidiennes d'un administrateur, notamment la désignation du gestionnaire initial et l'invitation d'autres gestionnaires administrateurs.