m. c. de marco: To invent new life and new civilizations...
I wrote version 1.0 of Scree, my gamebook template for Scrivener, for NaNoWriMo 2016. By default, when compiled in Scrivener (File > Compile), the template will generate a plain text file in “twee” format, a flat-file Markdown-like format for gamebooks that is also used by the graphical gamebook editor Twine. The “twee” file can be compiled into an HTML gamebook using Twee2 (a command-line Ruby gem).
You can also import an existing Twine or twee file into Scrivener, following the directions in the template. It will be separated into scenes for you.
Note that you should write purely in plain text or Markdown (including leaving blank lines in between paragraphs) when using the template; any rich text formatting will be ignored. For more help with the Markdown-like dialects of the different story formats, or with gamebook scripting, see the story format documentation in the Twine wiki.
For more information about Scree, read the instructions below or in the template itself.
You may also be interested in visualizing your story with DotGraph.
The current version is 1.0.1, which includes some missing support files for Scrivener for Windows.
Read the instructions (also included in the template).
Download the Scree template.
- Version 1.0: Accidentally only supported Scrivener 2.x for MacOSX.
The template comes pre-populated with a few scenes. Here is how they look after compiling in Scrivener, but before compiling with Twee2:
- The output from Scrivener using (default) compile option Twee2: test.txt
- The output using Twee: test-twee.txt
Here are various versions of the gamebook, using the Twine 2 story formats supported by Twee2:
- Using the default Twine 2 format (Harlowe): test.html
- Using Snowman: test-snowman.html
- Using SugarCube: test-sugarcube.html
- Using SugarCube2: test-sugarcube2.html
- Using PaperThin (a format for proofreading or word-counting): test-paperthin.html
- Using Paloma (a Jonah-like format for Twine 2): test-paloma.html
Note that PaperThin is still an HTML format; you can save it as text from a browser to get plain text, or just proofread and/or wordcount using the twee source file instead.
If you have an old twee story, the format you probably want to use with it is SugarCube. Otherwise, you may want to avoid SugarCube because it uses non-Markdown markup.
I shared a few implementation details in the blog and the Twine forum.