comment: |
Some people like to be able to edit things in local text files.
Maybe you're a luddite, maybe you're going on a world tour via
submarine, or maybe you just work more efficiently in emacs or vi.
Regardless, Gameki has you covered. You can use Subersion to check
your game out as a bunch of YAML files. (Don't worry too much about
what YAML is, as we use a pretty simplified subset.)
To check out this Gameki, use the following command:
:##svn co '<>' '<>'##
You'll get a directory with a bunch of subdirectories. Two of these
are special: Object, which is the root of the element hierarchy, and
props, which defines all the props used in your Gameki. The rest
are convenience symlinks to somewhere further down the Object
hierarchy (or directories containing non-Gameki data).
Elements and props are defined in files with the suffix .yaml. They
look something like the following:
{{{
name: Wombat
color: "mauve"
body: |
Wombats are great, aren't they?
}}}
As you can see, this is basically just a mapping from prop name to
value. There are a couple of ways to specify the value in YAML:
plain, single or double quoted, or block, indicated by a single
##|## followed by an indented block. You can read the details of
our subset of YAML at [[YamlFormat]].
Note that some characters have special meaning in YAML, and as such
inline prop values starting with those characters need to be quoted.
Such characters include ##[##, ##{##, ##~###, ##?##, and ##*##.