Validation automatisée
En cours
Cette documentation est encore en cours d'expansion et d'affinement. Les fonctionnalités, captures d'écran et descriptions peuvent changer jusqu'à la sortie publique de Talescape. Si quelque chose n'est pas clair ou que tu as besoin d'aide, demande sur le Discord officiel de Talescape. On est ravis de clarifier ou de mettre à jour les pages si besoin.
Le Système de vérification de l'éditeur vous aide à vérifier que votre histoire est complète, cohérente et prête pour la publication. Il scanne automatiquement votre histoire à la recherche de problèmes courants (des assets manquants aux métadonnées incomplètes) et vous fournit des retours détaillés sur ce qu'il faut corriger.
Ces mêmes vérifications sont également utilisées lors de la revue automatisée qui s'exécute avant la publication. Les lancer depuis l'éditeur vous permet de résoudre les problèmes tôt et d'éviter un rejet lors du release.
1. Lancer les vérifications
Vous pouvez déclencher les vérifications de deux façons :
| Scope | Description |
|---|---|
| Global Check (Overview) | Lance toutes les validations disponibles pour l'ensemble de votre histoire. Accessible via le panneau Vérifications dans la barre latérale. |
| Local Check (Per Element) | Lance les validations pour l'élément que vous éditez actuellement, comme un chapitre, une scène ou un dialogue spécifique. |
Les résultats s'affichent immédiatement et sont groupés par catégorie (par ex. Marketplace, Chapitres, Scènes, Personnages). Vous pouvez relancer les vérifications à tout moment en cliquant sur Exécuter les vérifications.
2. Niveaux de gravité
Chaque problème se voit attribuer un niveau de gravité pour indiquer son importance :
| Severity | Description | Action |
|---|---|---|
| Info | Notes d'information ou suggestions. | Aucune action requise, mais peut aider à améliorer la qualité. |
| Warning | Problèmes potentiels qui pourraient poser souci selon le contexte. | Vérifier et corriger si pertinent. |
| Failure | Erreurs critiques qui empêchent la publication de votre histoire. | Doivent être résolues avant de créer une version/publication. |
Les échecs sont clairement mis en avant. Une histoire contenant des échecs ne peut pas être publiée tant qu'ils n'ont pas été résolus.
3. Vérifications typiques
Le système couvre à la fois les validations techniques et structurelles, telles que :
| Category | Example Checks |
|---|---|
| Marketplace | Longueur de la description, avertissements sur les captures d’écran et exigences de tags. |
| Chapters | Chaque chapitre a une scène de départ et au moins une sortie. |
| Scenes | Les scènes sont atteignables et les arrière-plans requis sont présents avant la publication. |
| Dialogues | Aucune branche inaccessible ni cible manquante. |
| Media | Tous les assets référencés existent et correspondent aux formats requis. |
| Items / Crafting | Les recettes, références d'objets et visuels destinés au joueur requis sont valides. |
Chaque vérification affiche son résultat, son horodatage et un message détaillé pour que vous sachiez exactement quoi ajuster.
4. Vérifications locales pendant l'édition
Vous pouvez aussi lancer des vérifications locales directement dans des éditeurs comme Scenes, Dialogues ou Chapters.
Ces vérifications ciblées ne vérifient que le contenu sur lequel vous travaillez actuellement, idéales pour une validation rapide avant de poursuivre le développement.
Exemple : Lors de l'édition d'une scène, les vérifications locales confirment les sorties valides, l'utilisation et les éventuelles conditions de publication manquantes, comme les arrière-plans obligatoires avant la mise en ligne.
5. Intégration à la publication
Le même système de validation est utilisé pendant la phase de Revue automatisée du release workflow. Si vous avez déjà corrigé tous les problèmes affichés dans le Système de vérification de l'éditeur, votre histoire passera automatiquement l'étape de revue automatisée.
Cela garantit une transition fluide du développement à la publication.
6. Bonnes pratiques
- Lancez des vérifications complètes de l'histoire régulièrement, surtout avant la soumission.
- Corrigez tous les échecs et examinez les avertissements pour éviter les surprises lors de la revue.
- Utilisez fréquemment les vérifications locales pendant l'édition pour détecter les problèmes tôt.
- Consultez les horodatages pour suivre quand chaque vérification a été effectuée pour la dernière fois.
Le Système de vérification de l'éditeur agit comme votre filtre de qualité interne, garantissant que chaque histoire publiée sur Talescape est stable, complète et prête à être explorée par les Dreamers.