Repository files navigation

Spiner is a set of tools that allows you to easily author you own Choose Your Own Adventure books usingTwine 2. This set consists of an application, which transforms your published Twine story into an EPUB ebook.

The following features are currently supported:

Markdown

SimpleMarkdown 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.xhtml file 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.![alt](url)).

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!

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"

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 fileCOPYING.