Raconteur

Raconteur makes writing interactive hypertext fiction with Undum straightforward and perhaps even fun. It's a wrapper library that bundles oft-needed functionality and a new, cleaner, CoffeeScript-friendly, DSL-inspired API for defining Undum stories.

Agile, Adaptive, Modular, Open

Implemented Features • DSL-like syntax for defining situations. • A powerful situation prototype that bundles a lot of commonly-used functionality. • Shorthand for defining common hypertext interactions such as text replacement or insertion, similar to popular Twine extensions. • Most properties of situations can be either functions or strings, making it easy to turn a simple situation into a complex one. • An interface that is specifically designed to be used with ECMAScript 6 via Babel, or CoffeeScript. • Markdown, rather than raw HTML, as the format for most text content using markdown-it. • A tool bundle of iterators that makes it easy to define adaptive text snippets. • Based on CommonJS principles (Using undum-commonjs), allowing all game code to be bundled using Browserify. • An advanced game template that sets up a complete development environment for authors: A build system (gulp), CSS preprocessing (Less), and dependency management (Browserify + npm).

Why not use Undum? Raconteur is a library of Undum tools that can get someone writing their story quickly. It tries to push Undum in the direction of Inform and Twine, a system that puts the prose front and center.

Undum will never be quite as easy to use as Twine – Raconteur itself introduces some complications for the less technically-minded (It depends on Node.js, for one thing). But it’s an attempt at averaging out the power and flexibility of Undum with the ease of other systems. And for IF authors (or aspiring IF authors) who know a bit of web development, it’ll be a very familiar set of tools.

What it Does Raconteur’s heart is a new way of defining situations, Undum’s equivalent of Twine’s passages or ChoiceScript’s scenes. This new situation prototype is paired with a new API to allow writing Undum games in a style that resembles Twee/ChoiceScript more.

-https://sequitur.github.io/raconteur/2015/04/15/announcing-raconteur.html

Writing IF with Raconteur (tutorials 1-3): https://web.archive.org/web/20170313104835/http://segue.pw/2015/04/15/raconteur-tutorial-1/ https://web.archive.org/web/20170313052531/http://segue.pw/2015/04/16/raconteur-tutorial-2/ https://web.archive.org/web/20170313104844/http://segue.pw/2015/04/21/raconteur-tutorial-3/