2015-04-13 12:32:17 +03:00
|
|
|
---
|
|
|
|
layout: noheader
|
|
|
|
---
|
|
|
|
|
|
|
|
<div class="section top bright">
|
|
|
|
<div class="container">
|
|
|
|
<div class="row">
|
2015-04-15 06:54:29 +03:00
|
|
|
<div class="three columns">
|
2015-04-13 12:32:17 +03:00
|
|
|
<h5><a href="news.html">News</a></h5>
|
|
|
|
</div>
|
2015-04-15 06:54:29 +03:00
|
|
|
<div class="three columns">
|
2015-04-13 12:32:17 +03:00
|
|
|
<h5><a href="http://github.com/sequitur/raconteur">View Raconteur on Github</a></h5>
|
|
|
|
</div>
|
2015-04-15 06:54:29 +03:00
|
|
|
<div class="three columns">
|
2015-04-13 12:32:17 +03:00
|
|
|
<h5><a href="http://github.com/sequitur/raconteur-scaffold">Get the scaffold</a></h5>
|
|
|
|
</div>
|
2015-04-15 06:54:29 +03:00
|
|
|
<div class="three columns">
|
|
|
|
<h5><a href="http://raconteur.readthedocs.org/">Read the documentation</a></h5>
|
|
|
|
</div>
|
2015-04-13 12:32:17 +03:00
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="section">
|
|
|
|
<div class="container">
|
|
|
|
<div class="row">
|
|
|
|
<div class="six columns intro">
|
2015-04-15 06:54:29 +03:00
|
|
|
<h1>
|
|
|
|
Raconteur is <a href="http://undum.com">Undum</a> with batteries
|
|
|
|
included.
|
|
|
|
</h1>
|
2015-04-13 12:32:17 +03:00
|
|
|
<p>
|
|
|
|
Undum is perhaps the most versatile system for writing hypertext
|
|
|
|
interactive fiction. Unfortunately, it's also the hardest to use.
|
|
|
|
Raconteur aims to change that. It's designed so that you only need
|
|
|
|
to care about the complexity that you're going to use, when you're
|
|
|
|
going to use it.
|
|
|
|
</p>
|
|
|
|
</div>
|
2015-04-15 06:54:29 +03:00
|
|
|
<div class="six columns">
|
|
|
|
<img alt="a storyteller" src="img/storyteller.jpg">
|
|
|
|
|
2015-04-13 12:32:17 +03:00
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
<div class="row">
|
|
|
|
<div class="six columns intro">
|
2015-04-15 06:54:29 +03:00
|
|
|
<h2>Agile</h2>
|
2015-04-13 12:32:17 +03:00
|
|
|
<p>
|
2015-04-15 06:54:29 +03:00
|
|
|
The Raconteur <a href="https://github.com/sequitur/raconteur-scaffold">scaffold</a>
|
|
|
|
comes with (most) everything you need to get started,
|
2015-04-13 12:32:17 +03:00
|
|
|
configured out of the box to use a build system, CSS preprocessor, and
|
2015-04-13 23:50:46 +03:00
|
|
|
bundler. Armed with a text editor (We like
|
|
|
|
<a href="http://sublimetext.com">Sublime</a>), you can start writing
|
|
|
|
your story and prose, rather than support code.
|
2015-04-13 12:32:17 +03:00
|
|
|
</p>
|
2015-04-13 23:50:46 +03:00
|
|
|
<p>
|
|
|
|
The scaffold is set up to automate as much work as possible. You can
|
|
|
|
make stylesheet changes and watch them load immediately on a browser.
|
2015-04-15 06:54:29 +03:00
|
|
|
You change your game and it bundles it again, refreshing the page.
|
|
|
|
It even automates packaging your game and its assets into a .zip file you
|
2015-04-13 23:50:46 +03:00
|
|
|
can upload to <a href="http://itch.io">Itch.io</a>.
|
|
|
|
</p>
|
2015-04-13 12:32:17 +03:00
|
|
|
</div>
|
|
|
|
<div class="six columns intro">
|
2015-04-15 06:54:29 +03:00
|
|
|
<h2>Adaptive</h2>
|
2015-04-13 12:32:17 +03:00
|
|
|
<p>
|
|
|
|
Raconteur is built with adaptive text generation in mind. Defining
|
|
|
|
snippets of text that vary whenever the player sees them is easy.
|
2015-04-15 06:54:29 +03:00
|
|
|
Raconteur takes inspiration from Inform 7, commonly used Twine macros,
|
|
|
|
and other popular IF development systems. Text that varies across
|
|
|
|
printings, hypertexts that modify or insert text, and other common
|
|
|
|
functionality is already there to use.
|
2015-04-13 12:32:17 +03:00
|
|
|
</p>
|
|
|
|
<p>As much as possible, it treats code that produces text and
|
|
|
|
text interchangeably. Raconteur lets you rewrite passages to include
|
|
|
|
dynamic text very easily, so that you can spend more time rewriting
|
|
|
|
your prose and less time refactoring your code.
|
|
|
|
</p>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="row">
|
|
|
|
<div class="six columns codeexample">
|
|
|
|
{% highlight coffeescript %}
|
2015-04-15 06:54:29 +03:00
|
|
|
situation 'west_of_house',
|
|
|
|
content: """
|
|
|
|
You are standing in an open field west of a
|
|
|
|
white house, with a boarded up front door.
|
|
|
|
"""
|
|
|
|
choices: ['forest', 'inside_house']
|
|
|
|
|
|
|
|
situation 'reflecting_pool',
|
2015-04-13 23:50:46 +03:00
|
|
|
content: (character, system) -> """
|
|
|
|
Looking into the pool, you find yourself feeling
|
|
|
|
#{character.sandbox.mood}. It glows with a
|
|
|
|
strange #{this.color} light.
|
|
|
|
""",
|
|
|
|
color: oneOf('blue', 'red', 'green').randomly()
|
2015-04-13 12:32:17 +03:00
|
|
|
{% endhighlight %}
|
|
|
|
</div>
|
|
|
|
<div class="six columns intro">
|
|
|
|
<h2>Modular</h2>
|
|
|
|
<p>
|
|
|
|
Raconteur is made out of modules, each implementing its own set of
|
|
|
|
functionality. You only need to use the ones you want.
|
|
|
|
</p>
|
2015-04-15 06:54:29 +03:00
|
|
|
<h2>Open</h2>
|
|
|
|
<p>
|
|
|
|
Raconteur, Undum, its dependencies (JQuery and markdown-it) are all
|
|
|
|
open source software. Raconteur games are static web pages that can
|
|
|
|
be hosted anywhere or even run locally. You can build your game and
|
|
|
|
share it (or not share it) however you like, wherever you like,
|
|
|
|
rather than being tied to a particular engine, service, or server.
|
|
|
|
</p>
|
2015-04-13 12:32:17 +03:00
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="section bright">
|
|
|
|
<div class="container">
|
|
|
|
<div class="row">
|
|
|
|
<div class="twelve columns">
|
|
|
|
<h2>Programmer-friendly</h2>
|
|
|
|
<p>
|
|
|
|
Raconteur is built using standard web development tools, instead of a
|
|
|
|
specialist toolchain. It's familiar for people who know front-end web
|
|
|
|
development; and those who don't will still benefit from working
|
|
|
|
with a robust, proven toolchain.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
<div class="row">
|
|
|
|
<div class="four columns">
|
|
|
|
<h3>npm</h3>
|
|
|
|
<p>
|
|
|
|
The Node package manager makes it easy to install Raconteur and its
|
|
|
|
dependencies.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
<div class="four columns">
|
|
|
|
<h3>Gulp</h3>
|
|
|
|
<p>
|
|
|
|
Raconteur is designed to be used with a powerful build system that
|
|
|
|
automates bundling your game and lets you see changes as you make
|
|
|
|
them right on the browser.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
<div class="four columns">
|
|
|
|
<h3>Browserify</h3>
|
|
|
|
<p>
|
|
|
|
Raconteur is made up of independent modules – Browserify bundles
|
|
|
|
all of those modules, along with your game, into a single file, while
|
|
|
|
keeping the code separate and modular. You can treat Raconteur as a
|
|
|
|
true library, the guts of which you never have to look into.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
</div>
|