Spiner is a set of tools that allows you to easily author you own Choose Your Own Adventure books using Twine 2. This set consists of an application, which transforms your published Twine story into an EPUB ebook.
The following features are currently supported:
- Markdown
- Simple Markdown syntax can be used to write and format your gamebook (EPUB only).
- Passage links
- Twine passage links (i.e.
[[displayed text|passage title]],[[passage title]]) are automatically converted to<a>links for EPUB. - Story Stylesheet
- Your story stylesheet as defined in Twine will be add to every
.xhtmlfile in your EPUB file. - Images
- Both local (images on your harddrive) as remote images (images on the internet) can simply be embedded in the EPUB by using standard markdown syntax(e.g.
). - Metadata
- Any EPUB metadata can be set from inside a normal Twine passage named 'metadata' using XML.
By far the easiest way to get started is to let the GUI to do the work for you. Just download the correct version for your operating system and follow the instructions on the screen!
| Operating System | Download |
|---|---|
| Windows | no download available yet |
| Mac OS | no download available yet |
| Linux | no download available yet |
| Other | no download available yet |
There is also a separate command-line version that works like this:
usage: java -jar spiner-0.1.2.jar [-f <format>] [-help | -version] [-i <input>] [-o <file>]
-f,--format <format> output format, currently only (epub)
-help display this help and exit
-i,--file <input> location of input HTML file
-o,--output <file> location of output file
-version output version information and exit
java -jar spiner-0.1.2.jar -f "epub" -i "My Cool Story.html" -o "My Cool Story.epub"
| Book | Link |
|---|---|
| Kolb and the Dragon | Twine to EPUB |
| Features | Twine to EPUB |
The following features are currently not implemented but are to be expected somewhere in the indefinite future, in roughly the following order:
- Annotation tag
- Passages tagged with `annotation` will not be included in the EPUB file.
- Unified markup
- It would be nice to be able to transform the same Twine story into both an EPUB and LaTeX file without having to fix up tiny details in either of them.
- Scripting? and other EPUB3 features
- I currently do not own an eReader that supports EPUB3 features. But support for EPUB3 features, especially scripting could prove interesting.
See the file COPYING.