Animation Source

Ce langage a été mis au point afin de fournir aux auteurs une manière simple et efficace d'écrire des livres-jeu ( ou AVH ).
Grâce à ce langage, vous pourrez écrire vos oeuvres "hors ligne" à l'aide d'un simple éditeur de texte comme 'notepad' ( sous Windows ) ou 'vim', 'mousepad' ou autre ( sous GNU/Linux )
Une fois composé, le livre pourra être importé directement sur Balto source ou le Roi lion source et mis en ligne très rapidement.

Nous avons cherché à concevoir un langage "à balises" aussi simple que possible, afin que les auteurs puissent se consacrer principalement au contenu sans devoir apprendre une syntaxe compliquée et rébarbative.

Voici la syntaxe du GBL:


LANGAGE G.B.L.



1.Présentation

Le Langage G.B.L. a été originellement conçu pour le site http://www.gamebook-land.com/fr/

Il permet de créer des livres-jeux avec un simple éditeur de texte ( comme 'notepad' sous Windows, ou bien vim/mousepad/nedit/... sous GNU/Linux )
grâce à un système de balises simplifié.

Le logiciel Gamebook Maker permet d'utiliser ce format spécifique, tout en offrant un confort accru et un suivi fiable au cours de l'écriture du livre-jeu. Attention: Certaines balises créées par gamebook Maker ne sont pas encore prises en compte par le site, mais soyez patient, cela viendra

2. Exemple simple de livre-jeu en G.B.L.

Code: Tout sélectionner

@titre Le bus infernal

@auteur redo_fr

@licence Creative Commons nc-by-sa

@version 1.0

@paragraphes 10

#1# Une drôle de matinée
Alors que vous somnolez tranquillement à  l'arrière du bus qui vous conduit, comme tous les matins, à  votre travail, vous remarquez un jeune garçon en train de faire les poches d'une étudiante assoupie.
>Vous laissez le voyou faire=3
>Vous vous levez et attrapez le voleur par l'oreille=2

#2# Acte civique
Vous vous approchez discrètement du jeune voyou et l'attrapez brutalement par l'oreille en lui criant : "Dis donc, toi! Je vais t'apprendre à voler! Allez hop! Au commissariat".
Le garçon se débat un peu en criant car vous lui faites mal à  l'oreille, mais vous restez ferme.
>Si vous voulez fouiller ses poches=4
>Si vous préférez le remettre tout de suite aux autorités=5

#3# Prudence est mère de sureté
Vous songez que ce voleur, bien que jeune, pourrait fort bien être armé...Vous préférez, non sans honte, fermer les yeux et faire semblant de dormir.
>Continuer=6

#4# Fouille...
Tout en continuant à maintenir l'oreille du garnement dans une terrible prise de vos doigts, vous passez rapidement les mains dans ses poches de blouson, histoire de trouver un éventuel butin.
Mais mis à part quelques vieux emballages de bonbons poisseux, vous ne trouvez rien.
>Si vous souhaitez maintenant le relâcher=7
>S'il vous semble plus judicieux de le remettre aux autorités=5

#5# Commissariat
Tout en continuant à tenir le jeune voleur par l'oreille, vous avisez un arrêt de bus proche du commissariat et en descendez avec le jeune voyou. Arrivé au guichet, vous racontez au fonctionnaire de faction la mésaventure que vous venez de vivre. Le policier prend aussitôt votre déposition, juste après avoir appelé un collègue pour prendre en charge l'apprenti pickpocket.
L'agent vous remercie chaleureusement pour votre acte civique, ajoutant que c'est malheureusement de plus en plus rare. Vous saluez le policier et ressortez sur le trottoir, puis, d'un pas alerte, vous retournez à  l'arrêt de bus attendre le prochain qui pourra vous déposer à  votre bureau.
>Continuer=8

#6# Chacun ses affaires...
Vous fermez les yeux et faites semblant de dormir. Au bout de quelques secondes, le jeune voyou descend à  un arrêt, probablement avec son butin, et s'éloigne tranquillement. Un peu honteux de votre attitude, vous vous rassurez en vous disant que vous avez certainement évité un coup de couteau, ou pire. Peu après, le bus arrive enfin à  l'arrêt le plus proche de votre lieu de travail et vous vous empressez de descendre pour commencer votre journée.
>Continuer=8

#7# Pas de preuves
Vous n'avez trouvé aucune preuve de la tentative de vol du jeune garçon. Quelque peu dépité de l'issue de votre intervention, vous n'avez d'autre choix que de relâcher le voyou, qui s'empresse de vous faire un geste obscène avant de s'éloigner, l'air goguenard. Bouillant de rage, mais mis dans 'incapacité d'agir, vous vous rasseyez en attendant d'arriver à votre arrêt de bus : Voilà une journée qui commence bien mal...
>Continuer=8

#8# Arrivée au bureau
Vous descendez du bus à  votre arrêt habituel, lorsque, tournant le regard un peu plus loin vers la droite, vous apercevez votre chef de service, en grande discussion avec deux individus vêtus de noir et portant d'austères lunettes de soleil. Votre chef semble assez bouleversé par la conversation à  la vue des gestes véhéments qu'il fait dans leur direction.
>Si vous voulez vous approcher du groupe pour surprendre leurs paroles=9
>Si vous préférez laisser cela de coté et continuer vers votre bureau=10

#9# La curiosité...
Vous vous approchez discrètement du groupe, qui ne semble pas vous remarquer. D'après les bribes de conversation que vous surprenez, le sujet semble être un accrochage entre le véhicule de votre chef et celui des deux hommes. Les individus en noir accusent votre supérieur hiérarchique d'avoir frôlé leur véhicule avec sa propre voiture, causant des rayures sur l'une des ailes.
Pour éviter d'être pris à  partie, vous préférez vous éloigner rapidement pour rejoindre votre bureau
>Continuer=10

#10# Au bureau
Enfin! Après cette matinée mouvementée, vous êtes assis à  votre bureau, votre ordinateur connecté au réseau  et près à  recevoir le volumineux courrier électronique qui vous est envoyé chaque jour. A ce moment précis, deux de vos collègues pénètrent dans votre bureau et vous invitent à  venir prendre un café : La journée de travail a commencé...
-[FIN DE L'EPISODE]-




3 Syntaxe du langage


3.1 Paramètres globaux

Les paramètres globaux s'appliquent à tout le livre. Ils permettent de définir des
éléments sur la façon de lire le fichier source mais aussi le titre du livre, son auteur et la
licence éventuelle sous laquelle le livre-jeu est publié.

Les paramètres globaux commencent tous par le symbole '@' ( arobas )

3.1.1 Titre

@titre <titre du livre>


Ex: @titre Le bus infernal


3.1.2 Auteur

@auteur <auteur du livre>


Ex: @auteur redo_fr

3.1.3 Licence

@licence <licence choisie>

Ex: @licence Creative Commons nc-by-sa

3.1.4 Version

@version 1.0

Cette valeur doit être fixée à 1.0 pour l'instant.

3.1.5 accents

@accents=HTML

Cette balise optionnelle permet d'utiliser la syntaxe HTML pour les caractères accentués.
C'est à dire que si vous placez cette balise dans votre fichier les cactères è,é,à,ç,...
seront notés respectivement : &eacute; , &egrave; , &agrave; , &ccedil; , etc....
De plus, une balise <br /> pourra être placée à chaque fin de ligne.

3.1.6 paragraphes

@paragraphes <nombre de paragraphes au total>

Cette balise permet de préciser le nombre de paragraphes que comprendra votre Livre-Jeu
lorsqu'il sera complet.

Ex: @paragraphes 200


3.2 Numérotation et titre de paragraphe

La numérotation est un élément essentiel au livre-jeu. C'est grâce à lui que le joueur peut passer de paragraphes en paragraphes en fonction de ses choix. Le numéro de paragraphe doit être encadré par deux signes '#' ( dièse ) suivi éventuellement d'un titre de paragraphe

#<numéro>#<titre>

Ex: #1# Le début d'un grande aventure



3.3 Notification de choix possible

Ce symbole permet d'afficher les choix possibles une fois le paragraphe en cours lu. Les choix ne peuvent être placés au milieu d'un paragraphe, ils doivent toujours être placés après le texte. Le symbole '>' ( supérieur ) est utilisé pour le texte du choix, suivi du symbole '=' ( égal ) pour le paragraphe où se rendre.

><texte du choix>=<numéro du paragraphe suivant>

Ex: >Si vous souhaitez aller au Nord=28


3.4 Caractères spéciaux

Si vous souhaitez utiliser l'un des caractères spéciaux dans le texte(#,>,+ ou $), faites le précéder du signe '/' (doublez le pour représenter un '/' dans le texte).

Ex: Ce bijou coûte 300 /$

(Affichera: Ce bijou coûte 300 $)


Pour accéder à l'interface de gestion du G.B.L. rendez-vous sur la page de création des livres-jeu. Vous y verrez un lien portant la mention "Importer depuis un fichier ou un format texte (GBL)" qui vous permet d'envoyer une de vos oeuvres au format texte ( G.B.L. ) sur le site.

L'option "Exporter au format GBL", au contraire, vous permettra de récupérer l'un de vos LJ pour le (re)travailler hors ligne.

C'est tout pour l'instant

Ce sujet sera complété au fur et à mesure de l'évolution du G.B.L. mais aussi de vos remarques et commentaires, donc n'hésitez pas à poster!

Note : Texte originellement écrit par redo_fr (publié sous licence Licence Creative Commons nc-by-sa - utilisation interdite sans citer l'auteur original, pas d'utilisation commerciale)