With textallion, you can also create traditional "Choose Your Own Adventure" books, with the help of a "txt2CYOA" module. Those stories are like normal books, except they offer choices to the reader at some points in the narration.
Your sections (chapters) will be created using the default txt2tags heading (level 2):
== z ==
Important: You must add spaces around the number to create the anchor.
To create a choice, use either :
- Description of the choice (starting with a dash "-"): number - Description of the choice: [#keyword] - Description of the choice: [#number]. More words afterwards. - Description of the choice with a [#keyword], and eventually some more things afterward.
with the number refering to the number of one of your chapter. Textallion will be able to detect that it's a choice, and link to the related chapter.
You must use the syntax [#number] if the number is followed by something and not alone at the end of the line. This syntax might not be supported in advanced export features (other CYOA systems). It works well with twine though.
Also if you need to describe your choice with more than one single [#keyword], or reuse the word but link to another place with another keyword for an alternative chapter, you can use this syntax:
[your description|#keyword_without-space]
The dash # is like an anchor which will redirect to the name of a chapter.
You can add pictures with [yourpicture.jpg] (or .png)
To use wrapped pictures, type:
[yourpicture.jpg](~~~~)
(default textallion behavior)
It's possible to get an organigram with all the chapters connected together.
You need to have graphviz installed to do that, and make sure each choice starts on one individual line, with a - and ends with the number of the choice.
You can invoque make cyoa-graph to produce the svg and png version.
note: in the case cyoa-graph is not working on windows, you can render the generated cyoa-game_graph.txt with online tools such as http://ashitani.jp/gv/
make cyoa-html : create HTML file to publish the game on internet
make cyoa-pdf : create the PDF file for printing the gamebook
make cyoa-epub : create the ePUB file to be displayed in a ebook reader or on a phone (android, iphone, ipad)
make cyoa-play : start the default browser and play the HTML file
make cyoa-cs (or make cyoa-choicescript): convert your game to the ChoiceScript format, into the new folder your_game_choicescript. Beware, this command will delete and recreate a previous folder with this name, so if you intend to modify the renpy code, move this folder elsewhere.
make cyoa-dialog : convert your game into Dialog format, into a new file your_game_export.dg (.dg is the dialog extension of course).
make cyoa-gamebook : convert your game into Gamebook LaTeX format (it's a work in progress, don't use it yet).
make cyoa-gbl : not used anymore. For converting the gbl format to textallion. (https://linuxfr.org/users/redo_fr/journaux/hs-ldveh-un-style-litt%C3%A9raire-qui-revient-%C3%A0-la-mode)
make cyoa-hyena : convert your game to the Hyena, format, under the name your_game_export.gamebook
make cyoa-inform5 : convert your game into an Inform 5 project (not tested anymore).
make cyoa-inform6 : convert your game into an Inform 6 project (not developped anymore).
make cyoa-inform7 : convert your game into an Inform 7 project, with a .i7 extension.
make cyoa-inkle : convert your game into Inkle format, into a new folder your_game_inkle.
make cyoa-ramus: Use Ramus as an alternative HTML rendering. The output game will get _ramus.html at the end.
make cyoa-ramus2: Use the new Ramus backend as an alternative HTML rendering. The output game will get _ramus2.html and _ramus2b.html at the end.
make cyoa-renpy : convert your game to the popular Renpy format, into a new folder your_game_renpy. Beware, this command will delete and recreate a previous folder with this name, so if you intend to modify the renpy code, move this folder elsewhere.
make cyoa-tavern : convert your game to the Tavern format. I'm not sure if this system is developped anymore.
make cyoa-togbl : convert to the gbl format (not used anymore).
make cyoa-twee (or make cyoa-twine) : convert your game to Twine, by using the twee intermediate format.
make cyoa-undum : convert your game into Undum format, into a new folder your_game_undum. Beware, this command will delete and recreate a previous folder with this name, so if you intend to modify the renpy code, move this folder elsewhere.
make cyoa-txt : export to simple txt
make cyoa-xetex : to latex using the xetex engine (for advanced pdf rendering)
make cyoa-zx : export to ZX Spectrum basic (in development)
More about the other formats:
make cyoa-renpy will completely destroy the original folder and replace it with a new one. So if you intend to add new elements in the code, you can either change the makefile accordingly, or move the folder elsewhere as indicated above.
To mean the end of a game, any occurrence of "THE END" will move the player to the end of the file, stopping the game.
The inclusion of images will be converted to the renpy format, and on each page, the background image will overlap the images already posted. To hide the images properly, although this is not an obligation, it is advisable to add $ hidemypic ("my_image.jpg") at the end of the paragraph after the use of a given image.